दस्तावेज़ टूल
पैकेज
CTAN पर LaTeX पैकेज और Typst Universe पर Typst पैकेज खोजें, फिर एडिटर टूलबार से अपने दस्तावेज़ में एक जोड़ें।
LaTeX और Typst दस्तावेज़ों की ज़्यादातर अतिरिक्त सुविधाएँ पैकेजों से आती हैं। एडिटर टूलबार के दाएँ सिरे का पैकेज बटन प्रोजेक्ट की भाषा के लिए एक खोजयोग्य सूची खोलता है और पैकेज लोड करने वाली पंक्ति आपके लिए लिख देता है। Markdown प्रोजेक्ट में कोई पैकेज बटन नहीं होता।
आप यह सूची ⌘K पैलेट से Browse LaTeX packages या Browse Typst packages से भी खोल सकते हैं।
LaTeX पैकेज
“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 पैकेज इंस्टॉल करना
“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 देता है, जो पता लगाता है कि वह फ़ाइल किस पैकेज की है। देखें किसी ग़ायब फ़ाइल से उबरें।
Recompile के बगल के तीर से कंपाइलर चुनें। देखें LaTeX इंजन।
Typst पैकेज
“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 चालू होने पर डायलॉग पिछली बार डाउनलोड की गई पैकेज सूची का उपयोग करता है और उसकी तारीख़ दिखाता है। अगर कभी कोई सूची डाउनलोड नहीं हुई है, तो ऑनलाइन होने तक वह कोई सूची नहीं दिखा सकता।
संबंधित पेज
“संबंधित पेज” शीर्षक वाला अनुभाग- एडिटर: एडिटर टूलबार का बाक़ी हिस्सा
- कंपाइल करना: बिल्ड के दौरान पैकेज कैसे फ़ेच होते हैं
- दस्तावेज़ सेटिंग: पैकेज कोड लिखे बिना पेपर का आकार, मार्जिन और फ़ॉन्ट