Ubuntu 17.10 पर Raneto कैसे स्थापित करें

• आवश्यक शर्तें
• प्रवेश किया
• Node.js और PM2 स्थापित करना
• रानितो को स्थापित करना
• आगे विन्यास
• पेज जोड़ना
• श्रेणियाँ जोड़ना

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

आवश्यक शर्तें

• Ubuntu 17.10 के साथ एक VPS स्थापित।
• SSH आपके VPS तक पहुँचता है।
• लिनक्स टर्मिनल की बुनियादी समझ।

प्रवेश किया

सबसे पहले, हमें SSH का उपयोग करके अपने सर्वर में लॉगिन करना होगा। ऐसा करने के लिए, अपने पसंदीदा SSH क्लाइंट को खोलें।

ssh root@SERVER_IP

अपना पासवर्ड दर्ज करने के बाद (आप इसे Vultr डैशबोर्ड से प्राप्त कर सकते हैं) आपको अपने VPS में लॉग इन किया जाएगा।

Node.js और PM2 स्थापित करना

Raneto Node.js पर चलता है, एक जावास्क्रिप्ट रनटाइम और फ्रेमवर्क है। इस ट्यूटोरियल में, हम इसके दीर्घकालिक समर्थन के कारण Node.js v8 का उपयोग करेंगे। निम्न कमांड टाइप करके इंस्टालेशन शुरू करें।

curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -

इस स्क्रिप्ट के चलने के बाद, आप मुख्य स्थापना को चला सकते हैं।

sudo apt-get install -y nodejs

एक बार जब यह इंस्टॉलर समाप्त हो जाता है, तो आपके पास अपने VPS पर स्थापित Node.js की कॉपी की तारीख होगी। इसके बाद, हम PM2, Node.js के लिए एक प्रक्रिया प्रबंधक स्थापित करने जा रहे हैं जो रान्टो (और कई अन्य Node.js अनुप्रयोगों) को चलाना आसान बनाता है।

npm install pm2 -g

अब हमें वह सभी सॉफ्टवेयर मिल गए हैं जिन्हें हमें Raneto को स्थापित करने की आवश्यकता है।

रानितो को स्थापित करना

हम रनेटो रिपॉजिटरी को हमारे सर्वर पर क्लोन करने के लिए Git का उपयोग करने जा रहे हैं।

git clone https://github.com/gilbitron/Raneto.git

इससे एक फोल्डर बन जाएगा जिसका नाम है Raneto। फोल्डर डालें।

cd Raneto

एनपीएम स्थापित करें।

npm install

निम्न लिखकर गल्प चलाएं।

npm run gulp

एक बार जब गुल्प ने चलना शुरू कर दिया है, तो हम निम्नलिखित दो कमांडों में से एक का उपयोग करके अपना आवेदन शुरू कर सकते हैं।

npm start
# or
npm example/server.js

अब आप नेविगेट करके अपने नए Raneto इंस्टॉलेशन तक पहुँच प्राप्त कर सकेंगे SERVER_IP:3000। इस ट्यूटोरियल के बाकी हिस्से आपको सिखाएंगे कि कैसे रान्टो को कॉन्फ़िगर किया जाए, नए पेज बनाएं, श्रेणियां जोड़ें, सॉर्टिंग को एडजस्ट करें, कस्टम होमपेज जोड़ें और टेम्पलेट को एडिट करें।

आगे विन्यास

अब आपके पास एक डिफ़ॉल्ट रैन्टो इंस्टालेशन है जो आपके VPS पर होस्ट किया गया है। इससे पहले कि आप कुछ और करना शुरू करें, मेरा सुझाव है कि आप डिफ़ॉल्ट कॉन्फ़िगरेशन और सेटअप में कुछ बदलाव करें।

आइए एक नज़र डालें config.default.js, जो exampleफ़ोल्डर में स्थित है । यह कॉन्फिग फ़ाइल काफी लंबी है, लेकिन कृपया अधिक अभिभूत न करें, क्योंकि यह बहुत टिप्पणी की गई है। यहां वे गुण हैं जिन्हें आपको संपादित करना चाहिए:

• site_title - इसे अपनी वेबसाइट के शीर्षक में बदलें।
• base_url- यह आपकी साइट के URL पर सेट होना चाहिए। पृष्ठों को संपादित करते समय इसका उपयोग एक चर के रूप में किया जा सकता है।
• support_email- इसे एक मान्य ईमेल में बदलें। यह साइट के पाद लेख में दिखाई देगा।
• copyright - फूटर टेक्स्ट।
• analytics - यहां एक Google Analytics ट्रैकिंग कोड जोड़ें।
• allow_editing - क्या आप वेब एडिटर का उपयोग करके फ़ाइलों को संपादित करने में सक्षम होना चाहते हैं?
• authentication_for_read - क्या आप चाहते हैं कि लोग वेबसाइट देखने के लिए लॉग इन करें?
• credentials - लॉगिन सक्षम होने पर उपयोगकर्ताओं को यहां जोड़ें।
• locale - भाषा: हिन्दी।
• datetime_format - तारीख और समय का प्रारूप।
• home_meta - अपने मुखपृष्ठ की मेटा जानकारी को बदलने के लिए इसे संपादित करें।
• table_of_content - क्या रान्टो को सामग्री की एक तालिका प्रदर्शित करनी चाहिए?

ऑनलाइन संपादक का उपयोग करना

Raneto पृष्ठों, श्रेणियों और अधिक के प्रबंधन के लिए ऑनलाइन इंटरफ़ेस का उपयोग करना आसान है। हालांकि यह आपको सब कुछ करने की अनुमति नहीं देता है, यह निश्चित रूप से उपयोगी है यदि आपको चलते-फिरते एक त्वरित संपादन करने की आवश्यकता है।

आप इसे config.default.js(जैसा कि ऊपर बताया गया है) सेटिंग को सक्षम करके और फिर अपने VPS पर जाकर और दाएं कोने में लॉगिन बटन पर क्लिक करके इसे एक्सेस कर सकते हैं । अपना उपयोगकर्ता नाम और पासवर्ड दर्ज करें (आप इन्हें बदल सकते हैं config.default.js) और लॉगिन पर क्लिक करें। बस उस पृष्ठ पर क्लिक करें जिसे आपको संपादित करने की आवश्यकता है, Actionsड्रॉप-डाउन पर क्लिक करें और वह क्रिया चुनें जिसे आप पूरा करना चाहते हैं। आप +श्रेणी के नाम के आगे बटन दबाकर पृष्ठ जोड़ सकते हैं , और आप शीर्ष बाएँ हाथ के कोने में इनपुट फ़ील्ड का उपयोग करके श्रेणियां बना सकते हैं।

पेज जोड़ना

पृष्ठों को जोड़ना फ़ोल्डर .mdमें एक नया मार्काडाउन ( ) दस्तावेज़ बनाने जितना आसान है example/content।

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

/*
 Title: Enter your page title here, if none is added, the file-name will be used
 Description: Enter your page's description here (for search engines and the site search feature)
 ShowOnHome: true/false
 */

यदि आपको आवश्यकता है, तो आप अपने पृष्ठों में निम्नलिखित चर का उपयोग कर सकते हैं:

• %base_url% - इससे आप अपनी वेबसाइट के URL का उल्लेख कर सकते हैं।
• %image_url% - यह आपको अपनी छवि निर्देशिका का आधार URL प्राप्त करने की अनुमति देता है।

श्रेणियाँ जोड़ना

आप आसानी से अपने ज्ञान के आधार पर श्रेणियां जोड़ सकते हैं। बस निर्देशिका में एक नया फ़ोल्डर बनाएँ और उस फ़ोल्डर में example/contentआप जिस श्रेणी में होना चाहते हैं, उस पृष्ठ को डालें। उदाहरण के लिए, मान लें कि हम एक श्रेणी चाहते थे , helpजिसे पृष्ठों के साथ बुलाया गया था contact, help-meऔर awesome। फाइलें इस तरह दिखेंगी:

/example/content/help/contact.md
/example/content/help/help-me.md
/example/content/help/awesome.md

आप श्रेणियों के अंदर जितने चाहें उतने उप-फ़ोल्डर्स जोड़ सकते हैं।

श्रेणियों में मेटा जानकारी भी हो सकती है। metaश्रेणी फ़ोल्डर में नामक एक फ़ाइल बनाएँ । निम्नलिखित विशेषताएँ समर्थित हैं (सभी वैकल्पिक):

• शीर्षक - फ़ोल्डर के नाम के आधार पर शीर्षक को ओवरराइड करता है।
• सॉर्ट - आपको श्रेणियों के क्रम को क्रमबद्ध करने की अनुमति देता है, उसी तरह काम करता है जैसे पेजों को क्रमबद्ध करना।
• शोऑनहोम - सच / गलत।

कस्टम होमपेज

यदि आप एक कस्टम होमपेज जोड़ना चाहते हैं, तो आपको बस index.mdअपने example/contentफ़ोल्डर में मार्कडाउन फाइल करनी होगी ।

छँटाई पृष्ठ

Raneto स्वचालित रूप से पृष्ठों को वर्णानुक्रम में सॉर्ट करता है, लेकिन आप Sortपृष्ठ मेटा में एक आइटम जोड़कर एक मैनुअल प्रकार लागू कर सकते हैं । सॉर्ट का मान पूर्णांक होना चाहिए, उदाहरण के लिए:

Sort: 7

यह पेज अब 8 या अधिक के सॉर्ट वैल्यू वाले पेजों से पहले दिखाई देगा, लेकिन 6 या उससे कम मूल्य वाले पेजों के बाद।

टेम्पलेट बदलना

यदि आप HTML या CSS से परिचित हैं, तो आप आसानी से अपने Raneto इंस्टालेशन का लुक बदल सकते हैं। रान्टो हैंडलबार्स, एक जावास्क्रिप्ट टेम्प्लेटिंग भाषा का उपयोग करता है, जो HTML संपादन को संशोधित करता है। आप themes/defaultफ़ोल्डर में थीम फ़ाइलों को पा सकते हैं । यदि आप Renato टेम्प्लेट के संपादन के बारे में अधिक जानकारी चाहते हैं, तो आप उनके सहायता अनुभाग पर जा सकते हैं । एक बार जब आप टेम्पलेट को संपादित करना समाप्त कर लेते हैं, तो सुनिश्चित करें कि आप एप्लिकेशन को पुनः आरंभ करते हैं।