Raneto installimine Ubuntu 17.10-sse

Raneto on tasuta ja avatud lähtekoodiga teadmistebaas, mis on üles ehitatud Node.js-ile, mida on lihtne seadistada ja kasutada ning mida on lihtne hallata. Kategooriad ja lehed on kirjutatud Markdownis, mis muudab redigeerimise lihtsaks. Kui Markdown pole teie asi, võimaldab Raneto kasutada ka HTML-i.

Eeltingimused

• VPS, millele on installitud Ubuntu 17.10.
• SSH-juurdepääs teie VPS-ile.
• Algteadmised Linuxi terminalist.

Sisse logima

Esiteks peame SSH-ga oma serverisse sisse logima. Selleks avage oma lemmik SSH-klient.

ssh root@SERVER_IP

Pärast parooli sisestamist (saate selle Vultr armatuurlaualt) logitakse sisse oma VPS-i.

Node.js ja PM2 installimine

Raneto töötab saidil Node.js, mis on JavaScripti käituskeskkond ja raamistik. Selles õpetuses kasutame Node.js v8 selle pikaajalise toe tõttu. Käivitage installimine, tippides järgmise käsu.

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

Kui see skript on töötamise lõpetanud, saate käivitada põhiinstalli.

sudo apt-get install -y nodejs

Kui see installija on lõpetanud, on teie VPS-i installitud Node.js-i ajakohane koopia. Järgmisena installime Node.js-i protsessihalduri PM2, mis muudab Raneto (ja paljude teiste Node.js-i rakenduste) käitamise lihtsamaks.

npm install pm2 -g

Meil on nüüd kogu tarkvara, mida vajame Raneto installimiseks.

Raneto installimine

Kasutame Giti Raneto hoidla oma serverisse kloonimiseks.

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

See loob kausta nimega Raneto. Sisestage kaust.

cd Raneto

Installige NPM.

npm install

Käivitage Gulp, tippides järgmise.

npm run gulp

Kui Gulp on töötamise lõpetanud, saame oma rakenduse käivitada, kasutades ühte kahest järgmisest käsust.

npm start
# or
npm example/server.js

Nüüd pääsete oma uuele Raneto installile juurde, navigeerides aadressile SERVER_IP:3000. Selle õpetuse ülejäänud osa õpetab teile, kuidas Ranetot edasi konfigureerida, luua uusi lehti, lisada kategooriaid, kohandada sortimist, lisada kohandatud koduleht ja redigeerida malli.

Edasine konfiguratsioon

Nüüd on teie VPS-is hostitud Raneto vaikeinstallimine. Enne kui hakkate midagi muud tegema, soovitan teil teha mõned muudatused vaikekonfiguratsioonis ja seadistuses.

Vaatame kaustas config.default.jsasuvat example. See konfiguratsioonifail on üsna pikk, kuid ärge laske end üle koormata, kuna seda on palju kommenteeritud. Siin on omadused, mida peaksite redigeerima:

• site_title - Muutke see oma veebisaidi pealkirjaks.
• base_url- See peaks olema määratud teie saidi URL-ile. Seda saab lehtede redigeerimisel kasutada muutujana.
• support_email- Muutke see kehtivaks e-postiks. See kuvatakse saidi jaluses.
• copyright - jaluse tekst.
• analytics - Lisage siia Google Analyticsi jälgimiskood.
• allow_editing - Kas soovite faile veebiredaktoriga redigeerida?
• authentication_for_read - Kas soovite, et inimesed logiksid veebisaidi vaatamiseks sisse?
• credentials - Lisage siia kasutajaid, kui sisselogimine on lubatud.
• locale - Keel.
• datetime_format - Kuupäeva ja kellaaja vorming.
• home_meta - Muutke seda, et muuta oma kodulehe metateavet.
• table_of_content - Kas Raneto peaks kuvama sisukorra?

Veebiredaktori kasutamine

Ranetol on hõlpsasti kasutatav veebiliides lehtede, kategooriate ja muu haldamiseks. Kuigi see ei võimalda teil kõike teha, on see kindlasti kasulik, kui peate liikvel olles kiiresti muudatusi tegema.

Sellele pääsete juurde, lubades seaded config.default.js(nagu ülalpool mainitud) ja seejärel külastades oma VPS-i ja klõpsates paremas ülanurgas olevat sisselogimisnuppu. Sisestage oma kasutajanimi ja parool (saate neid muuta config.default.js) ja klõpsake nuppu Logi sisse. Klõpsake lihtsalt lehel, mida soovite muuta, klõpsake Actionsrippmenüüd ja valige toiming, mida soovite lõpule viia. Lehtede lisamiseks vajutage +kategooria nime kõrval olevat nuppu ja kategooriaid saate luua vasakpoolses ülanurgas asuva sisestusvälja abil.

Lehtede lisamine

Lehtede lisamine on sama lihtne kui uue Markdowni ( .md) dokumendi loomine example/contentkaustas.

Kui olete uue Markdown-faili loonud, on oluline lisada faili ülaossa põhiteavet. Avage fail oma lemmiktekstiredaktoris. Peame faili ülaossa lisama järgmise.

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

Vajadusel saate oma lehtedel kasutada ka järgmisi muutujaid.

• %base_url% - See võimaldab teil mainida oma veebisaidi URL-i.
• %image_url% - See võimaldab teil saada oma piltide kataloogi baas-URL-i.

Kategooriate lisamine

Saate hõlpsasti oma teadmistebaasi kategooriaid lisada. Looge lihtsalt example/contentkataloogis uus kaust ja pange sellesse kausta lehed, mida soovite sellesse kategooriasse kuuluda. Oletame näiteks, et soovime kategooriat, helpmille lehed on contact, help-meja awesome. Failid näeksid välja sellised:

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

Kategooriatesse saate lisada nii palju alamkaustu, kui soovite.

Kategooriatel võib olla ka metateavet. Looge fail nimega metakategooria kausta. Toetatud on järgmised atribuudid (kõik valikulised):

• Pealkiri – alistab pealkirja kausta nime alusel.
• Sordi – võimaldab sortida kategooriate järjekorda, toimib samamoodi nagu lehtede sortimine.
• ShowOnHome – tõene/väär.

Kohandatud koduleht

Kui soovite lisada kohandatud kodulehte, peate vaid lisama index.mdoma example/contentkausta kutsutud märgistusfaili .

Lehtede sortimine

Raneto sorteerib lehed automaatselt tähestikulises järjekorras, kuid saate rakendada käsitsi sortimist, lisades Sortlehe metasse üksuse. Sortimise väärtus peab olema täisarv, näiteks:

Sort: 7

See leht ilmub nüüd enne lehekülgi, mille sortimisväärtus on 8 või rohkem, kuid pärast lehekülgi, mille väärtus on 6 või vähem.

Malli muutmine

Kui olete HTML-i või CSS-iga tuttav, saate oma Raneto installi välimust hõlpsalt muuta. Raneto kasutab juhtrauda, ​​JavaScripti mallikeelt, mis moduleerib HTML-i redigeerimist. Teemafailid leiate themes/defaultkaustast. Kui soovite Renato mallide redigeerimise kohta lisateavet, külastage nende abijaotist . Kui olete malli redigeerimise lõpetanud, taaskäivitage rakendus.