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

प्रोजेक्ट आर्काइव इंपोर्ट करें, कोई दस्तावेज़ बदलें, arXiv सोर्स बंडल लाएँ, GitHub रिपॉज़िटरी कॉपी करें, या LaTeX प्रोजेक्ट को Typst प्रोजेक्ट में बदलें।

**New project → Import a project** चुनें, या लाइब्रेरी में **Import** इस्तेमाल करें। Oleafly एक नया लोकल प्रोजेक्ट बनाता है और मूल फ़ाइल या रिपॉज़िटरी को जैसी है वैसी रहने देता है। जब तक इंपोर्ट अपनी खुद की Git रिपॉज़िटरी न लाए, इंपोर्ट की गई फ़ाइलें प्रोजेक्ट का [पहला Git कमिट](/docs/new-project/#the-first-git-commit) बन जाती हैं, जिसका नाम **Create project** है।

![मौजूदा काम से शुरू करने के लिए नए प्रोजेक्ट डायलॉग में Import project चुनें।](https://cdn.oleafly.com/images/screenshots/desktop/docs/new-project-dark-window-v2.png)

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

| आपके पास क्या है | इंपोर्ट का रास्ता | आप कौन सा प्रोजेक्ट बना सकते हैं |
| --- | --- | --- |
| पूरा प्रोजेक्ट फ़ोल्डर | **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 फ़ाइल को उसके मूल फ़ॉर्मैट में रखने के लिए उस फ़ॉर्मैट का खाली प्रोजेक्ट शुरू करें और सोर्स फ़ाइल को [फ़ाइल ट्री](/docs/files/#adding-existing-files) से जोड़ें।

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

जब आपके पास पहले से काम करने वाला सोर्स ट्री हो, तब 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 नहीं संभाल सकता, तो इंजन डायलॉग खुल जाता है ताकि आप दूसरा चुन सकें। [नए प्रोजेक्ट के लिए डिफ़ॉल्ट तय करें](/docs/engines/#set-a-default-for-new-projects) और [जब Tectonic काफ़ी न हो](/docs/latex-engines/#when-tectonic-isnt-enough) देखें।

## 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](/docs/tools/arxiv-to-latex/) इस्तेमाल करें, और जब पेपर को Typst में बदलवाना चाहें, तब [arXiv to Typst](/docs/tools/arxiv-to-typst/)। arXiv पहचानकर्ता के लिए नेटवर्क कनेक्शन चाहिए; डिस्क पर पहले से मौजूद सोर्स आर्काइव के लिए नहीं।

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

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

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

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

## 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 प्रोजेक्ट](/docs/typst/#convert-a-latex-project-to-typst) रूपांतरण और रिपोर्ट को विस्तार से समझाता है।

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

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

- [PDF to LaTeX](/docs/tools/pdf-to-latex/), LaTeX प्रोजेक्ट या सोर्स आर्काइव के लिए
- [PDF to Markdown](/docs/tools/pdf-to-markdown/), संपादन योग्य Markdown के लिए
- [PDF to Typst](/docs/tools/pdf-to-typst/), संपादन योग्य Typst के लिए

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

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

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

BibTeX, RIS, EndNote XML या Zotero RDF को [संदर्भ और उद्धरण](/docs/citations/#import-a-whole-reference-library) से इंपोर्ट करें। पेपर या डेटा के किसी फ़ोल्डर को [केवल-पढ़ने योग्य शोध संदर्भ](/docs/linked-folders/) के रूप में लिंक करें, जब उसे प्रोजेक्ट के बाहर रहना हो।