मौजूदा काम को Oleafly में लाएँ

New project → Import a project चुनें, या लाइब्रेरी में Import इस्तेमाल करें। Oleafly एक नया लोकल प्रोजेक्ट बनाता है और मूल फ़ाइल या रिपॉज़िटरी को जैसी है वैसी रहने देता है। जब तक इंपोर्ट अपनी खुद की Git रिपॉज़िटरी न लाए, इंपोर्ट की गई फ़ाइलें प्रोजेक्ट का पहला Git कमिट बन जाती हैं, जिसका नाम Create project है।

मौजूदा काम से शुरू करने के लिए नए प्रोजेक्ट डायलॉग में Import project चुनें। पूरा स्क्रीनशॉट खोलें

वह रास्ता चुनें जो आपके सोर्स से मेल खाता हो

आपके पास क्या है	इंपोर्ट का रास्ता	आप कौन सा प्रोजेक्ट बना सकते हैं
पूरा प्रोजेक्ट फ़ोल्डर	Existing project (.zip)	आर्काइव किया गया सोर्स, फ़िगर, ग्रंथसूची और लोकल स्टाइल फ़ाइलें
Word दस्तावेज़	Word document (.docx)	LaTeX, Markdown या Typst
Markdown दस्तावेज़	Markdown document (.md, .markdown)	LaTeX या Typst
HTML दस्तावेज़	HTML page (.html, .htm)	LaTeX, Markdown या Typst
Typst दस्तावेज़	Typst document (.typ)	LaTeX या Markdown
arXiv पेपर	ID या URL के साथ arXiv paper	पेपर का LaTeX सोर्स बंडल
GitHub रिपॉज़िटरी	GitHub	रिपॉज़िटरी से जुड़ा लोकल प्रोजेक्ट
संपादन योग्य सोर्स के बिना PDF	Oleafly Tools → PDF converters	आपके चुने टूल के अनुसार, दोबारा बनाया गया LaTeX, Markdown या Typst
Oleafly में पहले से मौजूद LaTeX प्रोजेक्ट	कमांड पैलेट में Convert to a Typst project	एक नया Typst प्रोजेक्ट, LaTeX प्रोजेक्ट जैसा था वैसा ही रहता है

वही लेखन फ़ॉर्मैट तभी चुनें जब Oleafly उसे दे। किसी Markdown या Typst फ़ाइल को उसके मूल फ़ॉर्मैट में रखने के लिए उस फ़ॉर्मैट का खाली प्रोजेक्ट शुरू करें और सोर्स फ़ाइल को फ़ाइल ट्री से जोड़ें।

पूरा प्रोजेक्ट आर्काइव इंपोर्ट करें

जब आपके पास पहले से काम करने वाला सोर्स ट्री हो, तब ZIP इस्तेमाल करें।

1. मुख्य दस्तावेज़, फ़िगर, ग्रंथसूची और लोकल क्लास या स्टाइल फ़ाइलें एक फ़ोल्डर में रखें। सोर्स में इस्तेमाल हुए रिलेटिव पाथ जैसे हैं वैसे ही रखें।
2. फ़ोल्डर को .zip फ़ाइल के रूप में कंप्रेस करें।
3. Import → Existing project चुनें और ZIP चुनें।
4. इंपोर्ट की गई फ़ाइल ट्री में तारे वाला मुख्य दस्तावेज़ जाँचें।
5. कंपाइल करें। अगर प्रोजेक्ट को कोई दूसरा LaTeX टूलचेन चाहिए, तो उसे कंपाइलर मेन्यू से चुनें।

उदाहरण के लिए, main.tex, references.bib, sections/method.tex और figures/plot.pdf को साथ रखें। सोर्स ZIP उन संबंधों को बनाए रखती है। PDF में वैसी संपादन योग्य प्रोजेक्ट संरचना नहीं होती।

अगर आर्काइव में एक से ज़्यादा संभावित मुख्य दस्तावेज़ हों, तो कंपाइल करने से पहले फ़ाइल मेन्यू से सही वाले की पुष्टि करें।

इंपोर्ट कौन सा LaTeX कंपाइलर इस्तेमाल करता है

इंपोर्ट किया या बदला हुआ LaTeX प्रोजेक्ट Settings → Engines → LaTeX के डिफ़ॉल्ट कंपाइल इंजन पर शुरू होता है, जो Tectonic है जब तक आपने उसे बदला न हो। जब वह डिफ़ॉल्ट latexmk हो और प्रोजेक्ट pdfLaTeX, XeLaTeX या LuaLaTeX का नाम ले, तो वह वही कंपाइलर रखता है। अगर इंपोर्ट में ऐसी सुविधाएँ मिलती हैं जिन्हें Tectonic नहीं संभाल सकता, तो इंजन डायलॉग खुल जाता है ताकि आप दूसरा चुन सकें। नए प्रोजेक्ट के लिए डिफ़ॉल्ट तय करें और जब Tectonic काफ़ी न हो देखें।

Word, Markdown, HTML या Typst बदलें

1. Import में मेल खाता दस्तावेज़ प्रकार चुनें।
2. फ़ाइल चुनें।
3. अगर Oleafly एक से ज़्यादा गंतव्य देता है, तो वह फ़ॉर्मैट चुनें जिसमें आप आगे संपादन करना चाहते हैं। LaTeX को अनुशंसित रास्ते के रूप में चिह्नित किया गया है।
4. अगर कहा जाए तो Pandoc सेटअप पूरा करें। Oleafly किसी संगत इंस्टॉलेशन का उपयोग कर सकता है या अपना प्रबंधित संस्करण डाउनलोड कर सकता है।
5. नया प्रोजेक्ट खोलें, उसे कंपाइल करें और मूल से उसकी तुलना करें।

रूपांतरण Pandoc से लोकल रूप में चलते हैं। Word या HTML इंपोर्ट एम्बेडेड मीडिया को भी प्रोजेक्ट में निकाल लेता है ताकि बदला हुआ सोर्स उसका उल्लेख कर सके। LaTeX प्रोजेक्ट में इंपोर्ट किया गया Markdown दस्तावेज़ अपने उद्धरण बनाए रखता है: [@key] \citep या \citet बन जाता है, और ग्रंथसूची फ़ाइल साथ आ जाती है, इसलिए References पैनल में शुरू से ही आपके सोर्स होते हैं।

आगे के काम के लिए गंतव्य चुनें:

• LaTeX जर्नल टेम्पलेट, बारीक टाइपसेटिंग और टैग्ड-PDF वर्कफ़्लो के लिए ठीक है।
• Markdown हल्के सोर्स फ़ॉर्मैट और व्यापक दस्तावेज़ रूपांतरण के लिए ठीक है।
• Typst तेज़ कंपाइलेशन और Typst-नेटिव टेम्पलेट के लिए ठीक है।

जहाँ सोर्स फ़ॉर्मैट दस्तावेज़ की संरचना उजागर करता है, वहाँ रूपांतरण उसे बनाए रखता है। Word के विशिष्ट पेज लेआउट, कस्टम HTML स्टाइलिंग, हाथ से ठीक की गई तालिकाओं, उद्धरणों और जटिल समीकरणों को अब भी सफ़ाई के एक दौर की ज़रूरत पड़ सकती है। मूल को मिटाने से पहले शीर्षक, सूचियाँ, तालिकाएँ, समीकरण, लिंक, उद्धरण और इमेज की जगह की तुलना करें।

arXiv सोर्स बंडल इंपोर्ट करें

arXiv paper चुनें, फिर 2401.01234 जैसा पहचानकर्ता या arxiv.org/abs/... URL पेस्ट करें। Oleafly जमा किया गया सोर्स बंडल डाउनलोड करता है और उसे LaTeX प्रोजेक्ट के रूप में खोलता है।

यह रास्ता तब इस्तेमाल करें जब आपको लेखकों का संपादन योग्य सोर्स चाहिए। जब आप इंपोर्ट डायलॉग से शुरू किए बिना सोर्स आर्काइव देखना या सहेजना चाहें, तब arXiv to LaTeX इस्तेमाल करें, और जब पेपर को Typst में बदलवाना चाहें, तब arXiv to Typst। arXiv पहचानकर्ता के लिए नेटवर्क कनेक्शन चाहिए; डिस्क पर पहले से मौजूद सोर्स आर्काइव के लिए नहीं।

सोर्स या फ़िगर दोबारा इस्तेमाल करने से पहले हमेशा लाइसेंस और लेखकों की शर्तें जाँच लें।

GitHub से इंपोर्ट करें

इंपोर्ट डायलॉग में GitHub चुनें। ज़रूरत हो तो Settings → Integrations → GitHub से अपना खाता जोड़ें, फिर कोई ऐसी रिपॉज़िटरी चुनें जिस तक आपकी पहुँच हो।

Oleafly लाइब्रेरी में एक लोकल कॉपी बनाता है। संपादन से पहले उसका मुख्य दस्तावेज़ जाँचें और एक बार कंपाइल चलाएँ। GitHub सिंक बताता है कि इंपोर्ट के बाद बदलाव कैसे पुल, कमिट और प्रकाशित करें।

LaTeX प्रोजेक्ट को Typst में बदलें

Oleafly आपके पास पहले से मौजूद LaTeX प्रोजेक्ट की Typst कॉपी बना सकता है। LaTeX प्रोजेक्ट बदला नहीं जाता।

1. LaTeX प्रोजेक्ट खोलें।
2. ⌘K (Ctrl+K) कमांड पैलेट खोलें और Convert to a Typst project चलाएँ।
3. New project name जाँचें। डिफ़ॉल्ट रूप से यह प्रोजेक्ट का नाम होता है, जिसके बाद (Typst) आता है।
4. Convert चुनें। Oleafly प्रोजेक्ट को Pandoc से बदलता है, Typst प्रोजेक्ट बनाता है और जाँच के तौर पर उसे एक बार कंपाइल करता है।
5. रिपोर्ट पढ़ें, फिर Open the Typst project चुनें।

रिपोर्ट बताती है कि नया प्रोजेक्ट कंपाइल होता है या नहीं, क्या-क्या बदला गया इसकी गिनती देती है, और वह सूची देती है जिसे हाथ से ठीक करना है, हर कंपाइल त्रुटि के लिंक के साथ। Typst प्रोजेक्ट रूपांतरण और रिपोर्ट को विस्तार से समझाता है।

PDF का पुनर्निर्माण करें

Settings → Experimentation में LaTeX tools चालू करें, फिर वह टूल चुनें जो आपके चाहे आउटपुट से मेल खाता हो:

• PDF to LaTeX, LaTeX प्रोजेक्ट या सोर्स आर्काइव के लिए
• PDF to Markdown, संपादन योग्य Markdown के लिए
• PDF to Typst, संपादन योग्य Typst के लिए

लोकल PDF पाइपलाइन टेक्स्ट लेयर पढ़ती है, पढ़ने का क्रम बहाल करती है और फ़िगर निकालती है। PDF to LaTeX में, जब PDF पेज की इमेज से बनी हो, तो स्कैन किए गए दस्तावेज़ वाले मोड पर जाएँ। वह रास्ता Tools के लिए मॉडल का उपयोग करता है, जो कोई दूसरा न चुनने तक एक लोकल Ollama मॉडल होता है, और 50 पेज तक के दस्तावेज़ों को समर्थन देता है।

नतीजे की PDF से पेज दर पेज तुलना करें। कॉलम, समीकरण, तालिकाएँ, फ़ुटनोट और पढ़ने का क्रम पुनर्निर्माण की समस्याएँ हैं, इसलिए किसी भी PDF रूपांतरण को मूल सोर्स नहीं मानना चाहिए।

बिना मैनुस्क्रिप्ट इंपोर्ट किए संदर्भ जोड़ें

BibTeX, RIS, EndNote XML या Zotero RDF को संदर्भ और उद्धरण से इंपोर्ट करें। पेपर या डेटा के किसी फ़ोल्डर को केवल-पढ़ने योग्य शोध संदर्भ के रूप में लिंक करें, जब उसे प्रोजेक्ट के बाहर रहना हो।