यदि आपने कोई कोड लिखा है, तो आप शायद सहमत होंगे कि प्रोग्रामिंग में डॉक्यूमेंटेशन पढ़ना शामिल है, बहुत सारा। कई मामलों में, डॉक्यूमेंटेशन और अन्य कोड पढ़ने में लगने वाला समय वास्तविक कोड लिखने में लगने वाले समय से अधिक होता है। और चूंकि वह डॉक्यूमेंटेशन अक्सर वेब पर एक्सेस किया जाता है, इसलिए आप जो जानकारी ढूंढ रहे हैं उसे खोजने और उसके लोड होने की प्रतीक्षा करने में काफी समय बर्बाद होता है। धीमे कनेक्शन के साथ ये छोटी देरी निराशाजनक हो सकती है, और जल्दी से खोई हुई उत्पादकता के मिनटों या घंटों तक जुड़ सकती है। इसके अलावा, उस जानकारी तक पहुंचने के लिए एक निरंतर इंटरनेट कनेक्शन की आवश्यकता होती है, जो हमेशा उपलब्ध नहीं होता है।
सौभाग्य से, आप ज़ील (Zeal) का उपयोग कर सकते हैं, एक ऑफ़लाइन डॉक्यूमेंटेशन ब्राउज़र, प्रोग्रामिंग भाषा और सॉफ़्टवेयर डॉक्यूमेंटेशन को अपने कंप्यूटर पर स्टोर करने और इसे जल्दी और प्रभावी ढंग से एक्सेस करने के लिए। ज़ील डैश (Dash) द्वारा प्रदान किए गए डॉक्यूमेंट सेट (docsets) का उपयोग करता है। उनमें कई प्रोग्रामिंग और स्क्रिप्टिंग भाषाओं और लाइब्रेरीज़ के साथ-साथ डॉकर (Docker), एनजिनएक्स (Nginx), वर्डप्रेस (WordPress) और इलास्टिकसर्च (ElasticSearch) जैसे विभिन्न सॉफ़्टवेयर के लिए डॉक्यूमेंटेशन शामिल हैं।
यहां लिनक्स पर ज़ील इंस्टॉल करने, उपयोग करने और अनुकूलित करने का तरीका बताया गया है।
ज़ील इंस्टॉल करना
ज़ील कई लिनक्स डिस्ट्रीब्यूशन के सॉफ़्टवेयर रिपॉजिटरी में उपलब्ध है, इसलिए यदि संभव हो तो आपको इसे अपने नेटिव पैकेज मैनेजर का उपयोग करके इंस्टॉल करना चाहिए।
उबंटू, लिनक्स मिंट और डेबियन पर:
sudo apt install zeal
आर्क लिनक्स पर:
sudo pacman -S zeal
जेंटू पर:
sudo emerge app-doc/zeal
फेडोरा पर:
sudo dnf install zeal
ज़ील का उपयोग करना
आप अपने एप्लिकेशन मेनू/लॉन्चर से या कमांड-लाइन टर्मिनल से zeal टाइप करके ज़ील लॉन्च कर सकते हैं।
ज़ील डिफ़ॉल्ट रूप से कोई डॉक्यूमेंटेशन शामिल नहीं करता है। उपलब्ध डॉकसेट्स देखने के लिए, "Tools → Docsets" पर जाएं और "Available" टैब खोलें।
उन डॉकसेट्स को चुनें जिन्हें आप स्टोर करना चाहते हैं और "Download" पर क्लिक करें। एक बार प्राप्त हो जाने पर, डॉक्यूमेंट सेट ऊपरी-बाएं पेन में एक नेविगेबल पदानुक्रमित संरचना में प्रदर्शित होते हैं। जब लागू हो, तो निचला-बायां पेन वर्तमान डॉक्यूमेंट पेज के तत्वों के शॉर्टकट प्रदर्शित करता है।
आप एक क्वेरी दर्ज करके या docset:query सिंटैक्स के साथ एक विशिष्ट डॉकसेट में खोज सकते हैं। उदाहरण के लिए, पायथन के re.match फ़ंक्शन को खोजने के लिए, आप python:re.match दर्ज करेंगे।
नोट: कंपाउंड खोज सिंटैक्स (यानी docset:query) के साथ, docset भाग केस-सेंसिटिव है, और query भाग केस-इनसेंसिटिव है।
ज़ील को अनुकूलित करना
फॉन्ट्स
आप फॉन्ट और फॉन्ट आकार के साथ ज़ील की उपस्थिति को अपनी पसंद के अनुसार कॉन्फ़िगर कर सकते हैं।
ऐसा करने के लिए, "Edit → Preferences → Content" पर जाएं और फिर एक डिफ़ॉल्ट फॉन्ट फैमिली और प्रत्येक फॉन्ट फैमिली के लिए विशिष्ट फॉन्ट चुनें।
डार्क मोड
ज़ील एक डार्क मोड भी प्रदान करता है ("Edit → Preferences → Content" में), हालांकि यह केवल डॉक्यूमेंट सामग्री पर लागू होता है और आसपास के ग्राफिकल इंटरफ़ेस पर नहीं, जैसा कि आप निम्नलिखित स्क्रीनशॉट में देख सकते हैं।
उपयोगकर्ता-परिभाषित CSS
यदि आप नियमित रूप से ज़ील का उपयोग करने जा रहे हैं, तो इसे अपने स्वाद के अनुसार अनुकूलित करने में कुछ समय देना उचित है। आप डॉक्यूमेंट्स की उपस्थिति पर अधिक और बेहतर नियंत्रण के लिए एक कस्टम स्टाइलशीट का उपयोग कर सकते हैं।
अपने टेक्स्ट एडिटर का उपयोग करके एक नई CSS फ़ाइल बनाएं:
vim ~/.local/share/Zeal/custom.css
वांछित CSS नियम सेट दर्ज करें, उदाहरण के लिए:
code { border-style: dashed; border-width: 1px; color: red; }
नव निर्मित CSS फ़ाइल का चयन करने के लिए "Edit → Preferences → Content → Custom CSS" फ़ाइल पर जाएं। अपनी सेटिंग्स सेव करने के बाद, परिवर्तन तुरंत दिखाई देंगे। निम्नलिखित स्क्रीनशॉट उपरोक्त CSS लागू करने के बाद ज़ील को दिखाता है।
निष्कर्ष
ज़ील प्रोग्रामर्स और सिस्टम एडमिनिस्ट्रेटर के लिए एक बेहतरीन टूल है जो अक्सर डॉक्यूमेंटेशन एक्सेस करते हैं। चूंकि यह डॉक्यूमेंट्स को स्थानीय रूप से स्टोर करता है, यह आपका समय बचा सकता है और आपको हाथ में काम पर बेहतर ध्यान केंद्रित करने की अनुमति देता है। इसके अलावा, वेब डॉक्यूमेंट्स के विपरीत, यह बेहतर डॉक्यूमेंट उपस्थिति नियंत्रण के लिए उपयोगकर्ता-परिभाषित स्टाइलशीट का समर्थन करता है।
