Kā instalēt Raneto Ubuntu 17.10

Raneto ir bezmaksas atvērtā koda zināšanu bāze, kas izveidota, izmantojot Node.js un kuru ir viegli iestatīt un lietot, kā arī viegli administrēt. Kategorijas un lapas tiek rakstītas programmā Markdown, kas atvieglo rediģēšanu. Ja Markdown jums nepatīk, Raneto ļauj izmantot arī HTML.

Priekšnoteikumi

• VPS ar instalētu Ubuntu 17.10.
• SSH piekļuve jūsu VPS.
• Pamata izpratne par Linux termināli.

Ielogoties

Pirmkārt, mums ir jāpiesakās mūsu serverī, izmantojot SSH. Lai to izdarītu, atveriet savu iecienītāko SSH klientu.

ssh root@SERVER_IP

Pēc paroles ievadīšanas (to varat iegūt Vultr informācijas panelī) tiksiet pieteicies savā VPS.

Node.js un PM2 instalēšana

Raneto darbojas vietnē Node.js — JavaScript izpildlaikā un sistēmā. Šajā apmācībā mēs izmantosim Node.js v8 tā ilgtermiņa atbalsta dēļ. Sāciet instalēšanu, ierakstot šādu komandu.

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

Kad šis skripts ir beidzies, varat palaist galveno instalāciju.

sudo apt-get install -y nodejs

Kad šī instalēšanas programma būs pabeigta, jūsu VPS būs instalēta atjaunināta Node.js kopija. Pēc tam mēs instalēsim PM2 — Node.js procesa pārvaldnieku, kas atvieglo Raneto (un daudzu citu Node.js lietojumprogrammu) palaišanu.

npm install pm2 -g

Tagad mums ir visa programmatūra, kas nepieciešama, lai instalētu Raneto.

Raneto instalēšana

Mēs izmantosim Git, lai klonētu Raneto repozitoriju mūsu serverī.

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

Tādējādi tiks izveidota mape ar nosaukumu Raneto. Ievadiet mapi.

cd Raneto

Instalējiet NPM.

npm install

Palaidiet Gulp, ierakstot šo.

npm run gulp

Kad Gulp darbība ir pabeigta, mēs varam palaist savu lietojumprogrammu, izmantojot vienu no divām tālāk norādītajām komandām.

npm start
# or
npm example/server.js

Tagad varēsiet piekļūt savai jaunajai Raneto instalācijai, pārejot uz SERVER_IP:3000. Pārējā šīs apmācības daļa iemācīs, kā tālāk konfigurēt Raneto, izveidot jaunas lapas, pievienot kategorijas, pielāgot kārtošanu, pievienot pielāgotu sākumlapu un rediģēt veidni.

Papildu konfigurācija

Tagad jūsu VPS ir mitināta noklusējuma Raneto instalācija. Pirms sākat darīt kaut ko citu, iesaku veikt dažas izmaiņas noklusējuma konfigurācijā un iestatījumos.

Apskatīsim config.default.js, kas atrodas examplemapē. Šis konfigurācijas fails ir diezgan garš, taču, lūdzu, neesiet satriekts, jo tas ir daudz komentēts. Šeit ir rekvizīti, kas jums jārediģē:

• site_title - Mainiet to uz savas vietnes nosaukumu.
• base_url- Tas ir jāiestata uz jūsu vietnes URL. To var izmantot kā mainīgo, rediģējot lapas.
• support_email- Mainiet to uz derīgu e-pastu. Tas tiks parādīts vietnes kājenē.
• copyright - Kājenes teksts.
• analytics - Šeit pievienojiet Google Analytics izsekošanas kodu.
• allow_editing - Vai vēlaties rediģēt failus, izmantojot tīmekļa redaktoru?
• authentication_for_read - Vai vēlaties, lai cilvēki pieteiktos, lai skatītu vietni?
• credentials - Pievienojiet lietotājus šeit, ja ir iespējota pieteikšanās.
• locale - Valoda.
• datetime_format - Datuma un laika formāts.
• home_meta - Rediģējiet šo, lai mainītu savas sākumlapas metainformāciju.
• table_of_content - Vai Raneto vajadzētu rādīt satura rādītāju?

Tiešsaistes redaktora izmantošana

Raneto ir viegli lietojams tiešsaistes interfeiss lapu, kategoriju un citu pārvaldīšanai. Lai gan tas neļauj jums darīt visu, tas noteikti ir noderīgi, ja jums ir nepieciešams ātri rediģēt, atrodoties ceļā.

Tam var piekļūt, iespējojot iestatījumu config.default.js(kā minēts iepriekš) un pēc tam apmeklējot savu VPS un noklikšķinot uz pieteikšanās pogas augšējā labajā stūrī. Ievadiet savu lietotājvārdu un paroli (to varat mainīt config.default.js) un noklikšķiniet uz Pieteikties. Vienkārši noklikšķiniet uz rediģējamās lapas, noklikšķiniet uz Actionsnolaižamās izvēlnes un izvēlieties darbību, kuru vēlaties pabeigt. Varat pievienot lapas, nospiežot +pogu blakus kategorijas nosaukumam, un varat izveidot kategorijas, izmantojot ievades lauku augšējā kreisajā stūrī.

Lapu pievienošana

Lapu pievienošana ir tikpat vienkārša kā jauna Markdown ( .md) dokumenta izveide example/contentmapē.

Kad esat izveidojis jaunu Markdown failu, ir svarīgi faila augšdaļā pievienot pamatinformāciju. Atveriet failu savā iecienītākajā teksta redaktorā. Faila augšpusē mums jāpievieno tālāk norādītais.

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

Ja nepieciešams, savās lapās varat izmantot arī šādus mainīgos:

• %base_url% - Tas ļauj minēt savas vietnes URL.
• %image_url% - Tas ļauj iegūt attēla direktorijas pamata URL.

Kategoriju pievienošana

Jūs varat viegli pievienot kategorijas savai zināšanu bāzei. Vienkārši izveidojiet example/contentdirektorijā jaunu mapi un ievietojiet tajā lapas, kuras vēlaties iekļaut šajā kategorijā. Piemēram, pieņemsim, ka mēs vēlējāmies kategoriju helpar lapām ar nosaukumu contact, help-meun awesome. Faili izskatītos šādi:

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

Kategorijās varat pievienot tik daudz apakšmapju, cik vēlaties.

Kategorijām var būt arī metainformācija. Izveidojiet failu, kas tiek izsaukts metakategorijas mapē. Tiek atbalstīti šādi atribūti (visi nav obligāti):

• Title — ignorē nosaukumu, pamatojoties uz mapes nosaukumu.
• Kārtot — ļauj kārtot kategoriju secību, darbojas tāpat kā lapu kārtošana.
• ShowOnHome — patiess/nepatiess.

Pielāgota mājas lapa

Ja vēlaties pievienot pielāgotu mājaslapu, viss, kas jums jādara, ir pievienot pazeminājumu failu ar nosaukumu index.mdjūsu example/contentmapē.

Lapu šķirošana

Raneto automātiski kārto lapas alfabētiskā secībā, taču varat lietot manuālu kārtošanu, pievienojot Sortlapu metam vienumu. Kārtošanas vērtībai ir jābūt veselam skaitlim, piemēram:

Sort: 7

Šī lapa tagad tiks parādīta pirms lapām, kuru kārtošanas vērtība ir 8 vai lielāka, bet pēc lapām, kuru vērtība ir 6 vai mazāka.

Veidnes maiņa

Ja esat pazīstams ar HTML vai CSS, varat viegli mainīt Raneto instalācijas izskatu. Raneto izmanto stūri, JavaScript veidņu valodu, kas modulē HTML rediģēšanu. Motīvu failus var atrast themes/defaultmapē. Ja vēlaties iegūt plašāku informāciju par Renato veidņu rediģēšanu, varat apmeklēt viņu palīdzības sadaļu . Kad esat pabeidzis veidnes rediģēšanu, noteikti restartējiet lietojumprogrammu.