# सामान्य प्रश्न और समस्या-निवारण

शुरुआत करने, प्रोजेक्ट, कंपाइलेशन, सहायकों और बैकअप से जुड़े त्वरित उत्तर।

## शुरुआत

### क्या मुझे खाते की ज़रूरत है?

नहीं। Oleafly डाउनलोड करें, खोलें और लिखना शुरू करें। क्लाउड AI प्रदाता, GitHub या Dropbox जैसी वैकल्पिक सेवाएँ अपने खुद के खाते उपयोग करती हैं।

### क्या Oleafly, LaTeX, Typst और Markdown का समर्थन करता है?

हाँ। प्रोजेक्ट बनाते समय इंजन चुनें। प्रत्येक इंजन की अपनी संपादन और निर्यात क्षमताएँ हैं। [क्विकस्टार्ट](/docs/getting-started/) आपका पहला PDF बनाने की पूरी प्रक्रिया समझाता है।

### क्या मैं कोई मौजूदा शोध-पत्र या रिज़्यूमे ला सकता हूँ?

हाँ। प्रोजेक्ट स्रोत, ZIP संग्रह या Git रिपॉज़िटरी आयात करें। Oleafly में DOCX और पाठ-आधारित PDF के लिए भी रूपांतरण मार्ग हैं। सही मार्ग चुनने के लिए [मौजूदा प्रोजेक्ट लाएँ](/docs/import-project/) पढ़ें।

### क्या मैं ऑफ़लाइन काम कर सकता हूँ?

आप बिना क्लाउड कनेक्शन के लिख सकते हैं, फ़ाइलें व्यवस्थित कर सकते हैं, स्थानीय प्रूफ़रीडिंग का उपयोग कर सकते हैं और डाउनलोड किए गए स्थानीय AI मॉडल को चला सकते हैं। Tectonic कैश किए गए पैकेजों से कंपाइल कर सकता है। नए पैकेज, दूरस्थ संदर्भ, क्लाउड मॉडल, GitHub और डाउनलोड के लिए कनेक्शन चाहिए। प्रोजेक्ट को ऑफ़लाइन ले जाने से पहले उसे एक सफल कंपाइल के साथ तैयार कर लें।

### मेरी फ़ाइलें कहाँ हैं?

आपके प्रोजेक्ट आपकी स्थानीय लाइब्रेरी में सामान्य फ़ोल्डर हैं। आप उन्हें कॉपी कर सकते हैं, उनका बैकअप ले सकते हैं, या किसी दूसरे टूल में खोल सकते हैं। [आपका डेटा कहाँ रहता है](/docs/where-your-data-lives/) प्रोजेक्ट फ़ाइलों, ऐप सेटिंग्स और चेकपॉइंट को समझाता है।

### क्या मैं Oleafly का उपयोग थीसिस या रिज़्यूमे के लिए कर सकता हूँ?

हाँ। [थीसिस कार्यप्रवाह](/docs/workflows/thesis/) या [रिज़्यूमे कार्यप्रवाह](/docs/workflows/resume/) से शुरू करें। दोनों शोध-पत्र की तरह ही संपादक, पूर्वावलोकन, संदर्भ और निर्यात टूल उपयोग करते हैं।

## स्थापना

### ऑपरेटिंग सिस्टम इंस्टॉलर को रोक देता है

जाँचें कि फ़ाइल [आधिकारिक रिलीज़](https://github.com/Oleafly/Oleafly/releases/latest) से आई है और आपके प्लेटफ़ॉर्म से मेल खाती है। प्लेटफ़ॉर्म के पहले-लॉन्च चरणों के लिए [स्थापना गाइड](/docs/install/#first-launch) देखें।

### मुझे कौन सा Linux पैकेज उपयोग करना चाहिए?

अपने कंप्यूटर से मेल खाता आर्किटेक्चर चुनें और AppImage, Debian पैकेज या RPM में से कोई एक। सिस्टम आवश्यकताओं के लिए [Linux स्थापना](/docs/install/#linux) देखें।

## कंपाइल करना

### मेरा पहला कंपाइल धीमा है

Tectonic को इस दस्तावेज़ द्वारा उपयोग किए जाने वाले पैकेज डाउनलोड करने पड़ सकते हैं, और किसी कंप्यूटर पर पहला कंपाइल आम पैकेजों का एक जत्था भी ले आता है। वे बाद के बिल्ड के लिए कैश हो जाते हैं। जब तक पैकेज डाउनलोड हो रहे हों, कंपाइल अपनी सामान्य पाँच मिनट की सीमा से आगे चल सकता है। क्या हो रहा है, यह देखने के लिए [Logs](/docs/compiling/#reading-the-logs) खोलें।

### कोई पैकेज गायब है

यदि Offline mode चालू है, तो संदेश में **Turn off and compile** चुनें, या पैकेज लाने के लिए एक कंपाइल के लिए उसे बंद कर दें। सिस्टम TeX टूलचेन पर त्रुटि में **Find and install** का उपयोग करें। Debian, Ubuntu या Fedora का TeX Live अपने पैकेज `apt` या `dnf` से लेता है। देखें [LaTeX इंजन और पैकेज](/docs/latex-engines/#recover-from-a-missing-file)।

### मैंने pdfLaTeX चुना और Oleafly TeX डिस्ट्रिब्यूशन माँगता है

pdfLaTeX, XeLaTeX, LuaLaTeX, upLaTeX और pLaTeX आपके कंप्यूटर पर इंस्टॉल TeX डिस्ट्रिब्यूशन पर चलते हैं। जब कोई नहीं होता, तो इनमें से कोई चुनने पर कुछ भी कंपाइल होने से पहले एक डायलॉग खुलता है। इंस्टॉल करने के लिए **Download and use TinyTeX** चुनें, या बिल्ट-इन इंजन पर लौटने के लिए **Switch back to Tectonic**। कंपाइल विफल होने के बाद प्रीव्यू यही विकल्प **Download and use TinyTeX** और **Use Tectonic** के रूप में देता है। देखें [जब कोई TeX इंस्टॉल न हो](/docs/latex-engines/#when-no-tex-is-installed)।

### MiKTeX कहता है कि latexmk को Perl चाहिए

MiKTeX का `latexmk` Perl पर चलता है, जिसे MiKTeX साथ नहीं लाता। Strawberry Perl इंस्टॉल करें, या **Settings → Engines → LaTeX** से TinyTeX इंस्टॉल करें, जो अपना Perl साथ लाता है और MiKTeX से कंपाइल का काम ले लेता है। देखें [MiKTeX और Perl](/docs/latex-engines/#miktex-and-perl)।

### मेरी PDF से टेक्स्ट ग़ायब है

फ़ॉन्ट में उन अक्षरों के ग्लिफ़ नहीं हैं। ऐसा सबसे ज़्यादा कोरियाई, चीनी और जापानी टेक्स्ट के साथ होता है, और TeX कंपाइल को विफल किए बिना उन अक्षरों को छोड़ देता है। Oleafly आपको चेतावनी देता है और उन्हें लॉग में सूचीबद्ध करता है। LaTeX में, अपनी लिपि के लिए चेतावनी जो सेटअप देती है उसे चिपका दें। Typst में, सूचना जो फ़ॉन्ट पैक देती है उसे डाउनलोड करें, या ऐसा फ़ॉन्ट जिसमें वे अक्षर हों, प्रोजेक्ट के `fonts` फ़ोल्डर में जोड़ें। Markdown में, YAML हेडर में `mainfont` या `CJKmainfont` को ऐसे फ़ॉन्ट पर सेट करें जिसमें वे हों। देखें [PDF से ग़ायब अक्षर](/docs/latex-engines/#characters-missing-from-the-pdf) और [जो अक्षर बक्सों की तरह दिखते हैं](/docs/typst/#characters-that-show-as-boxes)।

### Oleafly ने बहुत देर लगने पर मेरा कंपाइल रोक दिया

एक कंपाइल 5 मिनट तक चल सकता है। जब तक पैकेज डाउनलोड हो रहे हों, सीमा 30 मिनट तक खिंच जाती है। Markdown से PDF को 15 मिनट मिलते हैं, और Quarto तथा Calepin को एक घंटा। फिर से कंपाइल करें: डाउनलोड वहीं से आगे बढ़ता है जहाँ रुका था। Tectonic पर लंबे ड्राफ़्ट के लिए कंपाइल मेन्यू में **Compile mode** को **Fast** पर सेट करें।

### क्या नए प्रोजेक्ट मेरी अपनी TeX स्थापना उपयोग कर सकते हैं?

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

### मेरा दस्तावेज़ minted या PythonTeX उपयोग करता है

ये पैकेज दस्तावेज़ के कंपाइल के दौरान अन्य प्रोग्राम चलाते हैं, जिसे Oleafly डिफ़ॉल्ट रूप से रोकता है। इन्हें सिस्टम LaTeX चाहिए। यदि आप प्रोजेक्ट की हर फ़ाइल पर भरोसा करते हैं, तो संपादक के ऊपर बैनर में **Allow external commands** चुनें। [बाहरी कमांड की अनुमति दें](/docs/latex-engines/#allow-external-commands) देखें।

### कंपाइल चेतावनियों के साथ पूरा हुआ

**Logs** खोलें और सबसे पहले अपरिभाषित उद्धरण और संदर्भ जाँचें। निर्यात से पहले [Preflight](/docs/preflight/) प्रभावित स्रोत स्थान खोजने में मदद करता है।

### मुझे एक बिल्ड त्रुटि समझ नहीं आती

सहायक से कहें कि वह लॉग पढ़े, त्रुटि ठीक करे और फिर से कंपाइल करे। जब आप रास्ते में प्रस्तावित क्रियाओं की समीक्षा करना चाहें, तो **Ask for approval** का उपयोग करें। आप लॉग को [Discord](/discord) के सहायता फ़ोरम में भी पोस्ट कर सकते हैं।

### कोई निर्यात प्रारूप क्यों गायब है?

उपलब्ध प्रारूप इंजन और दस्तावेज़ प्रकार पर निर्भर करते हैं। [निर्यात तालिका](/docs/export/#editable-formats) देखें।

## AI सहायक

### मैं कौन सा सहायक उपयोग कर सकता हूँ?

कोई मॉडल प्रदाता जोड़ें, स्थानीय मॉडल का उपयोग करें, या कोई [CLI एजेंट](/docs/cli-agents/) चुनें। [AI सेटअप](/docs/ai-setup/) हर मार्ग समझाता है।

### क्या संपादक उपयोग करने के लिए मुझे AI चाहिए?

नहीं। लेखन, कंपाइलेशन, उद्धरण, पूर्वावलोकन, आरेख, प्रोजेक्ट इतिहास और निर्यात बिना सहायक के उपलब्ध हैं।

### सहायक क्या कर सकता है?

यह प्रोजेक्ट फ़ाइलों के साथ काम कर सकता है, स्रोत खोज सकता है, PDF की जाँच कर सकता है, आकृतियाँ बना सकता है, टूल चला सकता है और बिल्ड की मरम्मत में मदद कर सकता है। काम के अनुसार योजना और अनुमोदन नीति चुनें। [चैट और टूल](/docs/ai-chat/) देखें।

### किसी मॉडल के बगल में Verified का क्या अर्थ है?

मॉडल एक टूल-कॉल जाँच में उत्तीर्ण हुआ है। यह आपको प्रोजेक्ट क्रियाओं के लिए मॉडल चुनने में मदद करता है; यह उसके लेखन या शोध की गुणवत्ता का मूल्यांकन नहीं करता। [AI सेटअप](/docs/ai-setup/) देखें।

### उपयोग Unknown क्यों दिखता है?

कुछ प्रदाता और CLI एजेंट उपयोग की सूचना नहीं देते। Unknown का अर्थ है कि मान उपलब्ध नहीं है। [उपयोग और बजट](/docs/ai-usage/) पढ़ें।

### क्या मैं कोई बाहरी सहायक जोड़ सकता हूँ?

हाँ। अंतर्निहित [CLI एजेंट कनेक्शन](/docs/cli-agents/) उपयोग करें, Oleafly का स्थानीय [MCP सर्वर](/docs/mcp/) सक्रिय करें, या अपने एजेंट को [`oleafly` कमांड](/docs/cli/) से कनेक्ट करें, जो ऐप बंद होने पर भी काम करता है।

## इतिहास और सहयोग

### मैं कोई पुराना संस्करण कैसे पुनर्प्राप्त करूँ?

[Checkpoints](/docs/checkpoints/) खोलकर सफल बिल्ड के स्रोत की तुलना करें और कोई संस्करण पुनर्स्थापित करें। जिन Git कमिट का प्रबंधन आप खुद करते हैं, उनके लिए [Source Control](/docs/git-history/) उपयोग करें।

### क्या मैं किसी सह-लेखक के साथ काम कर सकता हूँ?

हाँ। [लाइव सहयोग](/docs/collaboration/) के साथ, आप और आपके सह-लेखक आपके समूह द्वारा चलाए जाने वाले सहयोग सर्वर के माध्यम से एक ही प्रोजेक्ट को एक ही समय पर संपादित करते हैं। आप में से हर एक के पास प्रोजेक्ट अपने ही कंप्यूटर पर फ़ाइलों के रूप में रहता है। आप स्रोत संग्रह साझा भी कर सकते हैं या कमिट का आदान-प्रदान करने के लिए [GitHub सिंक](/docs/github-sync/) उपयोग कर सकते हैं।

### क्या मैं अपने प्रोजेक्ट दो कंप्यूटरों पर उपयोग कर सकता हूँ?

हाँ। [क्लाउड सिंक](/docs/cloud-sync/) आपकी लाइब्रेरी के प्रोजेक्ट और सेटिंग्स आपके ही Dropbox में रखता है, और आपके द्वारा जोड़ा गया हर कंप्यूटर उन्हें डाउनलोड कर सकता है। इसे कनेक्ट करने के लिए **Settings → Data Storage → Cloud sync** खोलें। आप [GitHub सिंक](/docs/github-sync/) से प्रोजेक्ट को कंप्यूटरों के बीच ले भी जा सकते हैं।

### क्या स्रोत निर्यात करना सब कुछ बैकअप ले लेता है?

यह प्रोजेक्ट स्रोत का बैकअप लेता है। स्वचालित चेकपॉइंट, ऐप प्राथमिकताएँ और क्रेडेंशियल अलग रहते हैं। जो कुछ चाहिए वह शामिल करने के लिए [बैकअप गाइड](/docs/where-your-data-lives/#back-up-your-work) का पालन करें।

## समस्या की सूचना दें

**Settings → Help & About → Copy Info** खोलें और उन विवरणों के साथ एक छोटा विवरण, समस्या को दोहराने के चरण और संबंधित लॉग शामिल करें। इसे [Issues](https://github.com/Oleafly/Oleafly/issues) में रिपोर्ट करें; प्रश्नों और कार्यप्रवाह सहायता के लिए [Discord समुदाय](/discord) उपयोग करें।
