نحوه نصب Raneto در اوبونتو 17.10

• پیش نیازها
• ورود به سیستم در
• نصب Node.js و PM2
• نصب Raneto
• پیکربندی بیشتر
• افزودن صفحات
• افزودن دسته ها

Raneto یک پایگاه دانش آزاد و منبع باز است ، که در Node.js ساخته شده است و نصب و راه اندازی آن آسان است و همچنین به راحتی قابل اجرا است. دسته ها و صفحات در Markdown نوشته شده اند ، که این امر ویرایش را آسان می کند. اگر Markdown چیز شما نیست ، Raneto همچنین به شما امکان می دهد از HTML استفاده کنید.

پیش نیازها

• VPS با اوبونتو 17.10 نصب شده است.
• دسترسی به 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

پس از پایان یافتن این نصب ، نسخه جدیدی از Node.js را در VPS خود نصب خواهید کرد. در مرحله بعد ، ما قصد داریم PM2 ، یک مدیر پروسه برای Node.js را نصب کنیم که اجرای Raneto (و بسیاری از برنامه های دیگر Node.js) را آسان تر می کند.

npm install pm2 -g

اکنون همه نرم افزاری را که برای نصب Raneto نیاز داریم دریافت کرده ایم.

نصب Raneto

ما می خواهیم از Git برای کلون کردن مخزن Raneto به سرور خود استفاده کنیم.

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

با این کار پوشه ای به نام ایجاد می شود Raneto. پوشه را وارد کنید.

cd Raneto

NPM را نصب کنید.

npm install

با تایپ کردن موارد زیر ، گلپ را اجرا کنید.

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- این باید بر روی آدرس سایت شما تنظیم شود. این می تواند به عنوان یک متغیر هنگام ویرایش صفحات استفاده شود.
• support_email- این را به یک ایمیل معتبر تغییر دهید. در پاورقی سایت نشان داده خواهد شد.
• copyright - متن صفحه.
• analytics - یک کد رهگیری Google Analytics را در اینجا اضافه کنید.
• allow_editing - آیا می خواهید با استفاده از ویرایشگر وب قادر به ویرایش فایلها باشید؟
• authentication_for_read - آیا می خواهید افراد برای مشاهده وب سایت وارد سیستم شوند؟
• credentials - در صورت فعال بودن ورود به سیستم ، کاربران را به اینجا اضافه کنید.
• locale - زبان.
• datetime_format - قالب تاریخ و زمان.
• home_meta - این را ویرایش کنید تا اطلاعات متا صفحه اصلی خود را تغییر دهید.
• table_of_content - آیا Raneto باید فهرست مطالب را نشان دهد؟

با استفاده از ویرایشگر آنلاین

Raneto دارای رابط کاربری آنلاین آسان برای مدیریت صفحات ، دسته ها و موارد دیگر است. اگرچه به شما امکان نمی دهد همه کارها را انجام دهید ، اگر نیاز به ویرایش سریع داشته باشید ، مطمئناً مفید است.

با فعال کردن تنظیمات در config.default.js(همانطور که در بالا گفته شد) می توانید به آن دسترسی داشته باشید و سپس به VPS خود مراجعه کرده و روی دکمه ورود در گوشه بالا سمت راست کلیک کنید. نام کاربری و رمز عبور خود را وارد کنید (می توانید این موارد را تغییر دهید config.default.js) و روی ورود به سیستم کلیک کنید. به سادگی بر روی صفحه مورد نظر خود برای ویرایش کلیک کنید ، روی Actionsکشویی کلیک کنید و عملی را که می خواهید تکمیل کنید انتخاب کنید. می توانید صفحات را با فشار دادن +دکمه کنار نام دسته اضافه کنید و می توانید با استفاده از قسمت ورودی در گوشه سمت چپ بالا ، دسته هایی را ایجاد کنید.

افزودن صفحات

اضافه کردن صفحات به سادگی ایجاد یک .mdسند جدید Markdown ( ) در 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 خود را تغییر دهید. Raneto از Handlebars ، یک زبان دلخواه JavaScript استفاده می کند ، که ویرایش HTML را تغییر می دهد. می توانید فایل های تم را در themes/defaultپوشه پیدا کنید. اگر می خواهید اطلاعات بیشتری درباره ویرایش الگوهای Renato داشته باشید ، می توانید به بخش راهنمای آنها مراجعه کنید . پس از پایان ویرایش قالب ، مطمئن شوید که برنامه را مجدداً راه اندازی کرده اید.