जेकेल प्रैक्टिकल गाइड

हब्राह्र पर जेकिल पहले ही चमक गया। संक्षेप में: स्थैतिक साइटों को बनाने के लिए यह एक ब्लॉग-उन्मुख प्रणाली है। मुख्य विशेषता: इसका उपयोग जीथब पेज पर किया जाता है, जो आपको साइट के स्रोत को गितुब पर रिपॉजिटरी में रखने की अनुमति देता है - और आने के 10 मिनट के भीतर कई कैशिंग सर्वर आगंतुकों को एकत्र और प्रदर्शित किए जाएंगे। यदि यह अधिक दिलचस्प और संक्षेप में है: मैं इस लेख को पढ़ने की सलाह देता हूं, जिस सामग्री का मैं यहां उल्लेख करूंगा। और मैं Jekyll के बारे में अधिक विस्तार से बात करूंगा: इसका उपयोग अपने इच्छित उद्देश्य के लिए कैसे किया जा सकता है, इसका उपयोग अन्य उद्देश्यों के लिए क्यों किया जा सकता है, और यह बिल्कुल भी सक्षम है। लेख उन लोगों पर अधिक ध्यान केंद्रित करता है जिन्होंने पहले इस तरह से कुछ भी काम नहीं किया है (जैसे कि मैं वर्डप्रेस के साथ काम करता था), और अधिकांश लेख में Jekyll को ब्लॉगिंग का एक साधन माना जाएगा, हालांकि अंत की ओर पूरी तरह से कुछ अलग होगा।

सभी मौजूदा ब्लॉग प्लेटफार्मों (इंजनों, सेवाओं, जनरेटर) में से, Jekyll मुझे अजीब तरह से खड़ा लग रहा था। यह मेरी गलती है, क्योंकि मैं स्थिर साइटों में बहुत समय पहले दिलचस्पी नहीं ले रहा था और मुझे कोई भी एनालॉग पता नहीं है। Jekyll का उद्देश्य तकनीकी रूप से साक्षर लोगों को करना है जो अपने इच्छित उद्देश्य के लिए ब्लॉग का उपयोग करने में अधिक रुचि रखते हैं: पोस्ट को रिवर्स कालानुक्रमिक क्रम में प्रकाशित करें, साथ ही साथ अधिक या कम सुविधाजनक नेविगेशन प्रदान करें। यदि आपको अधिक आवश्यकता है, तो आपको या तो पसीना करना होगा या अधिक (अच्छी तरह से, या जेकेल से) छोड़ देना होगा। और "संचार" का यह तरीका काफी हद तक इस प्लेटफ़ॉर्म के उपयोगकर्ताओं के सर्कल को निर्धारित करता है: जिन लोगों को एक अत्यंत समझदार संरचना वाली साइट की आवश्यकता होती है और नई पोस्ट प्रकाशित करने में न्यूनतम समस्याएं होती हैं।

लेखन पोस्ट

पहली बात जेकील सबसे शुरुआती को दोहराती है: एक दृश्य (WYSIWYG) संपादक की पूरी कमी। यह एक जानबूझकर विफलता है, न कि तकनीकी दोष। उनके पदों के डिजाइन के लिए, मार्कडाउन और टेक्सटाइल भाषाओं का उपयोग करने का प्रस्ताव है, जो स्रोत कोड में भी अच्छी तरह से पठनीय मार्कअप भाषा हैं। और इसकी मदद से, "शून्य में स्थित गोलाकार जेकेल उपयोगकर्ताओं" के लिए अधिक महत्वपूर्ण पोस्ट लिखने का सिद्धांत साकार होता है: WYSIWYM, आप जो देखते हैं उसका मतलब है, जिसके लिए कोई भी पाठ संपादक उपयुक्त है, यहां तक ​​कि टर्मिनल में भी।

जेकेल में दृश्य संपादक अनुपस्थित है, क्योंकि यह बहुत स्पष्ट नहीं है कि इसे कहां रखा जाए। आपको स्वयं दर्ज किए गए परिणाम को सहेजना होगा, संपादक इसे लिखने में सक्षम नहीं होगा, साइट किसी तरह स्थिर है। जो स्थिति से दो उचित तरीके निकालता है:

• संपादक को किसी वेब पेज पर रखें, इसे कहीं से एक ब्राउज़र में चलाएं और ब्राउज़र से रिपॉजिटरी में मैन्युअल रूप से कोड कॉपी करें
• गद्य .io वेब एप्लिकेशन का उपयोग करें (टिप के लिए एल्फेट के लिए धन्यवाद), परिणाम पर इशारा करते हुए (बिल्कुल WYSIWYG नहीं), लेकिन परिणाम को स्वयं को लिखना
• उपयोगकर्ता के कंप्यूटर पर संपादक के लिए काम छोड़ दें

मैं किसी भी Jekyll उपयोगकर्ता को नहीं जानता हूं जो पहली विधि का उपयोग करेगा, हालांकि मैं बाहर नहीं करता हूं कि ऐसे हैं। हां, आप ब्राउज़र-आधारित विज़ुअल एडिटर का उपयोग कर सकते हैं, लेकिन पोस्ट लिखने की पूरी प्रक्रिया को संपादक में टाइप करने और परिणामी कोड को मार्कडाउन (* .md, * .markdown) पर Jekyll पोस्ट के साथ फाइल में कॉपी करने के लिए कम हो जाएगा, क्योंकि कोई भी मार्कडाउन में HTML को मना नहीं करता है। कपड़ा ने कोशिश नहीं की है, शायद वह भी इस तरह के हास्य की सराहना करेगा। लेकिन अगर आप गंभीरता से ऐसा सोचते हैं, तो इसके बारे में सोचें: आपको जेकेल की आवश्यकता क्यों है?

स्थैतिक हानिकारक नहीं है

दूसरी बात जेकेल रीपल्स: इकट्ठी साइट की स्थिर प्रकृति, प्रतिक्रिया की कमी। यह समान रूप से एक नुकसान और एक फायदा है। तृतीय-पक्ष सेवाओं का उपयोग करके, इस सुविधा के नुकसान को कमजोर किया जा सकता है। यह दृष्टिकोण सभी के अनुरूप नहीं होगा, लेकिन कई। मैंने वर्डप्रेस को ठीक से छोड़ दिया क्योंकि मैंने इसकी कार्यक्षमता का केवल एक छोटा सा हिस्सा इस्तेमाल किया, और बाकी को अतिरिक्त प्लगइन्स के साथ अक्षम या अवरुद्ध करना पड़ा। अंत में, मुझे आश्चर्य हुआ: मेरी साइट को फीडबैक की आवश्यकता क्यों है यदि यह उसी तृतीय-पक्ष सेवा पर पोस्ट की गई टिप्पणियों तक सीमित है? बहुत से ब्लॉगों को अभी ज्यादा जरूरत नहीं है।

प्रतिक्रिया से इनकार करके, आप होस्टिंग आवश्यकताओं को काफी कम कर सकते हैं: एक स्थिर साइट के लिए, सर्वर को केवल फ़ाइल सिस्टम से पेज देने की क्षमता की आवश्यकता होती है, जो लगभग कोई भी वेब सर्वर कर सकता है। टिप्पणियाँ कई सेवाएं प्रदान करती हैं, जिसमें डिस्कस भी शामिल है, और खोज करने के कई तरीके हैं:

• Google कस्टम खोज (स्पष्ट रूप से)
• Google को site: पैरामीटर के साथ अनुरोध भेजने का फॉर्म site:
• तरल (नीचे उस पर अधिक) का उपयोग करके खोज के लिए सामग्री बनाएं और ग्राहक को उस पर खोज करने के लिए मजबूर करें
• RSS फ़ीड एकत्र करें और टैपिर सेवा का उपयोग करें (हो सकता है कि उसका हेब्रा इफेक्ट बख्शा जाए)

यह पहले से ही एक अच्छा ब्लॉग शुरू करने के लिए पर्याप्त है, जो बढ़ने पर नेविगेट करने के लिए सुविधाजनक होगा। और एक ही समय में, होस्टिंग पक्ष को अभी भी केवल पृष्ठ देने की आवश्यकता है। शायद यह ग्राहक के संबंध में कुछ "गलत" है, जिसे अन्य नोड्स के लिए अतिरिक्त अनुरोध करना होगा, लेकिन यह कितना स्थिर है कि स्थैतिक के सभी लाभ आपके ऊपर हैं। आमतौर पर बाहर नहीं निकलता है।

Github पर होस्टिंग की सुविधाएँ

जीथब मुख्य रूप से गिट रिपॉजिटरी का भंडार है। और साइटों के संबंध में, इसका मतलब है कि यह आपकी साइट के परिवर्तनों के पूरे इतिहास को संग्रहीत करता है। कभी-कभी Jekyll पर साइट रिपॉजिटरी में जाने और साइट के संपूर्ण इतिहास को देखने के लिए यह मजेदार है। यह न केवल एक मजेदार विशेषता है, बल्कि आपकी ओर से किसी भी अतिरिक्त प्रयास के बिना आपके चाल पर अन्य Jekyll उपयोगकर्ताओं को शिक्षित करने का एक तरीका भी है।

यदि आप इसके बारे में सोचते हैं, तो जीथ्यूब जेकेल का उपयोग करने के सबसे शक्तिशाली कारणों में से एक है। रिपॉजिटरी के उन्नत वेब इंटरफेस के अलावा, जो वास्तव में व्यवस्थापक पैनल को बदल देता है (आप इससे फाइलें बना सकते हैं और संपादित कर सकते हैं, यह पूर्ण नियंत्रण के लिए पर्याप्त है), इस तरह की मेजबानी साइट को गीथब काम करने से कहीं भी उच्च डाउनलोड गति प्रदान करेगी - जहां भी जाते हैं, कम से कम।

खुद Jekyll से संबंधित नहीं कई विशेषताएं भी हैं। रिपॉजिटरी की जड़ में 404.html डालते हुए, उपयोगकर्ता द्वारा आपकी साइट के टूटे हुए लिंक पर क्लिक करने पर आपको अपना स्वयं का त्रुटि पृष्ठ मिलेगा। CNAME टेक्स्ट फ़ाइल को रूट में सिंगल लाइन के साथ डालते हुए, आप इस लाइन पर इंगित डोमेन को अपनी साइट पर अटैच करते हैं। आपको बस DNS का उपयोग करके इस डोमेन को Github पर निर्देशित करना है।

वहाँ YAML क्यों है

जेकिल को स्थापित करने और उपयोग करने के लिए पर्याप्त गाइड हैं, मैं कुछ और आंतरिक बात करूंगा। YAML सामने की बात, जिसे मैं "YAML हेडर" कहता हूं, फ़ाइल के बहुत शुरुआत में लिखे गए पृष्ठ या पोस्ट के बारे में संरचित जानकारी का एक सेट है। मेरे सबसे करीबी परिचित यमलोक के एनालॉग, जिसकी गंभीर लोकप्रियता है - JSON। भाषा का सार: पाठ रूप ( क्रमांकन ) में निर्धारित संरचित डेटा का प्रतिनिधित्व। और संरचना के लिए सुविधाजनक बनाने के लिए, भाषा में दो डेटा संरचनाएं होना आवश्यक है: एक सूची और एक सहयोगी सरणी (सूची और नक्शा)। सरल शब्दों में: मूल्यों की एक सूची और विशिष्ट नामों के साथ मूल्यों की एक सूची।

डेटा के अच्छे पठनीयता को बनाए रखते हुए, यहां YAML वास्तव में वही करता है जो उसे करना चाहिए। ज्यादातर मामलों में, वह एक सहयोगी सरणी में कई मूल्यों को निर्दिष्ट करने में रुचि रखते हैं: नाम, तिथि, टैग, श्रेणी। इसके अलावा, YAML WYSIWYM की भावना का समर्थन करता है: आप समझते हैं कि एक टोपी का मतलब है कि मुश्किल से इसे देखकर। लेकिन YAML ऐसे आदिम संकेतों की तुलना में बहुत अधिक सक्षम है।

आप किसी भी डेटा को YAML में लिख सकते हैं: ठेठ से पागल तक (एक बग रिपोर्ट पहले ही भेजी जा चुकी है)। _posts पर _posts साथ _posts में आपके पदों का सेट, वास्तव में, आपकी साइट का डेटाबेस है, और यह उस रूप में उपयोग करने के लिए आवश्यक नहीं है जिसमें इसे Jekyll विकसित करते समय कल्पना की गई थी। लेकिन इससे पहले कि आप डेटाबेस भरें, आपको इससे डेटा का उपयोग करना सीखना चाहिए। इसके बारे में थोड़ा और आगे।

टेम्पलेट्स: सबसे महत्वपूर्ण बात!

शायद सभी स्थिर साइट जनरेटर में मुख्य विशेषता टेम्पलेट है। क्योंकि एक ही कोड को कई अलग-अलग जगहों पर कॉपी करने की आवश्यकता नहीं है अगर कंप्यूटर आपके लिए यह कर सकता है। संपूर्ण Jekyll टेम्पलेट प्रणाली सरल है, लगभग आदिम है। टेम्पलेट सिर्फ एक HTML पृष्ठ ( _layouts फ़ोल्डर में) है, जिसमें एक तरल टैग (बाद में उनके बारे में अधिक) {{ content }} । और टेम्प्लेट का नाम एक्सटेंशन के बिना फ़ाइल का नाम है: उदाहरण के लिए, टेम्पलेट foo को फ़ाइल foo.html में वर्णित किया जाना चाहिए।
किसी साइट का कोई भी पेज एक टेम्पलेट से लिंक हो सकता है (दूसरे टेम्पलेट सहित):

 --- layout: default --- 

जब जेकिल पेज का निर्माण करता है, तो यह देखने के लिए जांचता है कि क्या हेडर में layout पैरामीटर निर्दिष्ट किया गया है। यदि निर्दिष्ट किया गया है, तो पहले पृष्ठ को इसमें निर्दिष्ट टेम्पलेट से इकट्ठा किया जाता है, और प्राप्त पृष्ठ से टैग {{ content }} को उस पृष्ठ की सामग्री से बदल दिया जाता है जिस पर काम किया जा रहा है। मैं एक उदाहरण दूंगा।

मेरी साइट पर, मैं मुख्य रूप से दो टेम्पलेट्स का उपयोग करता हूं: list और post , लेकिन वे आत्मनिर्भर नहीं हैं, लेकिन default टेम्पलेट के एक्सटेंशन हैं। उत्तरार्द्ध लगभग सभी पृष्ठों पर उपयोग किया जाने वाला सबसे बाहरी शेल है। post पोस्ट, उसके टैग और टिप्पणी फ़ॉर्म प्रदर्शित करता है। list उपयोग सभी प्रकार की पोस्ट सूचियों के लिए किया जाता है, और इसमें जावास्क्रिप्ट होता है जो सूची में सभी पदों के लिए टिप्पणियों की संख्या प्रदर्शित करता है। मेरे ब्लॉग पर layout: post post.html , Jekyll पहली बार layout: post देखता layout: post हेडर में layout: post , layout: post में कॉल करता है और layout: default देखता layout: default । post.html में कोई टेम्प्लेट निर्दिष्ट नहीं हैं, इसलिए यह इस फ़ाइल को डाउनलोड करता है, post.html को {{ content }} स्थान पर लिखता है (और यह एक टेम्पलेट है, इसमें {{ content }} भी है और परिणामस्वरूप {{ content }} बजाय हाइब्रिड है। {{ content }} मेरी पोस्ट लिखता है।

सैद्धांतिक रूप से, आप विभिन्न प्रकारों और प्रारूपों के पद बना सकते हैं: पूर्ण लेख, नोट, उद्धरण, चित्र। आपको कड़ी मेहनत करनी होगी ताकि प्रारूप के आधार पर पोस्ट अलग-अलग तरीकों से सूचियों में दिखाई दें, लेकिन यह संभवतः एकमात्र अप्रकाशित क्षण है।

तरल की अप्रत्याशित शक्ति

एक साइट बनाने के लिए, आपको उन नियमों का वर्णन करना होगा जिनके द्वारा पीढ़ी बनाई जाएगी। भाग को Jekyll में सीवन किया जाता है, जैसे _posts में सभी फाइलों को _posts जिसका नाम एक निश्चित प्रारूप (दिनांक-नाम) से मेल खाता है, और site संरचना को संकलित करता है। यह हमेशा और बहुत बिना तामझाम के ब्लॉग पर काम करने की सुविधा देता है।

आप रूबी में लिक्विड में नियम भी लिख सकते हैं या प्लगइन्स विकसित कर सकते हैं। लेकिन बाद के साथ, निराशा आपको इंतजार कर रही है - जीथब ने "सुरक्षित मोड" में जेकिल लॉन्च किया, और जनरेटर उपयोगकर्ता प्लग-इन पर ध्यान नहीं देगा। यदि आपको वास्तव में उनकी आवश्यकता है, तो आप हमेशा अपने आप से एक साइट उत्पन्न कर सकते हैं, और फिर साइट के स्रोत जीथब को अपलोड नहीं कर सकते हैं, लेकिन जनरेटर से प्राप्त परिणाम। एक ही रिपॉजिटरी की दो अलग-अलग शाखाओं में ऐसा करना बुद्धिमानी है (जैसा कि ऑक्टोप्रेस करता है)। आप जो कुछ भी खोते हैं वह अनावश्यक कार्यों के बिना प्रतिबद्धताओं के तुरंत बाद स्रोत में परिवर्तन को पकड़ने की क्षमता है। यदि आप मुख्य रूप से एक ही मशीन से साइट के साथ काम करते हैं, तो यह कोई समस्या नहीं है: आप एक शेल स्क्रिप्ट लिख सकते हैं जो साइट को आपके रिपॉजिटरी के साथ एक फ़ोल्डर में इकट्ठा करती है, इसमें एक तिथि / समय (उदाहरण के लिए), और Github में परिवर्तन भेजता है । लेकिन बिना किसी डर के वापस कर सकते हैं।

जेकेल पर एक साइट बनाकर, आप पहले से ही मुख्य पृष्ठ पर तरल अधिकार पर एक सरल कार्यक्रम प्राप्त करेंगे। कार्यक्रम का सार सरल है: साइट पर उपलब्ध सभी पोस्ट प्रदर्शित करें। और ऐसा करने वाला कोड काफी पठनीय लगता है:

 {% for post in site.posts %} <li><span>{{ post.date | date_to_string }}</span> &raquo; <a href="{{ post.url }}">{{ post.title }}</a></li> {% endfor %} 

प्रत्येक पद के लिए उसकी प्रकाशन तिथि और उसका एक लिंक, उसके नाम से दर्शाया गया है। यह काफी तार्किक और छोटा लगता है। लेकिन यह सबसे आसान प्रारूप है। आप शायद प्रत्येक पोस्ट ("काटा" के यांत्रिकी) के साथ इसका एक छोटा सा टुकड़ा प्रदर्शित करना चाहते हैं। Jekyll Developers ने इसे प्रदान किया है, और प्रत्येक पोस्ट के लिए इस तरह के टुकड़े को excerpt चर में लिखा गया है। तरल में, इसे लागू किया जा सकता है, उदाहरण के लिए, इस तरह:

 {% for post in site.posts %} <li> <p><span>{{ post.date | date_to_string }}</span> &raquo; <a href="{{ post.url }}">{{ post.title }}</a></p> <p>{{ post.excerpt }}</p> </li> {% endfor %} 

आप साइटमैप बनाने के लिए तरल का उपयोग कर सकते हैं (विचार के लिए इस व्यक्ति के लिए धन्यवाद) और यहां तक ​​कि टैग क्लाउड (जहां सबसे अधिक उपयोग किए जाने वाले टैग बड़े होते हैं, उसके लिए धन्यवाद ), जो साइट के लिए बहुत उपयोगी है।

यम्ल + लिक्विड =?

अंतर्निहित चर के साथ, सब कुछ कम या ज्यादा स्पष्ट है। लेकिन मामला सिर्फ यहीं तक सीमित नहीं है। व्यावहारिक उदाहरणों का पालन करना जारी रखते हुए, हम यहाँ और यहाँ , मेरी साइट पर उपयोग किए गए पृष्ठ शीर्षकों को देखते हैं । प्रत्येक शीर्षक में FontAwesome से एक आइकन भी होता है। इस फ़ॉन्ट से एक आइकन सम्मिलित करना (पुराने संस्करण में, जैसे मेरा) निर्माण द्वारा किया जाता है:

 <i class="icon-"> </i> 

लेकिन आप इसे टेम्पलेट में ऐसा करके हर बार हेडर में नहीं लिख सकते हैं:

 <i class="icon-{{ post.icon }}"> </i> 

... और संक्षेप में कुछ पूछना आवश्यक पृष्ठों के YAML हेडर में इस तरह है:

 icon: tags 

और यह अपेक्षाकृत सरल उदाहरण है। आप संपूर्ण डेटा संरचनाओं को अपने स्वयं के चर में संग्रहीत कर सकते हैं, और यह आपको उन चीजों को करने की अनुमति देता है जो कुछ के लिए पागल लग सकते हैं। जब मुझे एहसास हुआ कि यह किया जा सकता है, तो मैंने टेक्स्ट की खोज को फिर से परिभाषित किया, 10 घंटे "नंगे हाथ" में इकट्ठे हुए, स्क्रिप्ट के अनुसार, जेकिल का उपयोग करके स्वचालित विधानसभा में। परिणाम यहां देखा जा सकता है , जिसमें मूल संस्करण भी शामिल है। टेक्स्ट खोज के प्रत्येक "दृश्य" को Jekyll शब्दों में एक "पोस्ट" है, जिसके YAML हेडर में एक "कोड नाम", दृश्य शैली, दृश्य (आइकन) के लिए "चित्रण", लिंक की एक सूची, जिनमें से प्रत्येक में एक आइकन, पाठ और शामिल हैं गंतव्य, और कुछ कम महत्वपूर्ण कचरा। जेकिल, सभी दृश्य पदों के आधार पर, एक बड़े पृष्ठ को इकट्ठा करता है, जहां यह पूरी खोज काम करने की स्थिति में है। एक अप्रिय दुष्प्रभाव - पृष्ठ प्रत्येक दृश्य के लिए उत्पन्न होते हैं, लेकिन कहीं भी उनके लिए कोई लिंक नहीं है। इससे कैसे निपटा जाए, मैंने नहीं सोचा था।

निष्कर्ष

एक बार फिर, मैं ध्यान देता हूं: जेकेल हर किसी के लिए नहीं है। लेकिन अगर आप पूरा लेख पढ़ते हैं और यह आपको डराता नहीं है - शायद आपको Jekyll को कार्रवाई में आज़माना चाहिए, तो आपको केवल वेब पृष्ठों को संकलित करने के लिए रूबी (अधिमानतः) और बुनियादी ज्ञान द्वारा निर्धारित समय की आवश्यकता है। मैंने कार्यात्मक कार्यान्वयन का वर्णन किया है जो सभी वर्डप्रेस उपयोगकर्ताओं का उपयोग भी नहीं करते हैं।

Jekyll में उपलब्ध कार्यक्षमता आपको केवल एक ब्लॉग से कहीं अधिक बनाने की अनुमति देती है। लेकिन यह अन्य उद्देश्यों के लिए जेकिल के उपयोग की अधिक संभावना है, हालांकि यह गीथब पर होस्टिंग के रूप में एक अच्छा बोनस के साथ काफी दिलचस्प काम हो सकता है। मैंने रूबी में प्लगइन्स के विषय का एक सरल कारण से खुलासा नहीं किया: मैं इस भाषा से पूरी तरह से अपरिचित हूं और जीथब पर इसका उपयोग करने की अक्षमता मुझे इसे अध्ययन करने के लिए मजबूर नहीं करती है। केवल दो भाषाएँ जिन्हें आपको सीखना चाहिए, वे हैं: YAML और लिक्विड, और यहां तक ​​कि यह आवश्यक नहीं है यदि आप दिशानिर्देशों का पालन करते हैं और अधिक के लिए लक्ष्य नहीं रखते हैं। हालांकि, कुछ लोगों को एक अल्प और आदिम ब्लॉग की आवश्यकता होती है अगर कुछ पूरी तरह से अद्वितीय और अत्यंत उपयोगी पोस्ट नहीं किया जाता है।

सामान्य तौर पर, यदि आप अपने आप में ताकत और दृढ़ संकल्प महसूस करते हैं तो इसे आजमाएँ। और अगर आपने अभी भी ऐसा कुछ करने की कोशिश नहीं की है।