# डाउनलोड और इंस्टॉल

macOS, Windows या Linux पर Oleafly इंस्टॉल करें, और जानें कि पहली बार इस्तेमाल पर ऐप क्या डाउनलोड कर सकता है।

Oleafly इंस्टॉल करना बस एक डाउनलोड और एक डबल-क्लिक है। न कोई खाता, न साइन-इन, और न कोई अलग LaTeX डिस्ट्रिब्यूशन: कंपाइलर ऐप के भीतर ही आता है।

## ऐप डाउनलोड करें

नवीनतम इंस्टॉलर [रिलीज़ पेज](https://github.com/Oleafly/Oleafly/releases/latest) से लें, या [oleafly.com](https://oleafly.com/) का Download बटन इस्तेमाल करें, जो संभव होने पर आपके प्लेटफ़ॉर्म का इंस्टॉलर खुद चुन लेता है।

| प्लेटफ़ॉर्म | डाउनलोड | क्या करें |
|---|---|---|
| macOS (Apple Silicon) | `_aarch64.dmg` | M1 या नया। dmg खोलें और Oleafly को Applications में खींचें। |
| macOS (Intel) | `_x64.dmg` | Intel Mac। dmg खोलें और Oleafly को Applications में खींचें। |
| Windows (x86_64) | `.msi` या `-setup.exe` | कोई भी इंस्टॉलर चलाएँ और निर्देशों का पालन करें। |
| Linux (x86_64) | `.AppImage`, `.deb` या `.rpm` | ज़्यादातर डिस्ट्रिब्यूशन पर AppImage इस्तेमाल करें, Debian-आधारित सिस्टम पर Debian पैकेज, या Fedora पर RPM। |
| Linux (ARM64) | `.AppImage`, `.deb` या `.rpm` | ARM64 Linux सिस्टम के लिए नेटिव पैकेज। |

Linux पर Oleafly को glibc 2.35 या नया चाहिए (2022 के दौर का या उसके बाद का: Ubuntu 22.04+, Fedora 36+, Debian 12+)।

पक्का नहीं है कि आपके पास कौन सा Mac है? Apple मेनू खोलें और **इस Mac का परिचय** चुनें। **चिप** वाली लाइन का मतलब Apple Silicon है, और **प्रोसेसर** वाली लाइन में Intel का नाम हो तो वह Intel Mac है।

फ़िलहाल ये प्लेटफ़ॉर्म उपलब्ध कराए जाते हैं: **macOS Apple Silicon**, **macOS Intel**, **Windows x64**, **Linux x64** और **Linux ARM64**। Windows on ARM के लिए अभी नेटिव पैकेज नहीं है।

## पहली बार चलाना

### macOS

डिस्क इमेज खोलें, Oleafly को Applications में खींचें, फिर उसे चलाएँ। आधिकारिक इंस्टॉलर ही इस्तेमाल करें। अगर macOS उसे रोक दे, तो पहली बार चलाने के संदेश के लिए **System Settings → Privacy & Security** देखें।

### Windows

MSI या सेटअप एक्ज़ीक्यूटेबल चलाएँ और इंस्टॉलर के निर्देशों का पालन करें। अगर Windows प्रतिष्ठा की चेतावनी दिखाए, तो आगे बढ़ने से पहले जाँच लें कि डाउनलोड आधिकारिक रिलीज़ से आया है। Typst और LaTeX लैंग्वेज सर्वर को जो Microsoft Visual C++ रनटाइम फ़ाइल चाहिए, इंस्टॉलर उसे ऐप के बगल में रख देता है, इसलिए आपको उसे अलग से इंस्टॉल नहीं करना पड़ता।

### Linux

Debian या RPM पैकेज को अपने पैकेज मैनेजर से इस्तेमाल करें, या AppImage को एक्ज़ीक्यूटेबल बनाकर खोलें:

```bash
chmod +x Oleafly_*.AppImage
./Oleafly_*.AppImage
```

Oleafly को glibc 2.35 या नया चाहिए। अपने कंप्यूटर के आर्किटेक्चर के लिए पैकेज चुनें।

`.deb` और `.rpm` पैकेज Oleafly के अपने Tectonic, Pandoc और Typst को `/usr/libexec/oleafly` में रखते हैं, इसलिए वे आपकी डिस्ट्रिब्यूशन के Pandoc के बगल में इंस्टॉल हो जाते हैं। AppImage चलाने पर वह ख़ुद को आपके एप्लिकेशन मेन्यू में जोड़ लेता है, जिसकी ज़रूरत GNOME जैसे Wayland डेस्कटॉप को डॉक में उसका आइकन दिखाने से पहले होती है। अगर किसी इंस्टॉल किए पैकेज या किसी दूसरे टूल ने Oleafly को पहले ही जोड़ दिया है, तो वह मेन्यू को नहीं छेड़ता, और आप प्रविष्टि मिटा दें तो वह मिटी ही रहती है।

Debian पैकेज में एक विवरण है, इसलिए Ubuntu का App Center इंस्टॉल करने से पहले ही दिखा देता है कि Oleafly क्या है। उसमें AppStream डेटा भी है, इसलिए Oleafly इंस्टॉल होने के बाद सॉफ़्टवेयर सेंटर आइकन, लाइसेंस, स्क्रीनशॉट और संस्करण दिखाते हैं। ऐप आपके ऐप मेन्यू में Office के अंतर्गत दिखता है। Linux पर, Windows की तरह ही, Oleafly अपना टाइटल बार खुद बनाता है। उसका टूलबार सबसे ऊपर रहता है, जिसमें मिनिमाइज़, मैक्सिमाइज़ और बंद करने के बटन होते हैं। विंडो को हिलाने के लिए टूलबार को खींचें, मैक्सिमाइज़ करने के लिए उस पर डबल-क्लिक करें, और आकार बदलने के लिए किसी भी किनारे या कोने को खींचें।

## पहला कंपाइल TeX पैकेज डाउनलोड करता है

बंडल किए गए Tectonic इंजन पर जब आप पहली बार कोई दस्तावेज़ कंपाइल करते हैं, तो वह उन पैकेजों को डाउनलोड करके कैश कर लेता है जो उस दस्तावेज़ को चाहिए। किसी कंप्यूटर पर पहला कंपाइल आम तौर पर इस्तेमाल होने वाले पैकेजों का एक जत्था भी एक साथ ले आता है, ताकि बाद के दस्तावेज़ तेज़ी से शुरू हों। इसके लिए नेटवर्क कनेक्शन चाहिए और धीमी लाइन पर कुछ मिनट लग सकते हैं। पैकेज आते रहने तक कंपाइल की समय-सीमा रुकी रहती है, और अगर Oleafly का पैकेज मिरर विफल हो जाए, तो कंपाइल अपस्ट्रीम स्रोत पर लौट आता है। उसी दस्तावेज़ के बाद के कंपाइल तेज़ होते हैं और ऑफ़लाइन भी चलते हैं। जिस दस्तावेज़ को ऐसा पैकेज चाहिए जो आपने अभी कैश नहीं किया है, वह एक और बार एकबारगी फ़ेच शुरू करता है। सख़्त ऑफ़लाइन मोड समेत [कंपाइल करना](/docs/compiling/) देखें।

## वैकल्पिक: TeX डिस्ट्रिब्यूशन

ज़्यादातर दस्तावेज़ों के लिए Tectonic काफ़ी है। जब किसी प्रोजेक्ट को pdfLaTeX, upLaTeX या पूरे TeX डिस्ट्रिब्यूशन का कोई दूसरा कंपाइलर चाहिए, तो Oleafly आपके कंप्यूटर पर पहले से मौजूद MacTeX, TeX Live, MiKTeX या TinyTeX इस्तेमाल करता है। अगर कोई नहीं है, तो वह **Settings → Engines → LaTeX** से, या सीधे कंपाइल त्रुटि से, आपके लिए TinyTeX इंस्टॉल कर सकता है। TinyTeX को एडमिनिस्ट्रेटर अधिकार नहीं चाहिए, डाउनलोड लगभग 250 MB का है, और Oleafly लगभग 2 GB खाली डिस्क जगह माँगता है।

- Linux पर TinyTeX सिस्टम का Perl इस्तेमाल करता है। वह न हो तो पहले उसे इंस्टॉल करें: `sudo apt install perl`, `sudo dnf install perl` या `sudo pacman -S perl`।
- Windows पर MiKTeX को `latexmk` चलाने के लिए Perl चाहिए। Strawberry Perl इंस्टॉल करें, या TinyTeX इंस्टॉल करें, जो अपना Perl साथ लाता है।
- Debian, Ubuntu और Fedora पर, `apt` या `dnf` से इंस्टॉल किए TeX Live के LaTeX पैकेज भी `apt` या `dnf` से ही आते हैं। Oleafly बताता है कि क्या इंस्टॉल करना है, पर उसे बदलता नहीं।

देखें [LaTeX इंजन और पैकेज](/docs/latex-engines/#latexmk-and-system-tex)।

आपकी फ़ाइलें डिस्क पर सादे फ़ोल्डरों के रूप में रहती हैं। टोकन और AI कुंजियाँ एन्क्रिप्ट की गई, केवल मालिक के लिए सीमित लोकल फ़ाइलों में रहती हैं। ऑनलाइन सुविधाओं में होस्टेड AI, GitHub सिंक, पैकेज डाउनलोड, उद्धरण लुकअप और अपडेट जाँच शामिल हैं। [दर्शन](/docs/philosophy/) देखें।

## अपडेट रखना

Oleafly एक हस्ताक्षरित रिलीज़ फ़ीड जाँचता है, रिलीज़ नोट्स दिखाता है और आपके पुष्टि करने पर उसी जगह इंस्टॉल कर देता है। Linux पर स्वचालित प्रतिस्थापन AppImage इंस्टॉल के लिए काम करता है। आप **Settings → Help & About** से भी जाँच सकते हैं। [अपडेट](/docs/updates/) देखें।

## सोर्स से बनाएँ

पूर्वापेक्षाओं, इंजन डाउनलोड और लोकल बिल्ड के लिए [डेस्कटॉप डेवलपमेंट गाइड](https://github.com/Oleafly/Oleafly/blob/main/docs/development.md) का पालन करें।

## अगले कदम

- [क्विकस्टार्ट](/docs/getting-started/): पहले प्रोजेक्ट से पहली PDF तक, कुछ ही मिनटों में।
- [टेम्पलेट](/docs/templates/): बंडल किए गए स्टार्टर और डाउनलोड योग्य पैक।
- [Oleafly Learn](/learn/): वेब पर मुफ़्त LaTeX और शोध लेखन पाठ्यक्रम।
- [कमांड-लाइन टूल](/docs/cli/): टर्मिनल से प्रोजेक्ट बिल्ड, जाँच और सिंक करें, और कोडिंग एजेंट कनेक्ट करें।
