🐳 🧑🏿‍🤝‍🧑🏼 🙀 वेब मदद, वेब दस्तावेज़। और भी आसान 👰🏼 🍙 🚲

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

ऑनलाइन मदद या वेबसाइट बनाने का सबसे आसान तरीका। ट्यूटोरियल।

बनाने के लिए, हमें किसी पाठ संपादक की आवश्यकता है।

विकल्प 1. शुरू।

सबसे पहले, एक पेज टेम्प्लेट बनाएं या पेज टेम्प्लेट . html लिंक डाउनलोड करें। यदि आपके ब्राउज़र में इस लिंक पर ही टेम्प्लेट खुलता है और इसकी फ़ाइल लोड नहीं होती है, तो ब्राउज़र को इस रूप में सहेजें (केवल HTML) बताएं, पहले आपको केवल HTML कोड की आवश्यकता होगी। यदि सब कुछ सही है, तो फ़ाइल में इस सरल पृष्ठ टेम्पलेट जैसा कुछ है:

<!DOCTYPE html> <html lang="ru-RU"> <head> <meta charset="utf-8"> <title>Example</title> <script src="document.min.js" id='DOC' onerror="var l=document.createElement('link'),s=document.createElement('script');l.rel='stylesheet';l.href='http://netdna.bootstrapcdn.com/bootstrap/3.0.0/css/bootstrap.min.css';l.id='bootstrap.css';l.auto='1';document.head.insertBefore(l,document.getElementById('DOC'));s.src='http://aplib.imtqy.com/document.min.js';document.head.appendChild(s);"></script> </head> <body> <!--fixed-top-bar %navbar( * [Home](index.html) * [Page1](page1.html) )%navbar --> <!--header-panel # Insert header here site description --> <!--content-panel # content text ## content text ### content text content text --> <!--footer-panel footer here --> <noscript><div class="alert alert-warning">This Website requires your browser to be JavaScript enabled.</div></noscript> </body></html>

सतर्क के लिए एक स्पष्टीकरण: एक स्क्रिप्ट के अभाव में, सीएसएस देशी बूटस्ट्रैप सीडीएन से लोड किया गया है, और स्क्रिप्ट जीथब पर रिपॉजिटरी से है, वहां कोई मैलवेयर नहीं हैं।

अगला, हम इस कोड को एक टेम्पलेट के रूप में उपयोग करते हैं।

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

उपरोक्त माइक्रो-टेम्पलेट पहले से ही सीमित मोड में काम करता है, यहां तक कि अतिरिक्त फ़ाइलों के बिना भी। आप पाठ को संपादित कर सकते हैं, और अपनी साइट पर इस फॉर्म में प्रकाशित कर सकते हैं। सच है, यह बहुत ही उत्तरदायी नहीं होगा, और कभी-कभी बाजीगरी भी होगी, क्योंकि इस मोड में बंडल मेरी रिपॉजिटरी से डाउनलोड किया गया है। थोड़ा आसान कहना - यदि आप डॉक्यूमेंट को नहीं जोड़ते हैं। min.js और css स्क्रिप्ट - यह थोड़ा धीमा हो सकता है और ऑफ़लाइन काम नहीं करता है। हालांकि, कुछ जरूरतों के लिए यह करेगा, और लाभ सृजन में आसानी है।

विकल्प 2. एक-पृष्ठ की साइट या दो से तीन पृष्ठों की साइट।

हम aplib.imtqy.com/markdown-site-template पर जाते हैं , टेम्पलेट डाउनलोड करते हैं, संग्रह से document.min.js और bootstrap.css निकालते हैं और उन्हें हमारे पृष्ठों के आगे फ़ोल्डर में डालते हैं। यह वास्तव में बंडल ही है और सीएसएस है, अर्थात, पुस्तकालयों। सामान्य मोड और ऑफ़लाइन में साइट (या दस्तावेज़) देखने के लिए, यह पर्याप्त है। हालांकि यह सब नहीं है।

विकल्प 3. लगभग पूरा।

सूत्र

Bootstrap.css के स्थान पर, कोई बूटस्ट्रैप-संगत थीम या देशी बूटस्ट्रैप हो सकता है, लेकिन कस्टम सेटिंग्स के साथ, अर्थात् अनुकूलित। Bootswatch.com पर मुफ्त थीम के हमारे चयन की जाँच करें। व्यक्तिगत खामियों के बिना नहीं, लेकिन निश्चित रूप से एक शानदार चयन। प्रोजेक्ट साइट पर आप देख सकते हैं कि ये विषय साइट का रूप कैसे बदलते हैं।

user.js

कॉपी-पेस्ट के साथ नीचे! नेविगेशन मेनू, हेडर, और पाद को एक अलग साझा फ़ाइल में रखा गया है। आप एक ही संग्रह में एक उदाहरण user.js के रूप में देख सकते हैं जिसमें सामान्य पृष्ठ तत्व हैं।

घटकों

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

sitemap.xml

यदि आप इस बिंदु पर आते हैं, तो आप नेटवर्क पर इस सिद्धांत द्वारा बनाई गई साइट रखना चाहते हैं और इसे Google में अनुक्रमित करना चाहते हैं। मैंने बस इतना ही किया। चूंकि यह JS साइट है, Google में सामान्य अनुक्रमण के लिए आपको सर्च इंजन को साइटमैप। Xml खिलाना होगा, अन्यथा Google आंतरिक लिंक नहीं देखता है। यह फ़ाइल sitemap.html का उपयोग करके बनाई जा सकती है। Sitemap.xml का एक विकल्प - पेज बनाने के बाद, स्थिर html उत्पन्न करें, विकल्प अधिक विश्वसनीय है और इस तरह की संभावना है, लेकिन इस मोड के लिए दस्तावेज अभी भी लिखे जाने की आवश्यकता है।

परियोजना।

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

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

सबसे सुखद लाइसेंस। यह आपके लिए GPL नहीं है, यह MIT है, स्वतंत्रता और समानता की विजय है।
वेबसाइट aplib.imtqy.com/markdown-site-template
Github.com/aplib/markdown-site-template रिपॉजिटरी

यह पहली समीक्षा पोस्ट है और अभी तक कोई बीटा परीक्षण और चर्चा परिणाम नहीं हैं, इसलिए मैं इनसाइट्स के बारे में नहीं लिख रहा हूं, हालांकि सब कुछ काफी दिलचस्प है, बंडल इतना छोटा वेब ओएस है और इसके बारे में बताने के लिए कुछ है।

वेब मदद, वेब दस्तावेज़। और भी आसान