शोध-पत्र को GitHub पर रखें
init, aux फ़ाइलों की अनदेखी, निजी रिपॉज़िटरी, और वे आदतें जो सह-लेखकों के मर्ज को सुलझा हुआ रखें।
शोध-पत्र को GitHub पर रखें
LaTeX पांडुलिपि सादा टेक्स्ट है, जो उसे Git के लिए आदर्श बनाता है। हर मसौदा एक कमिट बन जाता है जिस पर आप लौट सकते हैं, हर बदलाव पंक्ति-स्तर के डिफ़ के रूप में दिखता है, और GitHub आपको बाहर की एक प्रति देता है और सह-लेखकों को मौजूदा स्थिति खींचने का रास्ता भी। इनमें से किसी के लिए उन्नत Git नहीं चाहिए। एक शोध-पत्र को शायद पाँच कमांड चाहिए, जो लगातार इस्तेमाल हों।
शुरुआती सेटअप
git init# add a .gitignore for *.aux *.log *.out *.toc *.synctex.gzgit add main.tex refs.bib figures/git commit -m "Initial manuscript"gh repo create my-paper --private --source=. --pushइसे प्रोजेक्ट फ़ोल्डर में एक बार चलाएँ। .gitignore वाला चरण दिखने से ज़्यादा मायने रखता है। हर कंपाइल .aux, .log, .out, .toc और .synctex.gz फ़ाइलें दोबारा बनाता है, और उन्हें कमिट करने से आपके असली बदलाव मशीनी शोर के नीचे दब जाते हैं और सह-लेखकों के बीच बेकार के मर्ज टकराव पैदा होते हैं। सिर्फ़ वही ट्रैक करें जो आप खुद लिखते हैं: .tex स्रोत, .bib डेटाबेस, आकृतियाँ, और प्रकाशन मंच की दी हुई कोई भी क्लास या शैली फ़ाइलें। PDF भी बिल्ड का उत्पाद है। ज़्यादातर टीमें उसे छोड़ देती हैं और अपने कंप्यूटर पर दोबारा बना लेती हैं, हालाँकि टैग किए गए रिलीज़ के साथ एक संलग्न कर देना सबमिट किए गए संस्करण को ज्यों का त्यों सुरक्षित रखने का उचित तरीक़ा है। रिपॉज़िटरी को तब तक निजी रखें जब तक काम सार्वजनिक न हो जाए। अप्रकाशित पांडुलिपि इंडेक्स होने लायक चीज़ नहीं है।
वे आदतें जो सह-लेखकों को चैन से रखें
हर कमिट को एक तार्किक बदलाव रखें, जैसे “खंड 3 की भूमिका संशोधित करें” या “एब्लेशन तालिका जोड़ें”। तब इतिहास शोध-पत्र की कहानी की तरह पढ़ा जाता है, और किसी ख़राब संपादन को बिना अनचाहे नुक़सान के वापस लिया जा सकता है। लिखने का सत्र शुरू करने से पहले pull करें और रुकते समय push करें। मर्ज टकराव उतने ही बढ़ते हैं जितना समय ब्रांच एक-दूसरे से अलग रहती हैं। जब सह-लेखक किसी साझा ब्रांच को खींच चुके हों, तो उस पर कभी force-push न करें: यह उनके पैरों तले इतिहास को दोबारा लिख देता है। बड़ी बाइनरी चीज़ें (डेटासेट, वीडियो) शोध-पत्र की रिपॉज़िटरी से बाहर रखें। किसी आर्काइव का लिंक दें या अलग डेटा रिपॉज़िटरी इस्तेमाल करें। Git हर बाइनरी का हर संस्करण हमेशा के लिए सहेजता है।
LaTeX की अपनी एक आदत: स्रोत की हर पंक्ति में एक वाक्य लिखने से डिफ़ नाटकीय रूप से ज़्यादा पठनीय हो जाते हैं, क्योंकि एक शब्द का संपादन दोबारा बहे हुए अनुच्छेद की जगह एक पंक्ति के बदलाव के रूप में दिखता है।
Oleafly इसमें कहाँ फिट होता है
हर Oleafly प्रोजेक्ट डिस्क पर एक साधारण फ़ोल्डर है, इसलिए ये कमांड उस पर बिना बदलाव चलते हैं। Oleafly बदले हुए स्रोत वाले पात्र सफल बिल्ड को Git से अलग Saved Checkpoints में रखता है। Source Control में सोच-समझकर कमिट करें, फिर अपने सहयोगियों के साथ push या pull करें। देखें Git इतिहास। इसके ऊपर बने सहयोग के तरीक़ों के लिए, जिनमें पैच का आदान-प्रदान और अध्यायों का स्वामित्व शामिल हैं, लाइव कर्सर के बिना सह-लेखन देखें।