# LaTeX इंजन और पैकेज

Tectonic या latexmk कंपाइलर चुनें, कोई मौजूदा TeX डिस्ट्रिब्यूशन इस्तेमाल करें, या Oleafly का मैनेज्ड TinyTeX इंस्टॉल करें।

Oleafly में Tectonic पहले से आता है और यह `latexmk` से भी कंपाइल कर सकता है। रोज़मर्रा के बिल्ड प्रोजेक्ट का कंपाइलर मेन्यू नियंत्रित करता है। **Settings → Engines** आपकी मशीन पर उपलब्ध TeX डिस्ट्रिब्यूशन और पैकेज दिखाता है।

## Tectonic: रोज़ का इंजन

जब तक आप **Settings → Engines → LaTeX** में **Default compile engine** के नीचे कोई दूसरा न चुनें, **Tectonic** ही डिफ़ॉल्ट कंपाइल इंजन है। इसे अलग से इंस्टॉल करने की ज़रूरत नहीं है, यह ज़रूरत पड़ने पर पैकेज ले आता है और ऑफ़लाइन इस्तेमाल के लिए उन्हें कैश कर लेता है। यह ज़्यादातर प्रोजेक्ट के लिए उपयुक्त है और कोई सिस्टम TeX डिस्ट्रिब्यूशन इंस्टॉल न होने पर भी उपलब्ध रहता है। [नए प्रोजेक्ट के लिए डिफ़ॉल्ट सेट करें](/docs/engines/#set-a-default-for-new-projects) देखें।

**टैग की गई PDF** के लिए LuaLaTeX वर्कफ़्लो इस्तेमाल करें। टैग असिस्टिव टेक्नोलॉजी के लिए डॉक्यूमेंट की संरचना बताते हैं। कंपाइल के बाद Preflight से परिणाम की जाँच करें।

### बिल्ट-इन इंजन पर फ़ॉन्ट

Tectonic XeTeX पर आधारित है, जो फ़ॉन्ट फ़ाइलें सीधे पढ़ता है। Oleafly कुछ चीज़ें इस तरह समायोजित करता है कि pdfLaTeX के लिए लिखे डॉक्यूमेंट अपने फ़ॉन्ट और टेक्स्ट बनाए रखें:

- Times, Helvetica, Courier, Palatino, Bookman, New Century Schoolbook और Avant Garde, Latin Modern पर लौटने के बजाय अपने TeX Gyre संस्करण इस्तेमाल करते हैं।
- `\usepackage[T1]{fontenc}` इस इंजन पर टाइप किए गए एक्सेंट और प्रतीकों को तोड़ देता है, इसलिए Oleafly डॉक्यूमेंट को Unicode टेक्स्ट पर रखता है। अगर डॉक्यूमेंट का कोई फ़ॉन्ट केवल T1 में मौजूद है, तो डॉक्यूमेंट T1 पर ही रहता है और कंपाइल चेतावनी देता है कि ß, §, «, घुमावदार उद्धरण चिह्न और € जैसे अक्षर गलत छप सकते हैं या ग़ायब हो सकते हैं। चेतावनी उस पंक्ति का ऐसा संस्करण देती है जो T1 को केवल pdfLaTeX के तहत लोड करता है:

  ```latex
  \usepackage{iftex}
  \ifPDFTeX
    \usepackage[T1]{fontenc}
  \fi
  ```

- `\pdfoutput=1` सेट करने वाला डॉक्यूमेंट, जैसा arXiv माँगता है, जैसा है वैसा कंपाइल होता है।
- जो `ctex` डॉक्यूमेंट कोई `fontset` सेट नहीं करता, उसे Fandol फ़ॉन्ट मिलते हैं, ताकि वह हर कंप्यूटर पर एक जैसा दिखे। Mac के अपने फ़ॉन्ट इस्तेमाल करने के लिए क्लास विकल्पों में `fontset=mac` जोड़ें।
- बिल्ट-इन इंजन के साथ आने वाले फ़ॉन्ट फ़ाइल के नाम से मिलते हैं। `\setmainfont{UnBatang}` विफल होता है, और त्रुटि बताती है कि इसके बजाय `UnBatang.ttf` लिखें।

Offline mode फ़ॉन्ट और एन्कोडिंग के ये समायोजन छोड़ देता है, इसलिए ऐसे डॉक्यूमेंट का ऑफ़लाइन बिल्ड ऑनलाइन बिल्ड से अलग दिख सकता है।

## latexmk और सिस्टम TeX

जब कोई प्रोजेक्ट पारंपरिक TeX Live या MiKTeX वर्कफ़्लो पर निर्भर हो, तो प्रोजेक्ट के कंपाइलर मेन्यू से pdfLaTeX, XeLaTeX, LuaLaTeX, upLaTeX या pLaTeX चुनें। Oleafly उन कंपाइलरों को `latexmk` के ज़रिए चलाता है। **Auto** मुख्य फ़ाइल पढ़कर एक कंपाइलर चुनता है: सबसे ऊपर की `% !TeX program = xelatex` पंक्ति को सबसे पहले माना जाता है, फिर जापानी क्लासों को, फिर उन पैकेजों को जिन्हें XeLaTeX या LuaLaTeX चाहिए, जैसे `fontspec`, `ctex`, `xeCJK` या `luatexko`। अगर मुख्य फ़ाइल से फ़ैसला न हो, तो Auto प्रोजेक्ट में `latexmkrc` और प्रीएम्बल जो फ़ाइलें लोड करता है, उन्हें भी जाँचता है। बाकी सब कुछ pdfLaTeX इस्तेमाल करता है। अगर किसी पैकेज को Auto के चुने कंपाइलर से अलग कंपाइलर चाहिए, तो कंपाइल बदलने का प्रस्ताव देता है, जैसे **Use XeLaTeX** के साथ।

वह टूलचेन देने के दो तरीके हैं:

1. **मौजूदा इंस्टॉलेशन इस्तेमाल करें।** Oleafly आपके सिस्टम पर MacTeX, TeX Live, MiKTeX और TinyTeX पहचान लेता है। यह उसी `PATH` में देखता है जो आपका टर्मिनल इस्तेमाल करता है, और Windows पर सिस्टम और यूज़र `Path` सेटिंग में भी, इसलिए हाथ से इंस्टॉल किया TeX तब भी मिल जाता है जब ऐप Dock या Start मेन्यू से खोला गया हो। कोई सिस्टम इंस्टॉलेशन Oleafly की मैनेज्ड कॉपी से तभी प्राथमिकता पाता है जब उसकी बाइनरी डायरेक्टरी में `latexmk`, pdfLaTeX, XeLaTeX, LuaLaTeX, `kpsewhich` और Biber मौजूद हों। अधूरा इंस्टॉलेशन काम करते मैनेज्ड TinyTeX से चुपचाप ऊपर नहीं बैठ सकता।
2. **मैनेज्ड TinyTeX इंस्टॉल करें।** डाउनलोड लगभग 250 MB का है और इसके लिए एडमिनिस्ट्रेटर एक्सेस नहीं चाहिए। देखें [TinyTeX इंस्टॉल और अपडेट करें](#install-and-update-tinytex)।

**Settings → Engines → LaTeX** में **Manage TeX distributions** Oleafly को मिली हर डिस्ट्रिब्यूशन सूचीबद्ध करता है। **In use** उसे चिह्नित करता है जिससे `latexmk` कंपाइल करता है, और **latexmk** बैज हर उस डिस्ट्रिब्यूशन को चिह्नित करता है जो कंपाइल कर सकती है। किसी दूसरी पंक्ति पर **Use for compiles** चुनकर उस पर जाएँ। चुनी हुई पंक्ति तब **Automatic** दिखाती है, जो Oleafly को फिर से चुनने देता है: पहले पूरा सिस्टम TeX, फिर TinyTeX।

अगर TeX ऐसे फ़ोल्डर में इंस्टॉल है जहाँ Oleafly नहीं देखता, तो **Choose a TeX folder** क्लिक करें और वह फ़ोल्डर चुनें जिसमें `latexmk` है, या उसके ऊपर का TeX Live वर्ष वाला फ़ोल्डर, जैसे `texlive/2026`। Oleafly अंदर `latexmk` ढूँढ लेता है और उसी इंस्टॉलेशन से कंपाइल करता है, जिसे सूची **In use** चिह्नित करती है। **Automatic** इस चुनाव को पलट देता है। अगर फ़ोल्डर में `latexmk` नहीं है, तो संदेश बताता है कि इसके बजाय कौन सा फ़ोल्डर चुनें।

`latexmk` कोई फ़ाइलसिस्टम सैंडबॉक्स नहीं है। शेल कमांड ब्लॉक होने पर भी TeX आपके अकाउंट की पहुँच वाली फ़ाइलें पढ़ सकता है। Oleafly प्रोजेक्ट, यूज़र और सिस्टम की `.latexmkrc` फ़ाइलें भी बंद रखता है क्योंकि वे निष्पादन योग्य Perl हैं। सिस्टम TeX केवल उन्हीं प्रोजेक्ट के लिए इस्तेमाल करें जिन पर आप भरोसा करते हैं। इंपोर्ट किया गया प्रोजेक्ट सिस्टम TeX तभी इस्तेमाल करता है जब आप उसे चुनें, या तो डिफ़ॉल्ट कंपाइल इंजन के रूप में या प्रोजेक्ट के कंपाइलर मेन्यू से। जिस फ़ोल्डर को आप उसी जगह खोलते हैं, वह तब तक Tectonic पर रहता है जब तक आप उस पर भरोसा न करें।

### जब कोई TeX इंस्टॉल न हो

जिस कंप्यूटर पर चालू TeX डिस्ट्रिब्यूशन नहीं है, वहाँ pdfLaTeX, XeLaTeX, LuaLaTeX, upLaTeX, pLaTeX या Auto चुनने पर **This compiler needs a working TeX distribution** शीर्षक वाला डायलॉग खुलता है। वह इसी क्रम में तीन विकल्प दिखाता है:

- **Download TinyTeX**, जिस पर **Recommended** लिखा होता है। **Download and use TinyTeX** TinyTeX इंस्टॉल करता है और प्रोजेक्ट को उसी से कंपाइल करता है।
- **Use my system LaTeX (latexmk)**, जो बताता है कि कोई TeX डिस्ट्रिब्यूशन नहीं मिला, या इस कंप्यूटर वाला कंपाइल क्यों नहीं कर सकता। इसमें कोई बटन नहीं है।
- **Keep using Tectonic**। **Switch back to Tectonic** प्रोजेक्ट को बिल्ट-इन इंजन पर लौटा देता है।

अगर आप पहले कंपाइल करते हैं, तो प्रीव्यू वही रास्ता देता है: **Download and use TinyTeX**, **Use Tectonic** और **Open engine settings**। TinyTeX के डाउनलोड होते समय आपने जो कंपाइल शुरू किया, वह इंतज़ार करता है और इंस्टॉल पूरा होते ही अपने आप शुरू हो जाता है।

वही प्रस्ताव तब भी दिखता है जब TeX डिस्ट्रिब्यूशन मौजूद है पर उसमें `latexmk` नहीं है। जब डिस्ट्रिब्यूशन में `latexmk`, चुना हुआ कंपाइलर या Biber नहीं होता, और Oleafly डिस्ट्रिब्यूशन को पहचानता है, तो संदेश यह भी बताता है कि क्या इंस्टॉल करना है, जैसे MacTeX पर `sudo tlmgr install latexmk` या Ubuntu पर `sudo apt install latexmk`।

साझा प्रोजेक्ट में बटन पर **Use Tectonic for everyone** लिखा होता है, क्योंकि कंपाइलर प्रोजेक्ट में सहेजा जाता है और हर सहयोगी के लिए बदल जाता है। TinyTeX इंस्टॉल करना केवल आपका कंप्यूटर बदलता है।

### TinyTeX इंस्टॉल और अपडेट करें

**Settings → Engines → LaTeX** खोलें और **Manage TeX distributions** के नीचे **Download TinyTeX (~250 MB)** चुनें, या कंपाइल डायलॉग का प्रस्ताव इस्तेमाल करें। TinyTeX एक छोटा TeX Live है जिसे एडमिनिस्ट्रेटर अधिकार नहीं चाहिए। जर्नल टेम्पलेट बाद में पैकेज जोड़ सकते हैं, कुल मिलाकर लगभग 1 GB तक, और शुरू करने से पहले Oleafly लगभग 2 GB खाली डिस्क जगह जाँचता है। TinyTeX `~/.oleafly/tinytex` के नीचे इंस्टॉल होता है।

- **Cancel** डाउनलोड रोकता है और जो आ चुका है उसे रखता है। तब बटन पर पूरी हो चुकी मात्रा के साथ **Resume download** लिखा आता है। इंस्टॉल के दौरान Oleafly बंद करने पर भी वह इसी तरह रुक जाता है, और अगली बार ऐप खोलने पर आगे बढ़ता है।
- डाउनलोड पहले Oleafly के मिरर से आता है, फिर GitHub से। अगर कोई स्रोत विफल हो जाए, या एक मिनट तक डेटा भेजना बंद कर दे, तो Oleafly अगले स्रोत पर चला जाता है और जहाँ रुका था वहीं से जारी रखता है। **Settings → Downloads → Sources** बदल सकता है कि डाउनलोड कहाँ से आएँ। देखें [Sources टैब](/docs/settings/downloads/#sources-tab)।
- जब मैनेज्ड TinyTeX उस रिलीज़ से पुरानी हो जिसकी Oleafly के इस संस्करण को उम्मीद है, तो उसकी पंक्ति **Update** दिखाती है। **Remove** उसे हटा देता है।

अगर कोई दूसरी डिस्ट्रिब्यूशन पहले से **In use** है, तो TinyTeX इंस्टॉल करने से उस पर स्विच नहीं होता। जब आप चाहें कि TinyTeX कंपाइल करे, तो TinyTeX की पंक्ति में **Use for compiles** चुनें।

Linux पर TinyTeX सिस्टम के Perl पर चलता है। Oleafly कुछ भी डाउनलोड करने से पहले Perl जाँचता है। अगर Perl या उसका कोई मानक मॉड्यूल ग़ायब है, तो संदेश उसे इंस्टॉल करने की कमांड देता है: `sudo apt install perl`, `sudo dnf install perl` या `sudo pacman -S perl`।

Windows पर TeX Live ऐसे फ़ोल्डर से नहीं चल सकता जिसके नाम में एक्सेंट वाले या गैर-लैटिन अक्षर हों। अगर आपके यूज़र फ़ोल्डर का नाम ऐसा है, तो Oleafly TinyTeX को इसके बजाय ProgramData के नीचे एक फ़ोल्डर में रखता है। अगर TinyTeX के अपनी जगह पर आते समय एंटीवायरस किसी फ़ाइल को खुला रखे, तो Oleafly फिर कोशिश करता है, और फिर भी पूरा न कर पाए तो थोड़ी देर रुककर इंस्टॉल फिर आज़माएँ।

### MiKTeX और Perl

MiKTeX का `latexmk` एक Perl स्क्रिप्ट है, और MiKTeX में Perl शामिल नहीं होता। Perl के बिना Settings, MiKTeX को **latexmk needs Perl** से चिह्नित करता है, और TinyTeX इंस्टॉल हो तो Oleafly उसके बजाय TinyTeX से कंपाइल करता है। अगर इस्तेमाल करने को और कुछ न हो, तो कंपाइल रुक जाता है और आगे बढ़ने के तीन रास्ते देता है: **Settings → Engines → LaTeX** से TinyTeX इंस्टॉल करें, जो अपना Perl साथ लाता है, Strawberry Perl इंस्टॉल करें, या प्रोजेक्ट को वापस Tectonic पर ले जाएँ।

MiKTeX अपने पैकेज MiKTeX Console में प्रबंधित करता है, इसलिए **Packages** सूची और **Find and install** उस पर लागू नहीं होते। MiKTeX कंपाइल के दौरान EPS फ़िगर भी नहीं बदलता, इसलिए उन्हें पहले PDF में बदल लें या TinyTeX इस्तेमाल करें।

### जापानी डॉक्यूमेंट: upLaTeX और pLaTeX

जापानी डॉक्यूमेंट के लिए **Compiler (this project)** के नीचे **upLaTeX** या **pLaTeX** चुनें, या कंपाइलर को **Auto** पर रहने दें। Auto `jsarticle`, `jsbook` और `jsreport` के लिए pLaTeX चुनता है (क्लास में `uplatex` विकल्प हो तो upLaTeX), `uj` क्लासों और `jlreq` के लिए upLaTeX, और `ltjsarticle` तथा दूसरे LuaTeX-ja डॉक्यूमेंट के लिए LuaLaTeX।

दोनों कंपाइलरों को TeX Live का जापानी समर्थन चाहिए। जब वह मैनेज्ड TinyTeX में, या ऐसे TeX Live में जिसमें Oleafly लिख सकता है, ग़ायब हो, तो विफल कंपाइल **Install Japanese support (about 450 MB)** का प्रस्ताव देता है। वह उसे इंस्टॉल करके दोबारा कंपाइल करता है। दूसरी इंस्टॉलेशनों पर संदेश आपकी डिस्ट्रिब्यूशन की कमांड बताता है, जैसे `sudo apt install texlive-lang-japanese`।

## जब Tectonic काफ़ी न हो

कुछ डॉक्यूमेंटों को ऐसी चीज़ें चाहिए जो बिल्ट-इन Tectonic इंजन नहीं करता, जैसे EPS फ़िगर या ज़बरदस्ती लगाया गया `pdftex` ड्राइवर। जब कोई प्रोजेक्ट खोलने के बाद पहली कंपाइल, या आपकी खुद शुरू की हुई कंपाइल, इनमें से किसी पर टकराती है, तो इंजन डायलॉग अपने आप खुल जाता है। जब Auto compile या कोई एजेंट कंपाइल शुरू करता है, तो डायलॉग बंद रहता है और उसकी जगह **Choose engine** दिखता है। डायलॉग खोलने के लिए उसे चुनें। बटन अगली कंपाइल तक बना रहता है, इसलिए डायलॉग बंद करने के बाद भी वह उसे फिर खोलता है। वह कहाँ मिलता है, यह व्यू पर निर्भर करता है:

- असफल कंपाइल के बाद, **Logs** खुला होने पर वह प्रीव्यू टूलबार के दाईं ओर होता है। जब कंपाइल से कोई PDF नहीं बना, तो प्रीव्यू अपने आप **Logs** पर चला जाता है। अगर कोई PDF अब भी दिख रहा है, तो बटन देखने के लिए **Logs** चुनें।
- खाली प्रीव्यू में, वह **Retry compile** के बगल में होता है।
- केवल-एडिटर व्यू में, जब PDF अपनी अलग विंडो में हो, या सफल कंपाइल के बाद, वह **Recompile** के बाईं ओर होता है।

डायलॉग का शीर्षक **This compile needs more than the built-in engine** है और वह उन समस्याओं को सूचीबद्ध करता है जो उसे मिलीं। **Recommended** चिह्नित विकल्प सबसे पहले आता है:

- **Download TinyTeX** तब दिखता है जब कोई चालू TeX डिस्ट्रिब्यूशन इंस्टॉल न हो। उसका बटन, **Download and use TinyTeX**, TinyTeX इंस्टॉल करता है, प्रोजेक्ट को `latexmk` पर स्विच करता है, और फिर कंपाइल करता है।
- **Use my system LaTeX (latexmk)** में **Use system LaTeX** है, जो प्रोजेक्ट को Oleafly को मिली TeX डिस्ट्रिब्यूशन पर `latexmk` के साथ स्विच कर देता है। अगर डॉक्यूमेंट को pdfLaTeX चाहिए, तो विकल्प **Use pdfLaTeX on my system LaTeX (latexmk)** पढ़ता है और उसका बटन **Switch to pdfLaTeX and recompile** पढ़ता है। कोई TeX इंस्टॉल न होने पर इस विकल्प में कोई बटन नहीं होता।
- **Keep using Tectonic** में **Keep Tectonic** है, जो प्रोजेक्ट को बिल्ट-इन इंजन पर ही रहने देता है। जब कोई स्विच डायलॉग में सूचीबद्ध समस्याएँ ठीक कर देता, तब यह विकल्प कहता है कि वे दूर नहीं होंगी।

Tectonic को रखने के बाद, वही समस्याएँ इस कंप्यूटर पर इस प्रोजेक्ट के लिए डायलॉग नहीं खोलतीं और **Choose engine** नहीं दिखातीं। बाद में स्विच करने के लिए **Compiler (this project)** के अंतर्गत कोई कंपाइलर चुनें।

अगर प्रोजेक्ट को बाहरी कमांडें भी चलानी हैं, तो सिस्टम LaTeX या TinyTeX पर स्विच करने से वे भी चलने लगती हैं, और डायलॉग क्लिक से पहले यह बता देता है। आपका चुना कंपाइलर प्रोजेक्ट में सहेजा जाता है, इसलिए सहयोगियों को वही सेटअप मिलता है।

## बाहरी कमांड की अनुमति दें

`minted` और PythonTeX जैसे पैकेज, और `\write18` इस्तेमाल करने वाले डॉक्यूमेंट, कंपाइल होते समय दूसरे प्रोग्राम चलाते हैं। Oleafly डिफ़ॉल्ट रूप से उसे रोकता है। जब कोई कंपाइल ब्लॉक हो, या लॉग दिखाए कि प्रोजेक्ट को वे कमांडें चाहिए, तो एडिटर के ऊपर एक बैनर **Allow external commands** का विकल्प देता है।

बिल्ट-इन इंजन भी यह रोक बनाए रखता है। Tectonic प्रोजेक्ट फ़ोल्डर के बाहर से शुरू होता है, और Oleafly के साथ आने वाला Biber किसी डॉक्यूमेंट की ग्रंथसूची सेटिंग्स को सादा टेक्स्ट मानता है और कंपाइल के दौरान `biber.conf` को छोड़ देता है।

बाहरी कमांड की अनुमति केवल उस प्रोजेक्ट के लिए दें जिसकी फ़ाइलों पर आप भरोसा करते हैं, क्योंकि तब LaTeX आपकी अनुमतियों से कोई भी प्रोग्राम चला सकता है। यह अनुमति केवल सिस्टम LaTeX के साथ काम करती है, और यह इसी कंप्यूटर पर रहती है। यह कभी `project.json` में सहेजी नहीं जाती और न ही Git में कमिट होती है, इसलिए किसी सह-लेखक को उसे अपने कंप्यूटर पर खुद देना होगा। किसी [साझा प्रोजेक्ट](/docs/collaboration/) में Oleafly इसे चालू करने से पहले आपको चेतावनी देता है, क्योंकि तब प्रोजेक्ट एडिट कर सकने वाला कोई भी व्यक्ति आपके कंपाइल करने पर आपके कंप्यूटर पर प्रोग्राम चला सकता है। प्रोजेक्ट को वापस Tectonic पर स्विच करने या उसे मिटाने से यह अनुमति हट जाती है। जिस फ़ोल्डर को आपने उसी जगह खोला है, उसमें पहले फ़ोल्डर पर भरोसा करें। फ़ोल्डर पर भरोसा करने से अपने आप बाहरी कमांड की अनुमति नहीं मिल जाती।

इंजन मौजूद होने पर, [Preflight](/docs/preflight/) पैनल का **Compile tagged and verify** बटन एक ही कदम में LuaLaTeX से टैग की गई PDF बना सकता है और तुरंत उसकी जाँच कर सकता है। अपना खुद का टूलचेन पसंद है? Preflight का **Prepare for accessible export** टैगिंग के लिए आपका सोर्स फिर से लिख देता है और आप उसे ऐप के बाहर TeX Live 2026 के, या नवंबर 2025 के बाद अपडेट किए गए TeX Live के, किसी भी LuaLaTeX से कंपाइल करते हैं।

## PDF से ग़ायब अक्षर

TeX उस हर अक्षर को छोड़ देता है जिसका ग्लिफ़ उसके फ़ॉन्ट में नहीं होता, और कंपाइल फिर भी सफल रहता है। कोरियाई, चीनी या जापानी अनुच्छेद बिना किसी त्रुटि के खाली निकल सकता है। Oleafly हर कंपाइल के बाद लॉग पढ़ता है, इसलिए जब अक्षर ग़ायब होते हैं तो आपको हर प्रोजेक्ट में एक बार सूचना मिलती है, लॉग उन्हें **Missing characters** के नीचे सूचीबद्ध करता है, और चेतावनी उनमें से कुछ के नाम बताती है।

बिल्ट-इन इंजन और XeLaTeX पर, चेतावनी मिली हर लिपि के लिए एक सेटअप भी देती है, उन फ़ॉन्ट के साथ जो बिल्ट-इन इंजन के साथ आते हैं। जो चाहिए उसे प्रीएम्बल में चिपका दें:

```latex
% Korean
\usepackage[space]{xeCJK}
\setCJKmainfont[AutoFakeBold]{UnBatang.ttf}

% Simplified Chinese
\usepackage{xeCJK}
\setCJKmainfont[AutoFakeBold]{gbsn00lp.ttf}

% Traditional Chinese
\usepackage{xeCJK}
\setCJKmainfont[AutoFakeBold]{bsmi00lp.ttf}

% Japanese
\usepackage{xeCJK}
\setCJKmainfont{ipaexm.ttf}[BoldFont=ipaexg.ttf]
```

`space` विकल्प कोरियाई शब्दों के बीच की जगहें बनाए रखता है, जिन्हें सादा `xeCJK` गिरा देता है।

`CJKutf8` और `CJK` पैकेज केवल pdfLaTeX पर काम करते हैं। इन्हें बिल्ट-इन इंजन पर लोड करने वाला प्रोजेक्ट अपने चीनी, जापानी या कोरियाई टेक्स्ट के बिना कंपाइल होता है, इसलिए सूचना **Choose engine** का प्रस्ताव देती है, जो pdfLaTeX पर स्विच खोलता है। आप पैकेज और उसका `CJK` एनवायरनमेंट हटाकर ऊपर के किसी सेटअप का भी उपयोग कर सकते हैं।

Mac पर Mac के अपने फ़ॉन्ट इस्तेमाल करने वाले `ctex` डॉक्यूमेंट में macOS पूछ सकता है कि फ़ॉन्ट डाउनलोड करना है या नहीं, और कंपाइल आपके जवाब का इंतज़ार करता है। डायलॉग का जवाब देकर फिर कंपाइल करें, या `\documentclass` विकल्पों में `fontset=fandol` जोड़ें।

दूसरे ग़ायब अक्षरों के लिए, जैसे कोई प्रतीक या दूसरी लिपि का अक्षर, ऐसा फ़ॉन्ट चाहिए जिसमें वे हों। प्रीएम्बल में उसी पर स्विच करें। Typst प्रोजेक्ट के लिए [जो अक्षर बक्सों की तरह दिखते हैं](/docs/typst/#characters-that-show-as-boxes) देखें।

## पैकेज मैनेजर

इंजन स्टेटस के नीचे LuaLaTeX पक्ष के लिए `tlmgr` से चलने वाली एक फ़िल्टर करने योग्य **Packages** सूची है:

- सुझाई गई पैकेज सूची से शुरू करें, या कम से कम दो अक्षर लिखकर पूरा कैटलॉग खोजने के लिए **Search TeX Live** चुनें।
- पैकेज के नाम या उसमें मौजूद किसी फ़ाइल से खोजें। जब वे नाम अलग होते हैं, तो Oleafly मालिक TeX Live पैकेज दिखाता है।
- एक क्लिक में पैकेज **Add** या **Remove** करें। इंस्टॉल वाली पंक्तियाँ दिखाती हैं कि पैकेज सिस्टम ट्री में है, आपकी पर्सनल ट्री में, या दोनों में।
- सुलभ एक्सपोर्ट से पहले टैगिंग बैज देखें: **tagging: caution** उन पैकेजों को चिह्नित करता है जो टैग की गुणवत्ता घटा सकते हैं, जबकि **breaks tagging** ज्ञात टकरावों को चिह्नित करता है।

यह पैकेज मैनेजर `latexmk` द्वारा इस्तेमाल होने वाली TeX Live और TinyTeX डिस्ट्रिब्यूशन पर लागू होता है। Tectonic अपना पैकेज कैश खुद संभालता है। MiKTeX के लिए MiKTeX Console इस्तेमाल करें।

### किसी ग़ायब फ़ाइल से उबरें

पैकेज का नाम हमेशा कंपाइल लॉग में आई फ़ाइल के नाम पर नहीं होता। उदाहरण के लिए, `tikz.sty` को `pgf` पैकेज इंस्टॉल करता है। `tikz` नाम का अंदाज़े से चुना पैकेज इंस्टॉल करना नाकाम होगा।

जब कोई `latexmk` कंपाइल ग़ायब फ़ाइल बताए, तो संदेश में **Find and install** इस्तेमाल करें। Oleafly TeX Live से पूछता है कि फ़ाइल किस पैकेज की है, वह पैकेज इंस्टॉल करता है, और फिर से कंपाइल करता है। इसमें पैकेज, क्लास, बिब्लियोग्राफ़ी स्टाइल, फ़ॉन्ट फ़ाइलें, babel भाषा फ़ाइलें और TikZ लाइब्रेरी आती हैं। अगर किसी TeX Live पैकेज में वह फ़ाइल नहीं है, तो वह शायद आपके विश्वविद्यालय या प्रकाशक के टेम्पलेट के साथ आई थी, इसलिए उसे मूल टेम्पलेट से प्रोजेक्ट में जोड़ें। अगर कई पैकेजों में वह है, तो संदेश उन्हें सूचीबद्ध करता है ताकि आप वह चुन सकें जो आपके टेम्पलेट को चाहिए। अगर कैटलॉग तक पहुँच न हो, या इंस्टॉल से कंपाइल ठीक न हो, तो संदेश बताता है कि इनमें से क्या हुआ।

अगर आप बिना अनुमति के सिस्टम इंस्टॉलेशन बदलने की कोशिश करें, तो Oleafly उसके बजाय आपकी पर्सनल TeX ट्री में इंस्टॉल कर सकता है, और वह ट्री अभी न हो तो पहले उसे सेट अप करता है। पैकेज की पंक्ति बताती है कि वह कहाँ पहुँचा। मालिक पैकेज हटाने से वह दूसरी फ़ाइलें भी हट जाती हैं जो वह देता है, इसलिए हटाने से पहले **Included in** नोट पढ़ें।

### tlmgr और पुराने TeX Live रिलीज़ को चालू रखें

TeX Live का पैकेज मैनेजर `tlmgr` ऑनलाइन TeX Live रिपॉज़िटरी से पीछे रह सकता है, और तब वह खुद को अपडेट किए बिना कुछ भी इंस्टॉल करने से मना कर देता है। जिस TinyTeX को Oleafly प्रबंधित करता है, उसके लिए Oleafly `tlmgr` को अपडेट करता है और इंस्टॉल दोहराता है। जिस TeX Live या TinyTeX को आपने खुद इंस्टॉल किया है, उस पर संदेश आपसे `tlmgr update --self` चलाने को कहता है।

जब रिपॉज़िटरी नए TeX Live वर्ष पर चली जाती है, तो पुरानी इंस्टॉलेशन उससे इंस्टॉल नहीं कर पाती। तब Oleafly आपके रिलीज़ के अंतिम आर्काइव से इंस्टॉल करता है। अगर आर्काइव में भी वह पैकेज नहीं है, तो संदेश आपसे TeX Live अपडेट करने को कहता है, या Settings में मैनेज्ड TinyTeX पर **Update** इस्तेमाल करने को।

### पैकेज कहाँ से आएँ, यह चुनें

`tlmgr` TeX Live रिपॉज़िटरी से पैकेज इंस्टॉल करता है। Oleafly जिस TinyTeX को प्रबंधित करता है, वह निकटतम CTAN मिरर का उपयोग करता है, जब तक आप **Settings → Downloads → Sources** में **TeX package repository** के अंतर्गत कोई ख़ास रिपॉज़िटरी, जैसे अपने विश्वविद्यालय का CTAN मिरर, न चुन लें। आपके ख़ुद इंस्टॉल किए TeX Live की अपनी रिपॉज़िटरी तब तक बनी रहती है जब तक आप वहाँ कोई पता न दें। Oleafly हर रन पर वह पता `tlmgr` को देता है और उसकी सहेजी हुई कॉन्फ़िगरेशन कभी नहीं बदलता।

जिस पैकेज खोज को रिपॉज़िटरी तक पहुँचना पड़ता है, उसमें धीमे कनेक्शन पर समय लग सकता है। Oleafly 10 मिनट तक इंतज़ार करता है, और अगर वह हार मान ले, तो संदेश उस रिपॉज़िटरी का नाम बताता है जिसका वह इंतज़ार कर रहा था। देखें [Sources टैब](/docs/settings/downloads/#sources-tab)।

### Linux डिस्ट्रिब्यूशन का TeX Live

Debian, Ubuntu और Fedora पर TeX Live सिस्टम के पैकेज मैनेजर से आता है, इसलिए Oleafly उसमें पैकेज नहीं जोड़ता। **Packages** सूची `apt` या `dnf` इस्तेमाल करने को कहती है, और ग़ायब फ़ाइल पर **Find and install** के बजाय संकेत वाली सूचना मिलती है:

- Debian और Ubuntu पर, `apt-file search` और फ़ाइल के नाम से पैकेज ढूँढें, या `sudo apt install texlive-full` से सब कुछ इंस्टॉल करें।
- Fedora पर सूचना ग़ायब फ़ाइल के लिए `sudo dnf install 'tex(file.sty)'` कमांड देती है।

जब डिस्ट्रिब्यूशन का TeX अधूरा हो, तो सूचना **Download TinyTeX (~250 MB)** का भी प्रस्ताव देती है, जिसके पैकेज Oleafly प्रबंधित कर सकता है। Debian और Ubuntu पर, अगर आपने `tlmgr init-usertree` से पर्सनल ट्री सेट की है, तो Oleafly पैकेज उसी ट्री में इंस्टॉल करता है।

## एडिटर से पैकेज जोड़ें

**LaTeX packages** चुनें, LaTeX एडिटर टूलबार पर बना पैकेज आइकन, डॉक्यूमेंट छोड़े बिना CTAN खोजने के लिए। हर परिणाम दिखाता है कि डॉक्यूमेंट उसे पहले से लोड करता है या नहीं (**In document**)। `latexmk` प्रोजेक्ट में वह यह भी दिखाता है कि आपकी TeX डिस्ट्रिब्यूशन में वह है या नहीं (**Installed**), और **Install** ग़ायब पैकेज को `tlmgr` से जोड़ देता है। Linux डिस्ट्रिब्यूशन के TeX Live के साथ डायलॉग इसके बजाय `apt` या `dnf` से पैकेज इंस्टॉल करने को कहता है।

**Add to preamble** प्रीएम्बल में `\usepackage` पंक्ति लिख देता है। **Options** आपको पहले पैकेज विकल्प जोड़ने देता है, और **Copy line** उसके बजाय पंक्ति कॉपी कर देता है। Tectonic प्रोजेक्ट में इंस्टॉल करने को कुछ नहीं होता: Tectonic पहली बार डॉक्यूमेंट के इस्तेमाल करने पर पैकेज डाउनलोड कर लेता है।

## मेरी PDF किस इंजन से कंपाइल हुई?

- कंपाइल मेन्यू में, **Recompile** के बगल के तीर पर, **Compiler (this project)** मौजूदा प्रोजेक्ट के लिए सहेजा गया कंपाइलर दिखाता है।
- Tectonic बिल्ड बंडल किए गए इंजन का इस्तेमाल करते हैं।
- pdfLaTeX, XeLaTeX, LuaLaTeX, upLaTeX और pLaTeX बिल्ड `latexmk` और Settings में **In use** चिह्नित TeX डिस्ट्रिब्यूशन इस्तेमाल करते हैं।
- Preflight का टैग किया गया एक्सपोर्ट LuaLaTeX इस्तेमाल करता है और सामान्य बिल्ड स्थान पर लिखता है।

## टेम्पलेट और पैकेज

टेम्पलेट अपनी ज़रूरत के पैकेज घोषित करते हैं, और Tectonic पहली कंपाइल पर उन्हें ले आता है। माँग पर फ़ॉन्ट वाले टेम्पलेट उन्हें अलग से संभालते हैं। [टेम्पलेट](/docs/templates/#on-demand-fonts-the-setup-badge) देखें।
