Kaip įdiegti „Raneto“ Ubuntu 17.10

„Raneto“ yra nemokama atvirojo kodo žinių bazė, sukurta naudojant Node.js, kurią lengva nustatyti ir naudoti, taip pat lengva administruoti. Kategorijos ir puslapiai parašyti Markdown, todėl juos lengva redaguoti. Jei Markdown nėra jūsų dalykas, Raneto taip pat leidžia naudoti HTML.

Būtinos sąlygos

• VPS su įdiegta Ubuntu 17.10.
• SSH prieiga prie jūsų VPS.
• Pagrindinis Linux terminalo supratimas.

Prisijungiama

Pirmiausia turime prisijungti prie savo serverio naudodami SSH. Norėdami tai padaryti, atidarykite mėgstamą SSH klientą.

ssh root@SERVER_IP

Įvedę slaptažodį (jį galite gauti iš „Vultr“ prietaisų skydelio), būsite prisijungę prie savo VPS.

Node.js ir PM2 diegimas

„Raneto“ veikia „Node.js“, „Javascript“ vykdymo laiku ir sistema. Šioje mokymo programoje naudosime Node.js v8 dėl jos ilgalaikio palaikymo. Pradėkite diegimą įvesdami šią komandą.

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

Pasibaigus šiam scenarijui, galite paleisti pagrindinį diegimą.

sudo apt-get install -y nodejs

Kai ši diegimo programa bus baigta, jūsų VPS turėsite įdiegtą naujausią Node.js kopiją. Tada įdiegsime PM2 – Node.js procesų tvarkyklę, kuri palengvina Raneto (ir daugelio kitų Node.js programų) paleidimą.

npm install pm2 -g

Dabar turime visą programinę įrangą, kurios reikia norint įdiegti „Raneto“.

Raneto diegimas

Mes ketiname naudoti Git, kad klonuotume Raneto saugyklą į savo serverį.

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

Taip bus sukurtas aplankas pavadinimu Raneto. Įveskite aplanką.

cd Raneto

Įdiekite NPM.

npm install

Paleiskite „Gulp“ įvesdami toliau pateiktą informaciją.

npm run gulp

Kai „Gulp“ baigs veikti, galime paleisti programą naudodami vieną iš dviejų toliau nurodytų komandų.

npm start
# or
npm example/server.js

Dabar galėsite pasiekti naują „Raneto“ diegimą eidami į SERVER_IP:3000. Likusioje šio vadovo dalyje išmokysite toliau konfigūruoti Raneto, kurti naujus puslapius, pridėti kategorijas, koreguoti rūšiavimą, pridėti pasirinktinį pagrindinį puslapį ir redaguoti šabloną.

Tolesnė konfigūracija

Dabar jūsų VPS yra numatytasis „Raneto“ diegimas. Prieš pradedant daryti ką nors kita, siūlau atlikti keletą numatytosios konfigūracijos ir sąrankos pakeitimų.

Pažvelkime į config.default.js, esantį exampleaplanke. Šis konfigūracijos failas yra gana ilgas, bet nesijaudinkite, nes jis labai komentuojamas. Štai ypatybės, kurias turėtumėte redaguoti:

• site_title - Pakeiskite tai į savo svetainės pavadinimą.
• base_url– Tai turėtų būti nustatyta kaip jūsų svetainės URL. Jis gali būti naudojamas kaip kintamasis redaguojant puslapius.
• support_email– Pakeiskite tai į galiojantį el. Jis bus rodomas svetainės poraštėje.
• copyright - Poraštės tekstas.
• analytics – Čia pridėkite „Google Analytics“ stebėjimo kodą.
• allow_editing – Ar norite turėti galimybę redaguoti failus naudodami žiniatinklio rengyklę?
• authentication_for_read – Ar norite, kad žmonės prisijungtų norėdami peržiūrėti svetainę?
• credentials - Pridėkite vartotojų čia, jei įjungtas prisijungimas.
• locale – Kalba.
• datetime_format - Datos ir laiko formatas.
• home_meta - Redaguokite tai, kad pakeistumėte pagrindinio puslapio meta informaciją.
• table_of_content – Ar Raneto turėtų rodyti turinį?

Internetinės redaktoriaus naudojimas

„Raneto“ yra su paprasta naudoti internetine sąsaja, skirta puslapiams, kategorijoms ir kt. tvarkyti. Nors tai neleidžia daryti visko, tai tikrai naudinga, jei reikia greitai redaguoti keliaujant.

Jį galite pasiekti įjungę nustatymą config.default.js(kaip minėta aukščiau), tada apsilankę savo VPS ir spustelėję prisijungimo mygtuką viršutiniame dešiniajame kampe. Įveskite savo vartotojo vardą ir slaptažodį (juos galite pakeisti config.default.js) ir spustelėkite prisijungti. Tiesiog spustelėkite puslapį, kurį norite redaguoti, spustelėkite Actionsišskleidžiamąjį meniu ir pasirinkite veiksmą, kurį norite atlikti. Puslapius galite pridėti paspausdami +šalia kategorijos pavadinimo esantį mygtuką, o kategorijas galite kurti naudodami įvesties lauką viršutiniame kairiajame kampe.

Puslapių pridėjimas

Puslapių pridėjimas yra taip paprasta, kaip aplanke sukurti naują Markdown ( .md) dokumentą example/content.

Sukūrę naują Markdown failą, svarbu, kad failo viršuje pridėtumėte pagrindinę informaciją. Atidarykite failą mėgstamoje teksto rengyklėje. Failo viršuje turime pridėti šiuos dalykus.

/*
 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
 */

Jei reikia, savo puslapiuose taip pat galite naudoti šiuos kintamuosius:

• %base_url% – Tai leidžia paminėti savo svetainės URL.
• %image_url% - Tai leidžia gauti pagrindinį vaizdų katalogo URL.

Kategorijų pridėjimas

Galite lengvai įtraukti kategorijas į savo žinių bazę. Tiesiog sukurkite naują aplanką example/contentkataloge ir įdėkite puslapius, kuriuos norite įtraukti į tą kategoriją. Pavyzdžiui, tarkime, mes norėjome kategoriją, pavadintą helpsu puslapių, vadinamų contact, help-meir awesome. Failai atrodytų taip:

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

Kategorijų viduje galite pridėti tiek poaplankių, kiek norite.

Kategorijos taip pat gali turėti meta informaciją. Sukurkite failą, pavadintą metakategorijos aplanke. Palaikomi šie atributai (visi neprivalomi):

• Pavadinimas – nepaiso pavadinimo pagal aplanko pavadinimą.
• Rūšiuoti – leidžia rūšiuoti kategorijų tvarką, veikia taip pat, kaip rūšiuojant puslapius.
• ShowOnHome – tiesa / klaidinga.

Pasirinktinis pagrindinis puslapis

Jei norite pridėti pasirinktinį pagrindinį puslapį, viskas, ką jums reikia padaryti, tai pridėti žymėjimo failą, pavadintą index.mdjūsų example/contentaplanke.

Puslapių rūšiavimas

„Raneto“ automatiškai rūšiuoja puslapius abėcėlės tvarka, tačiau galite taikyti rankinį rūšiavimą įtraukdami Sortelementą prie puslapio meta. Rūšiavimo reikšmė turi būti sveikasis skaičius, pavyzdžiui:

Sort: 7

Šis puslapis dabar bus rodomas prieš puslapius, kurių rūšiavimo reikšmė yra 8 ar daugiau, bet po puslapių, kurių vertė yra 6 ar mažesnė.

Šablono keitimas

Jei esate susipažinę su HTML arba CSS, galite lengvai pakeisti Raneto diegimo išvaizdą. „Raneto“ naudoja rankenas, „JavaScript“ šablonų kalbą, kuri moduliuoja HTML redagavimą. themes/defaultAplanke galite rasti temų failus . Jei norite gauti daugiau informacijos apie Renato šablonų redagavimą, galite apsilankyti jų pagalbos skiltyje . Baigę redaguoti šabloną, būtinai paleiskite programą iš naujo.