# प्रोजेक्ट का निर्यात और रूपांतरण

नवीनतम PDF सहेजें, संपादन योग्य स्रोत पैकेज करें, पेज छवियाँ या HTML निर्यात करें, Typst से PDF/A और PDF/UA लिखें, या किसी LaTeX, Typst या Markdown दस्तावेज़ को रूपांतरित करें।

प्रोजेक्ट टूलबार में **Export** खोलें। मेनू मौजूदा दस्तावेज़ इंजन और प्रकार के अनुसार चलता है, इसलिए यह केवल वे मार्ग दिखाता है जिन्हें Oleafly उस प्रोजेक्ट के लिए चला सकता है।

![Export टॉप प्रोजेक्ट बार में Recompile के ठीक बाद आने वाला डाउनलोड नियंत्रण है।](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-writing-dark-window-v2.png#view=1282,0,232,48)

## अपने प्राप्तकर्ता की ज़रूरत का आउटपुट चुनें

- **PDF** पढ़ने, छापने और अधिकांश सबमिशन पोर्टल के लिए है।
- **Source ZIP** सह-लेखकों या उन प्रणालियों के लिए है जिन्हें पांडुलिपि, आकृतियाँ, ग्रंथ-सूची और स्थानीय शैलियाँ चाहिए।
- **Page PNG** स्लाइड, संदेश या उस समीक्षा प्रणाली के लिए है जो छवि अपेक्षित करती है।
- **Typst द्वारा लिखे गए PNG, SVG या HTML** उन Typst प्रोजेक्ट के लिए हैं जिन्हें हर पेज छवि, वेक्टर पेज या वेब पेज के रूप में चाहिए।
- **Word, HTML, Markdown, Typst, LaTeX या सादा पाठ** उस व्यक्ति के लिए है जिसे सामग्री को किसी अन्य प्रारूप में संपादित या पुनः उपयोग करनी है।
- **PowerPoint** किसी प्रस्तुति या Markdown दस्तावेज़ को स्लाइड में बदलने के लिए है। **EPUB** ई-बुक रीडर के लिए है। कौन से दिखेंगे, यह इंजन पर निर्भर करता है। [प्रस्तुति और पुस्तक निर्यात](#presentation-and-book-exports) देखें।

## PDF, स्रोत संग्रह या पेज छवि सहेजें

1. **Recompile** चुनें ताकि आउटपुट में आपके नवीनतम संपादन शामिल हों।
2. PDF की जाँच करें, अंतिम पृष्ठ और ग्रंथ-सूची सहित।
3. **Export** खोलें।
4. **Export as PDF**, **Export source (.zip)** या **Export page as PNG** चुनें।
5. सहेज संवाद में कोई गंतव्य चुनें।
6. सहेजी गई फ़ाइल ढूँढने के लिए पूर्णता संदेश में **Show in folder** चुनें।

जब तक प्रोजेक्ट के पास PDF नहीं होती, PDF और पेज-छवि क्रियाएँ निष्क्रिय रहती हैं, और मेनू **PDF requires a compile first** कहता है। **Export as PDF** पूर्वावलोकन में दिख रही PDF सहेजता है। **Export page as PNG** पूर्वावलोकन में आप जो पेज देख रहे हैं उसे उच्च रिज़ॉल्यूशन पर सहेजता है।

स्रोत संग्रह में बिल्ड कैश और Git की आंतरिक फ़ाइलें शामिल नहीं होतीं। उसमें सिम्बॉलिक लिंक भी नहीं होते, और पूर्णता संदेश बताता है कि कितने छोड़े गए।

### जब PDF नवीनतम न हो

पूर्वावलोकन पुराना होने पर भी Oleafly PDF या पेज छवि सहेज लेता है, और पूर्णता संदेश आपको बताता है:

- विफल कंपाइल के बाद वह कहता है कि पिछला कंपाइल विफल रहा, इसलिए फ़ाइल अधूरी हो सकती है।
- बिना कंपाइल किए संपादनों के बाद वह कहता है कि फ़ाइल पिछले कंपाइल से आई है और उसमें आपके नवीनतम संपादन शामिल नहीं हैं।

किसी को फ़ाइल भेजने से पहले फिर से कंपाइल करें, पूर्वावलोकन जाँचें, और दोबारा निर्यात करें।

## Typst छवियाँ और HTML

Typst प्रोजेक्ट के Export मेनू में **Images and HTML** भी होता है, जो **Export with Typst** खोलता है। Typst इन फ़ाइलों को स्वयं बनाता है, इसलिए PNG और SVG पेज बिल्कुल PDF जैसे दिखते हैं।

- **PNG images** 72, 144, 300 या 600 PPI का **Resolution** लेती हैं।
- **SVG images** पेजों को वेक्टर ग्राफ़िक्स के रूप में रखती हैं।
- **HTML** को **Experimental** चिह्नित किया गया है। Typst का HTML पाठ और छवियाँ रखता है, पर पेज सेटअप और ड्रॉइंग छोड़ देता है। Typst 0.15 से पहले वह समीकरण भी छोड़ देता है, और HTML चुनने पर संवाद ऐसा बता देता है।

PNG और SVG के लिए, **Pages** पेज संख्याएँ और श्रेणियाँ लेता है जैसे `1, 3-5` या `8-`। हर पेज के लिए इसे खाली छोड़ दें। प्रत्येक पेज अपनी अलग फ़ाइल के रूप में सहेजा जाता है, और उसे आपके चुने हुए नाम के आधार पर क्रमांकित किया जाता है। पेज श्रेणियों के लिए Typst 0.12 या बाद का संस्करण चाहिए, और HTML के लिए Typst 0.13 या बाद का। संवाद केवल वही ऑफ़र करता है जो प्रोजेक्ट का Typst संस्करण कर सकता है। यदि प्रोजेक्ट में [बिल्ड वेरिएंट](/docs/typst/#build-variants-and-sysinputs) हैं, तो निर्यात कंपाइल मेनू में चुने गए वेरिएंट का उपयोग करता है।

## Typst से PDF/A और PDF/UA

Typst संग्रह-योग्य और सुगम PDF स्वयं लिखता है। [Preflight](/docs/preflight/) के लिए प्रोजेक्ट रेल में **shield** खोलें, और **Accessibility** जाँच के अंतर्गत **PDF standards** खोजें। कोई **Standard** चुनें, जैसे PDF/A-2b या PDF/UA-1, फिर **Export PDF** चुनें।

सूची प्रोजेक्ट के Typst संस्करण पर निर्भर करती है। Typst 0.11 में कुछ नहीं है, Typst 0.12 PDF/A-2b देता है, Typst 0.13 PDF/A-3b जोड़ता है, और Typst 0.14 तथा बाद के हर PDF/A स्तर के साथ PDF/UA-1 भी देते हैं। Typst 0.14 और बाद के हर PDF को स्क्रीन रीडर के लिए टैग भी करते हैं, इसलिए कोई अलग टैग कंपाइल नहीं है। PDF/UA-1 को दस्तावेज़ शीर्षक और हर छवि के लिए वैकल्पिक पाठ चाहिए, और Preflight दोनों की जाँच करता है।

## संपादन योग्य प्रारूप

| प्रोजेक्ट इंजन | Export में प्रारूप |
| --- | --- |
| **LaTeX** | Word, MathML सहित स्वसंपूर्ण HTML, Markdown, Typst और सादा पाठ |
| **Typst** | LaTeX, Word, MathML सहित स्वसंपूर्ण HTML, Markdown और सादा पाठ |
| **Markdown** | Word, MathML सहित स्वसंपूर्ण HTML, Typst, LaTeX और सादा पाठ |

Typst प्रोजेक्ट EPUB भी देता है, और Markdown प्रोजेक्ट PowerPoint और EPUB देता है। LaTeX प्रोजेक्ट इन्हें केवल मिलती हुई दस्तावेज़ क्लास के लिए देता है।

ये रूपांतरण Pandoc के माध्यम से स्थानीय रूप से चलते हैं। Oleafly आपके कंप्यूटर पर मौजूद संगत संस्थापन का उपयोग करता है, या पहली बार ज़रूरत पड़ने पर एक सत्यापित प्रबंधित बिल्ड डाउनलोड करता है।

Typst प्रोजेक्ट दूसरा मार्ग लेते हैं। Typst पहले दस्तावेज़ को HTML के रूप में लिखता है, और Pandoc उस HTML को Word, HTML, Markdown, LaTeX, सादे पाठ या EPUB में बदलता है, इसलिए समीकरण और संदर्भ आ जाते हैं। कोई दस्तावेज़ इस मार्ग से जा सकता है या नहीं, यह प्रोजेक्ट के Typst संस्करण पर निर्भर करता है:

| Typst संस्करण | मार्ग |
| --- | --- |
| 0.15 या बाद का | HTML के रास्ते |
| 0.13 और 0.14 | HTML के रास्ते, जब Typst पूरा दस्तावेज़ लिख सके। जब न लिख सके, तो Pandoc इसके बजाय Typst स्रोत पढ़ता है। |
| 0.12 या पहले का | Pandoc स्रोत पढ़ता है |

अगर HTML लिखते समय Typst किसी त्रुटि पर रुक जाए, तो हर संस्करण पर Pandoc स्रोत पढ़ता है। जब Typst 0.13 या 0.14 पर Pandoc स्रोत पढ़ता है, तो पूर्णता संदेश चेतावनी देता है कि घुमाया, छोटा-बड़ा किया, खिसकाया या तिरछा किया गया पाठ ग़ायब हो सकता है, जब तक निर्यात में चेतावनियाँ न हों। सबसे पूर्ण निर्यात के लिए कंपाइल मेनू में **Typst version (this project)** के अंतर्गत प्रोजेक्ट को Typst 0.15 या बाद के संस्करण पर ले जाएँ।

जब निर्यात HTML के रास्ते जाता है, तो `align`, `grid` और `rotate` जैसे लेआउट फ़ंक्शन के अंदर का पाठ उसमें बना रहता है। CeTZ से बना चित्र अपनी रेखाएँ और आकृतियाँ खो देता है और केवल अपने पाठ लेबल रखता है, और पूर्णता संदेश बताता है कि Typst ने क्या छोड़ा।

## दस्तावेज़ रूपांतरित करें

1. एक बार कंपाइल करें और किसी भी स्रोत त्रुटि को ठीक करें।
2. **Export** खोलें और लक्ष्य प्रारूप चुनें।
3. संकेत मिलने पर Pandoc सेटअप पूरा करें। अगर Oleafly कहे कि Pandoc उपलब्ध नहीं है, तो **Settings → Engines → Markdown** में **Repair Pandoc** चुनें, फिर दोबारा निर्यात करें।
4. सुझाए गए एक्सटेंशन के साथ रूपांतरित फ़ाइल सहेजें।
5. पूर्णता संदेश पढ़ें। अगर उसमें चेतावनियों का ज़िक्र हो, तो **Show warnings** चुनें और देखें कि निर्यात ने क्या छोड़ा।
6. फ़ाइल को गंतव्य ऐप में खोलें और उसकी संरचना व स्वरूप की जाँच करें।

एक त्वरित परीक्षण के लिए, एक छोटा अनुभाग निर्यात करें जिसमें शीर्षक, समीकरण, तालिका, छवि और उद्धरण हों। यदि ये पाँच तत्व ठीक से बच निकलें, तो पूरी पांडुलिपि रूपांतरित करें और उसे फिर से देखें।

किसी पूरे LaTeX प्रोजेक्ट को उस Typst प्रोजेक्ट में बदलने के लिए जिसमें आप काम करते रहना चाहते हैं, इसके बजाय [Convert to a Typst project](/docs/typst/#convert-a-latex-project-to-typst) का उपयोग करें। यह एक नया प्रोजेक्ट बनाता है और बताता है कि किस पर ध्यान देने की ज़रूरत है।

### रूपांतरण क्या बनाए रखता है

Pandoc शीर्षकों, अनुच्छेदों, सूचियों, लिंकों, उद्धरणों, तालिकाओं, छवियों और संपादन योग्य गणित को बनाए रखने का प्रयास करता है। यह हर स्रोत-भाषा की हर सुविधा को हर लक्ष्य में पुनः नहीं बना सकता। इन क्षेत्रों को ध्यान से जाँचें:

- कस्टम LaTeX कमांड और एनवायरनमेंट
- हाथ से ठीक किया गया पेज लेआउट या floats
- जटिल या नेस्टेड तालिकाएँ
- ग्रंथ-सूची शैली और उद्धरण रेंडरिंग
- ऐसे Typst फ़ंक्शन जिनका लक्ष्य में कोई सीधा समतुल्य नहीं है
- रॉ HTML या Markdown एक्सटेंशन

HTML निर्यात अपने संसाधन एम्बेड करता है और समीकरणों को MathML के रूप में लिखता है। इससे यह किसी ऐसे दस्तावेज़ को साझा करने के लिए उपयोगी बनता है जो अपने आप खुल जाए, पर इसे आपके पाठकों के ब्राउज़रों में परखना अब भी सार्थक है।

### हर प्रारूप क्या रखता है

- Word और PowerPoint निर्यात PDF, SVG और WebP आकृतियों को 220 ppi पर PNG चित्रों में बदलते हैं। जिस आकृति का स्रोत में कोई आकार नहीं है, वह अपनी चौड़ाई रखती है।
- HTML और EPUB निर्यात PDF आकृतियों को PNG चित्रों में बदलते हैं।
- LaTeX से निर्यात किए गए Markdown और सादे पाठ में शीर्षक, लेखक और सार बना रहता है।
- LaTeX से Markdown या Typst में, और Markdown से LaTeX या Typst में निर्यात, प्रोजेक्ट की आकृति फ़ाइलों की प्रति बनाने के बजाय उनसे लिंक करते हैं। जब तक निर्यात में चेतावनियाँ न हों, पूर्णता संदेश याद दिलाता है कि कंपाइल करने से पहले छवियाँ और ग्रंथ-सूची निर्यात की गई फ़ाइल के बगल में कॉपी कर लें। Typst या LaTeX में निर्यात किया गया Markdown दस्तावेज़ वह ग्रंथ-सूची रखता है जो उसने घोषित की है, या कोई घोषित न हो तो प्रोजेक्ट की `.bib` फ़ाइलें।
- Markdown दस्तावेज़ का LaTeX निर्यात उसके [दस्तावेज़ प्रकार](/docs/writing/markdown/#document-types) का अनुसरण करता है। स्लाइड और पोस्टर Beamer स्रोत बनते हैं, रिपोर्ट या किताब `#` शीर्षकों पर अध्याय शुरू करती है, और पत्र KOMA-Script पत्र बनता है।
- Typst से LaTeX निर्यात दस्तावेज़ की छवियों को `.tex` फ़ाइल के बगल के `<name>-media` फ़ोल्डर में कॉपी करता है। वहाँ SVG, GIF और WebP छवियाँ PDF बन जाती हैं, क्योंकि LaTeX उन्हें पढ़ नहीं सकता।

निर्यात आकृतियाँ मुख्य दस्तावेज़ के फ़ोल्डर, प्रोजेक्ट रूट और किसी भी `\graphicspath` फ़ोल्डर में ढूँढते हैं, और बिना एक्सटेंशन के लिखे नाम वाली आकृति भी ढूँढ लेते हैं। EPS आकृतियाँ बदली नहीं जा सकतीं, इसलिए वे चेतावनी के साथ फ़ाइल में जैसी हैं वैसी चली जाती हैं। Markdown दस्तावेज़ के Word, HTML, EPUB या PowerPoint निर्यात में Mermaid ब्लॉक उसके लिए सहेजी गई आकृति दिखाता है।

### निर्यात के बाद की चेतावनियाँ

Pandoc वह सब छोड़ देता है जो कोई प्रारूप रख नहीं सकता। LaTeX या Markdown प्रोजेक्ट के निर्यात में, या स्रोत पढ़ने वाले Typst निर्यात में, ऐसा होने पर पूर्णता संदेश अपने दूसरे नोटों, जैसे छवियाँ कॉपी करने की याद, की जगह यह बताता है कि फ़ाइल चेतावनियों के साथ सहेजी गई और कितनी चेतावनियाँ थीं। **Show warnings** चुनने पर **Export warnings** खुलता है, जो बताता है कि क्या ग़ायब हुआ। उस संवाद में **Show in folder** सहेजी गई फ़ाइल वाला फ़ोल्डर खोलता है।

सूची ये बता सकती है:

- निर्यात का छोड़ा हुआ कोई ब्लॉक, पता हो तो उसकी फ़ाइल और पंक्ति के साथ, जैसे `tikzpicture`, `\includepdf`, या `\only` अथवा `\uncover` जैसी Beamer ओवरले कमांड
- कोई आकृति जो निर्यात को मिली नहीं या जिसे वह बदल नहीं पाया
- कोई उद्धरण कुंजी जो ग्रंथ-सूची में नहीं है
- गणित जो TeX कोड के रूप में रह गया
- ऐसे संदर्भ जिनका अभी कोई क्रमांक नहीं है, जिसे कंपाइल ठीक कर देता है

दोहराई गई चेतावनी एक बार दिखती है, और सूची 50 पर रुक जाती है। जब कोई आकृति ग़ायब हो, तो PowerPoint निर्यात अलग तरह से काम करता है: वह रुक जाता है, कोई फ़ाइल नहीं सहेजता, और त्रुटि आकृति का नाम बताती है। HTML के रास्ते जाने वाले Typst निर्यात इसके बजाय पूर्णता संदेश में बताते हैं कि Typst ने क्या छोड़ा।

## प्रस्तुति और पुस्तक निर्यात

LaTeX प्रोजेक्ट इन्हें अपनी दस्तावेज़ क्लास से मिलाता है। Beamer प्रस्तुति के लिए **Export as PowerPoint (.pptx)** दिखता है, और `book`, `report`, `memoir`, `scrbook` तथा `scrreprt` क्लास के लिए **Export as EPUB (.epub)**।

Beamer डेक में हर फ़्रेम नई स्लाइड शुरू करता है, `\section` एक अनुभाग स्लाइड जोड़ता है, और `\subsection` कोई नहीं जोड़ता। एक से ज़्यादा छवियों वाला फ़्रेम, या छवि और दूसरी सामग्री वाला फ़्रेम, दूसरी स्लाइड तक जा सकता है।

Typst और Markdown प्रोजेक्ट में मेनू इन निर्यातों के लिए दस्तावेज़ की जाँच नहीं करता। Markdown प्रोजेक्ट हमेशा दोनों देता है, और Typst प्रोजेक्ट हमेशा EPUB देता है। जब Markdown दस्तावेज़ PowerPoint बनता है, तो प्रत्येक स्तर 1 शीर्षक एक अनुभाग स्लाइड बनता है और प्रत्येक स्तर 2 शीर्षक नई स्लाइड शुरू करता है। अपवाद `type: slides` वाला दस्तावेज़ है: उसके फ़्रंट मैटर की `slide-level` पंक्ति तय करती है कि कौन सा शीर्षक स्तर स्लाइड शुरू करता है। हर EPUB को विषय-सूची मिलती है, और उसके समीकरण MathML होते हैं।

इन्हें संपादन योग्य शुरुआती बिंदुओं की तरह उपयोग करें। स्लाइड संयोजन और पुस्तक टाइपोग्राफ़ी प्रारूपों के बीच शायद ही कभी एक-से-एक मेल खाते हैं, इसलिए हर स्लाइड या अध्याय को उसके गंतव्य ऐप में देखें।

## स्वतंत्र आकृति का निर्यात करें

स्वतंत्र आकृति प्रोजेक्ट कंपाइल के बाद **Export as PDF (vector image)** और **Export as PNG** देता है। किसी भी पैमाने पर तेज़ रेखाओं और पाठ के लिए PDF चुनें। जब गंतव्य केवल रास्टर छवियाँ स्वीकार करता हो, तो PNG चुनें।

## प्रोजेक्ट के भीतर आउटपुट सहेजें

[PDF पूर्वावलोकन](/docs/pdf-preview/) में भी **Save PDF to project** उपलब्ध है। यह स्रोत के बगल में सबमिशन की प्रति या कंपाइल की गई आकृति रखता है। उस प्रति को ताज़ा रखने के लिए उसी मेन्यू में [Sync PDF on compiles](/docs/pdf-preview/#sync-pdf-on-compiles) चालू करें, और Oleafly हर सफल कंपाइल के बाद प्रोजेक्ट के नाम वाला PDF ताज़ा कर देता है। प्रोजेक्ट को पुनर्स्थापित किए बिना पुराना PDF [चेकपॉइंट](/docs/checkpoints/#save-a-pdf-from-a-checkpoint) से सहेजा जा सकता है। उस फ़ाइल को [Git इतिहास](/docs/git-history/) में केवल तभी जोड़ें जब आप जेनरेट किए गए आउटपुट को संस्करणबद्ध करना चाहते हैं।

## साझा करने से पहले जाँचें

सबमिशन से पहले [Preflight](/docs/preflight/) चलाएँ। यदि आपको टैग किया हुआ PDF चाहिए, तो LaTeX के लिए सुगम-निर्यात कार्यप्रवाह अपनाएँ या Typst प्रोजेक्ट में कोई PDF/UA मानक चुनें, फिर परिणाम को एक स्वतंत्र PDF/UA चेकर और मानव सुगमता समीक्षा से सत्यापित करें। Preflight कई उपयोगी संकेत जाँचता है, पर यह अनुपालन प्रमाणित नहीं करता।
