كيفية تثبيت رانيتو على أوبونتو 17.10

• المتطلبات الأساسية
• تسجيل الدخول
• تثبيت Node.js & PM2
• تركيب رانيتو
• مزيد من التكوين
• إضافة صفحات
• إضافة فئات

رانيتو هي قاعدة معرفة مجانية ومفتوحة المصدر ، مبنية على Node.js سهلة الإعداد والاستخدام ، بالإضافة إلى سهولة إدارتها. تتم كتابة الفئات والصفحات في Markdown ، مما يسهل التحرير. إذا لم يكن Markdown هو الشيء الذي تفضله ، يتيح لك Raneto أيضًا استخدام HTML.

المتطلبات الأساسية

• تم تثبيت VPS مع Ubuntu 17.10.
• وصول SSH إلى VPS الخاص بك.
• الفهم الأساسي لمحطة Linux.

تسجيل الدخول

أولاً ، نحتاج إلى تسجيل الدخول إلى خادمنا باستخدام 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

بمجرد الانتهاء من هذا المثبت ، سيكون لديك نسخة محدثة من Node.js مثبتة على VPS الخاص بك. بعد ذلك ، سنقوم بتثبيت PM2 ، مدير العمليات لـ Node.js الذي يجعل تشغيل Raneto (والعديد من تطبيقات Node.js الأخرى) أسهل.

npm install pm2 -g

لدينا الآن جميع البرامج التي نحتاجها لتثبيت Raneto.

تركيب رانيتو

سنستخدم Git لاستنساخ مستودع Raneto على خادمنا.

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

سيؤدي هذا إلى إنشاء مجلد يسمى Raneto. أدخل المجلد.

cd Raneto

تثبيت NPM.

npm install

قم بتشغيل Gulp بكتابة ما يلي.

npm run gulp

بمجرد انتهاء Gulp من التشغيل ، يمكننا بدء تطبيقنا باستخدام أحد الأمرين التاليين.

npm start
# or
npm example/server.js

ستتمكن الآن من الوصول إلى تثبيت Raneto الجديد من خلال الانتقال إلى SERVER_IP:3000. سيعلمك باقي هذا البرنامج التعليمي كيفية تكوين Raneto بشكل إضافي ، وإنشاء صفحات جديدة ، وإضافة فئات ، وضبط التصنيف ، وإضافة صفحة رئيسية مخصصة وتحرير القالب.

مزيد من التكوين

لديك الآن تثبيت Raneto افتراضي مستضاف على 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المنسدلة واختر الإجراء الذي تريد إكماله. يمكنك إضافة صفحات بالضغط على +الزر الموجود بجوار اسم الفئة ، ويمكنك إنشاء فئات باستخدام حقل الإدخال في الزاوية العلوية اليسرى.

إضافة صفحات

إن إضافة الصفحات بسيطة مثل إنشاء مستند Markdown ( .md) جديد في example/contentالمجلد.

بمجرد إنشاء ملف Markdown جديد ، من المهم أن تضيف بعض المعلومات الأساسية إلى أعلى الملف. افتح الملف في محرر النصوص المفضل لديك. نحتاج إلى إضافة ما يلي إلى أعلى الملف.

/*
 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في مجلد الفئة. السمات التالية مدعومة (جميعها اختيارية):

• العنوان - يتجاوز العنوان بناءً على اسم المجلد.
• فرز - يسمح لك بفرز الفئات ، ويعمل بنفس طريقة فرز الصفحات.
• ShowOnHome - صواب / خطأ.

الصفحة الرئيسية المخصصة

إذا كنت ترغب في إضافة صفحة رئيسية مخصصة ، فكل ما عليك فعله هو إضافة ملف تخفيض index.mdإلى example/contentمجلدك.

فرز الصفحات

يقوم Raneto تلقائيًا بفرز الصفحات أبجديًا ، ولكن يمكنك تطبيق فرز يدوي عن طريق إضافة Sortعنصر إلى تعريف الصفحة. يجب أن تكون قيمة الفرز عددًا صحيحًا ، على سبيل المثال:

Sort: 7

ستظهر هذه الصفحة الآن قبل الصفحات ذات قيمة الفرز 8 أو أكثر ، ولكن بعد الصفحات التي تبلغ قيمتها 6 أو أقل.

تغيير القالب

إذا كنت معتادًا على استخدام HTML أو CSS ، فيمكنك بسهولة تغيير مظهر تثبيت Raneto. يستخدم رانيتو المقاود ، وهي لغة نموذجية لجافا سكريبت ، تعمل على تعديل تحرير HTML. يمكنك العثور على ملفات السمات في themes/defaultالمجلد. إذا كنت تريد المزيد من المعلومات حول تحرير قوالب Renato ، فيمكنك زيارة قسم المساعدة الخاص بهم . بمجرد الانتهاء من تحرير القالب ، تأكد من إعادة تشغيل التطبيق.