हम विंडोज के तहत प्रलेखन ProGit इकट्ठा करते हैं

प्रस्तावना

शुभ दोपहर

अब लगभग छह महीने के लिए, हमारी कंपनी SVN संस्करण नियंत्रण प्रणाली से Git में बदल गई है। मैं फायदे या नुकसान के बारे में नहीं लिखूंगा, उनकी चर्चा एक से अधिक बार की गई है। हमारी टीम में जिन लोगों ने ऐसा किया, उन्होंने मुख्य परिदृश्यों के साथ कई आंतरिक लेख लिखे: ब्रंच बनाना, मर्ज करना, आदि।
लेकिन जीवन अपने आश्चर्य को लाता है और मुख्य परिदृश्यों से परे जाना हमेशा डब्ल्यूटीएफ या रूसी में वाक्यांश द्वारा इंगित किया गया है, "मुझे लगा कि गिट यह करेंगे, यह अलग तरीके से क्यों किया?"

और यह सब इस तथ्य पर उतर आया कि आपको गीता पर प्रलेखन पढ़ने की आवश्यकता है। (और प्रलेखन पढ़ने के लिए, हमेशा कोई समय नहीं होता है।)
इस अवसर पर, एक लेख था हब पर "प्रो गिट" पुस्तक का अनुवाद पूरा हो गया था।
लेकिन जैसा कि यह निकला, प्रलेखन अभी भी संशोधित किया जा रहा है। अक्सर नहीं, लेकिन फिर भी, यह स्पष्ट रूप से दिखाई देता है जब बाद में पेश किया गया था।

और विचार को डॉक के अंतिम संस्करण को ढालना आया ...

गिट + पंडोक + विंडोज

ऐसा करने के लिए, हमें Git एक्सटेंशन को स्थापित करने की आवश्यकता है, कमांड मेनू से क्लोन रिपोजिटरी का चयन करें । रिपोजिटरी लिंक की ओर इशारा करते हुए 'https://github.com/progit/progit.git'


और क्लोन पर क्लिक करें।
PS डॉक डाउनलोड करने के लिए, अनाम एक्सेस का उपयोग किया जाता है, इसलिए किसी भी कुंजी की आवश्यकता नहीं होगी।

लेकिन फिर एक आश्चर्य मुझे इंतजार कर रहा था, दस्तावेज़ीकरण एक अज्ञात मार्कडाउन प्रारूप में निकला, और ईबुक के लिए एक विकल्प बनाने के लिए, ऐसा करने का प्रस्ताव था:

ईबुक बनाना
फेडोरा पर आप कुछ इस तरह से दौड़ सकते हैं:

$ yum install ruby calibre rubygems ruby-devel rubygem-ruby-debug $ gem install rdiscount $ makeebooks en # will produce a mobi 

लिनक्स वर्चुअल मशीन को स्थापित करने की संभावना, सिर्फ प्रलेखन इकट्ठा करने के लिए, प्रसन्न नहीं थी। शायद दूसरे उपाय भी हैं, तो बस मेरी बाइक।
हे महान इंटरनेट! वहाँ से, मैं पंडोक उपयोगिता खोजने में कामयाब रहा, जो मार्कडाउन प्रारूप फ़ाइलों को डॉकएक्स , पीडीएफ, टीएक्सटी आदि में बदल सकता है।
फीचर्स और सिंटैक्स यहां देखे जा सकते हैं ।
डाउनलोड, इंस्टॉल करें, फ़ोल्डर में जाएं E: \ source.git \! \ Progit \ ru
यदि आप देखते हैं, तो परिवर्तित करने के लिए सिंटैक्स सरल है

 pandoc -S 01-introduction\01-chapter1.markdown -o gitbook.docx 

बारीकियों से:

1. पीढ़ी के दौरान कई फ़ाइलों को चुनना आवश्यक था।
2. चित्रों के लिंक प्रारूप में इंगित किए गए थे

     Insert 18333fig0101.png  1-1.   . 

   , लेकिन यह आवश्यक है

    ![  1-1.   .](..\figures\18333fig0101-tn.png) 

इसलिए, मैं इस प्रक्रिया को स्वचालित करना चाहता था और वीबीएसस्क्रिप्ट लिखा गया था (मैं इस भाषा का गुरु नहीं हूं, मुझे बस अपनी समस्या को हल करने की आवश्यकता है)। वीबीएस इतना जटिल नहीं है और इसे हल करने के लिए पर्याप्त था।

1. यह मार्कडाउन एक्सटेंशन के साथ एक फ़ोल्डर में सभी फाइलों को खोजकर हल किया गया है।
2. RegExp का उपयोग करके हल किया गया।
यह स्क्रिप्ट निकलेगी:

 Const ForReading = 1 Const ForWriting = 2 Const ForAppending = 8 Set objFSO = CreateObject("Scripting.FileSystemObject") Set objRegEx = CreateObject("VBScript.RegExp") Dim sCurPath, tempFolder, files sCurPath = objFSO.GetAbsolutePathName(".") tempFolder = sCurPath + "\!" if objFSO.FolderExists(tempFolder) then objFSO.DeleteFolder(tempFolder) end if objFSO.CreateFolder(tempFolder) CopyFiles sCurPath, tempFolder Dim cmd cmd = "pandoc -S " + files + " -o gitbook.docx" with createobject("wscript.shell") .Run(cmd), 0, True end with WScript.Echo("Completed") Function CopyFiles(CurrentFolderName, TempFolderName) On Error Resume Next Dim ObjFolder Dim ObjSubFolders Dim ObjSubFolder Dim ObjFiles Dim ObjFile Set ObjFolder = objFSO.GetFolder(CurrentFolderName) Set ObjFiles = ObjFolder.Files For Each ObjFile In ObjFiles IF objFSO.GetExtensionName(ObjFile.name) = "markdown" Then Set openedFile = objFSO.OpenTextFile(ObjFile.Path, ForReading) Set outputfile = objFSO.CreateTextFile(TempFolderName + "\" + ObjFile.name, True) files = files + "!\" + ObjFile.name + " " objRegEx.IgnoreCase = True objRegEx.MultiLine = True objRegEx.Global = True objRegEx.Pattern = "Insert (.*).png\n*\s*(.*)$" text = openedFile.ReadAll openedFile.Close result = objRegEx.Replace(text, "![$2](../figures/$1-tn.png)") outputfile.Write result outputfile.Close End If Next 'Getting all subfolders Set ObjSubFolders = ObjFolder.SubFolders For Each ObjFolder In ObjSubFolders 'Getting all Files from subfolder CopyFiles ObjFolder.Path, TempFolderName Next End Function 

फ़ोल्डर से स्क्रिप्ट को चलाएं E: \ source.git \! \ Progit \ ru , हमें gitbook.docx मिलता है।

निष्कर्ष

1. जहां से स्क्रिप्ट को चलाना है, वह स्थान महत्वपूर्ण है, क्योंकि चित्रों का मार्ग ध्यान में रखा गया है।
2. पीडीएफ बनाने के लिए आपको लेटेक्स की आवश्यकता है, इसलिए मैंने इसे आज़माया नहीं है।
3. यदि फ़ाइल एक अलग प्रारूप में आवश्यक है, तो आप पहले से ही उपयोगिताओं को docx को pdf, fb2, आदि में परिवर्तित करने के लिए उपयोग कर सकते हैं।
4. मैंने उस तरह के दस्तावेज़ को पढ़ना शुरू नहीं किया, लेकिन यह एक कदम करीब है :)।

लिंक

डॉक डाउनलोड करें