# पैकेज

CTAN पर LaTeX पैकेज और Typst Universe पर Typst पैकेज खोजें, फिर एडिटर टूलबार से अपने दस्तावेज़ में एक जोड़ें।

LaTeX और Typst दस्तावेज़ों की ज़्यादातर अतिरिक्त सुविधाएँ पैकेजों से आती हैं। एडिटर टूलबार के दाएँ सिरे का पैकेज बटन प्रोजेक्ट की भाषा के लिए एक खोजयोग्य सूची खोलता है और पैकेज लोड करने वाली पंक्ति आपके लिए लिख देता है। Markdown प्रोजेक्ट में कोई पैकेज बटन नहीं होता।

आप यह सूची ⌘K पैलेट से **Browse LaTeX packages** या **Browse Typst packages** से भी खोल सकते हैं।

## LaTeX पैकेज

LaTeX प्रोजेक्ट में **LaTeX packages** चुनें। CTAN को पैकेज नाम या विवरण से खोजें। अगर CTAN तक नहीं पहुँचा जा सकता, या आप ऑफ़लाइन हैं, तो डायलॉग यह बता देता है और उसकी जगह Oleafly की बिल्ट-इन सूची दिखाता है। जो सूची रिफ़्रेश नहीं हो सकी हो, वह अपने डाउनलोड होने की तारीख़ दिखाती है।

हर पंक्ति पर ये लेबल दिख सकते हैं:

- **In document**: मुख्य फ़ाइल यह पैकेज पहले से लोड करती है।
- **Document class**: यह प्रविष्टि क्लास है, पैकेज नहीं। क्लास `\documentclass` से सेट होते हैं, इसलिए यह पंक्ति आपको वह पंक्ति कॉपी करने देती है, जोड़ने नहीं।
- **Installed**: आपके TeX डिस्ट्रिब्यूशन में यह पैकेज पहले से मौजूद है।

हर पंक्ति में ये नियंत्रण भी होते हैं:

- **Options**, पैकेज विकल्पों के लिए फ़ील्ड, जैसे `margin=2cm`। ब्रेसेज़ का मेल ज़रूरी है, और `]` या `%` उपयोग नहीं किया जा सकता।
- **Add to preamble**, जो मुख्य फ़ाइल के प्रीएम्बल में `\usepackage[options]{name}` लिखता है। अगर फ़ाइल पहले से पैकेज लोड करती है, तो कुछ नहीं बदलता और डायलॉग आपको बता देता है।
- **Copy line**, जो वही `\usepackage` पंक्ति कॉपी करता है, या क्लास के लिए `\documentclass` पंक्ति।
- **CTAN**, जो CTAN पर पैकेज का पेज खोलता है।
- **Install**, उस पैकेज के लिए जो आपके TeX डिस्ट्रिब्यूशन में गायब है। नीचे देखें।

### LaTeX पैकेज इंस्टॉल करना

"इंस्टॉल" होने का मतलब इस बात पर निर्भर करता है कि प्रोजेक्ट कैसे कंपाइल होता है:

- **Tectonic**, बिल्ट-इन कंपाइलर, पहली बार जब आपका दस्तावेज़ किसी पैकेज का उपयोग करता है तो उसे डाउनलोड कर लेता है। इंस्टॉल करने को कुछ नहीं है, और डायलॉग यह ऊपर ही बता देता है।
- **latexmk के साथ TeX Live या TinyTeX**: जब आपके TeX डिस्ट्रिब्यूशन में `tlmgr` हो, तो Oleafly जाँचता है कि आपके पास कौन से पैकेज हैं, उन्हें **Installed** चिह्नित करता है, और बाक़ी के लिए **Install** देता है। Install उस एक पैकेज के लिए `tlmgr` चलाता है।
- **Debian, Ubuntu या Fedora का TeX Live**: सिस्टम पैकेज मैनेजर उसका मालिक है, इसलिए डायलॉग `apt` या `dnf` से पैकेज इंस्टॉल करने को कहता है और उसमें **Install** बटन नहीं होता।
- **अन्य TeX सेटअप**, जैसे MiKTeX: Oleafly नहीं बता सकता कि कौन से पैकेज मौजूद हैं, इसलिए पंक्तियाँ कोई इंस्टॉल स्थिति नहीं दिखातीं। MiKTeX के लिए MiKTeX Console इस्तेमाल करें।

TeX Live या TinyTeX के साथ, जो कंपाइल किसी फ़ाइल को नहीं ढूँढ पाता, वह त्रुटि में **Find and install** देता है, जो पता लगाता है कि वह फ़ाइल किस पैकेज की है। देखें [किसी ग़ायब फ़ाइल से उबरें](/docs/latex-engines/#recover-from-a-missing-file)।

**Recompile** के बगल के तीर से कंपाइलर चुनें। देखें [LaTeX इंजन](/docs/latex-engines/)।

## Typst पैकेज

Typst प्रोजेक्ट में Typst Universe ब्राउज़ करने के लिए **Typst packages** चुनें। नाम, कीवर्ड या श्रेणी से खोजें, या श्रेणी चिप से सूची संकुचित करें। डायलॉग एक बार में 100 तक पैकेज दिखाता है, इसलिए सूची लंबी होने पर खोजें।

हर पंक्ति पैकेज का नाम, उसका नवीनतम संस्करण, टेम्पलेट पैकेजों के लिए **Template** बैज और एक छोटा विवरण दिखाती है। जब किसी पैकेज को प्रोजेक्ट से नए Typst की ज़रूरत हो, तो पंक्ति बताती है कि उसे कौन सा संस्करण चाहिए।

- **Insert import** खुली `.typ` फ़ाइल के ऊपर के इंपोर्ट के बाद `#import "@preview/name:version": *` जोड़ता है। अगर फ़ाइल वह पैकेज पहले से इंपोर्ट करती है, तो केवल संस्करण संख्या बदलती है। एडिटर में कोई Typst फ़ाइल खुली होनी चाहिए।
- **Copy import** वही पंक्ति कॉपी करता है।

### अपडेट संकेत

जब आपकी फ़ाइल का कोई `@preview` इंपोर्ट Typst Universe के नवीनतम रिलीज़ से पुराना हो, तो एडिटर संस्करण को एक संकेत से चिह्नित करता है, जैसे "cetz 0.4.2 is available. This import uses 0.3.4."। संकेत की **Update to 0.4.2** कार्रवाई संख्या को उसी जगह बदल देती है।

### पैकेजों को प्रोजेक्ट के साथ रखना

Typst किसी प्रोजेक्ट के पहले इंपोर्ट पर पैकेजों को एक साझा कैश में डाउनलोड करता है। किसी प्रोजेक्ट को उसकी अपनी प्रतियाँ देने के लिए, डायलॉग के नीचे दिए **Project packages** का उपयोग करें:

- **Use packages from the project folder** Typst को सबसे पहले प्रोजेक्ट के `typst-packages` फ़ोल्डर में देखने देता है। इस तरह सेटअप किया प्रोजेक्ट ऑफ़लाइन और दूसरे कंप्यूटरों पर कंपाइल होता है।
- **Vendor packages into project** प्रोजेक्ट द्वारा इंपोर्ट किए हर पैकेज को कैश से `typst-packages` में कॉपी करता है। अगर कोई पैकेज अभी कैश में नहीं है, तो ऑनलाइन होकर एक बार कंपाइल करें, फिर दोबारा वेंडर करें।

दोनों को Typst 0.12 या नया चाहिए। Typst 0.11 पर पिन किए गए प्रोजेक्ट में यह अनुभाग यही बताता है।

यह अनुभाग यह भी दिखाता है कि प्रोजेक्ट के पास कितने पैकेज हैं।

### ऑफ़लाइन

Offline mode चालू होने पर डायलॉग पिछली बार डाउनलोड की गई पैकेज सूची का उपयोग करता है और उसकी तारीख़ दिखाता है। अगर कभी कोई सूची डाउनलोड नहीं हुई है, तो ऑनलाइन होने तक वह कोई सूची नहीं दिखा सकता।

## संबंधित पेज

- [एडिटर](/docs/editor/#the-editor-toolbar): एडिटर टूलबार का बाक़ी हिस्सा
- [कंपाइल करना](/docs/compiling/): बिल्ड के दौरान पैकेज कैसे फ़ेच होते हैं
- [दस्तावेज़ सेटिंग](/docs/document-settings/): पैकेज कोड लिखे बिना पेपर का आकार, मार्जिन और फ़ॉन्ट
