Cum se instalează Raneto pe Ubuntu 17.10

• Cerințe preliminare
• Logare
• Instalarea Node.js & PM2
• Instalarea Raneto
• Configurare suplimentară
• Adăugarea de pagini
• Adăugarea de categorii

Raneto este o bază de cunoștințe gratuite și open-source, construită pe Node.js care este ușor de configurat și utilizat, precum și ușor de administrat. Categoriile și paginile sunt scrise în Markdown, ceea ce face ușor de editat. Dacă Markdown nu este lucrul tău, Raneto îți permite, de asemenea, să folosești HTML.

Cerințe preliminare

• A fost instalat un VPS cu Ubuntu 17.10.
• Acces SSH la VPS.
• Înțelegere de bază a terminalului Linux.

Logare

În primul rând, trebuie să ne conectăm la serverul nostru folosind SSH. Pentru a face acest lucru, deschideți-vă clientul SSH preferat.

ssh root@SERVER_IP

După introducerea parolei (o puteți obține din tabloul de bord Vultr) veți fi conectat la VPS.

Instalarea Node.js & PM2

Raneto rulează pe Node.js, un runtime și cadru javascript. În acest tutorial, vom folosi Node.js v8 datorită suportului său pe termen lung. Începeți instalarea tastând următoarea comandă.

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

După ce acest script a terminat de rulat, puteți rula instalarea principală.

sudo apt-get install -y nodejs

După ce acest program de instalare s-a terminat, veți avea o copie actualizată a Node.js instalată pe VPS. În continuare, vom instala PM2, un manager de proces pentru Node.js, care facilitează rularea Raneto (și multe alte aplicații Node.js).

npm install pm2 -g

Avem acum tot software-ul de care avem nevoie pentru a instala Raneto.

Instalarea Raneto

Vom folosi Git pentru a clona depozitul Raneto pe serverul nostru.

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

Aceasta va crea un folder numit Raneto. Introduceți folderul.

cd Raneto

Instalați NPM.

npm install

Rulați Gulp tastând următoarele.

npm run gulp

După ce Gulp a terminat de rulat, putem începe aplicația folosind una dintre cele două comenzi următoare.

npm start
# or
npm example/server.js

Acum veți putea accesa noua dvs. instalație Raneto, navigând către SERVER_IP:3000. Restul acestui tutorial vă va învăța cum să configurați mai departe Raneto, să faceți pagini noi, să adăugați categorii, să reglați sortarea, să adăugați o pagină de pornire personalizată și să editați șablonul.

Configurare suplimentară

Acum aveți o instalare Raneto implicită găzduită pe VPS. Înainte de a începe să faci orice altceva, îți sugerez să faci câteva modificări la configurația și configurația implicită.

Să aruncăm o privire config.default.js, care se află în examplefolder. Acest fișier de configurare este destul de lung, dar vă rugăm să nu vă copleșiți, deoarece este foarte comentat. Iată proprietățile pe care ar trebui să le editați:

• site_title - Modificați acest lucru în titlul site-ului dvs.
• base_url- Aceasta trebuie să fie setată pe adresa URL a site-ului dvs. Poate fi folosită ca o variabilă la editarea paginilor.
• support_email- Modificați acest lucru într-un e-mail valid. Va apărea în subsolul site-ului.
• copyright - Text de subsol.
• analytics - Adăugați aici un cod de urmărire Google Analytics.
• allow_editing - Vrei să poți edita fișiere folosind editorul web?
• authentication_for_read - Vrei ca oamenii să se autentifice pentru a vizualiza site-ul web?
• credentials - Adăugați utilizatori aici dacă conectarea este activată.
• locale - Limba.
• datetime_format - formatul datei și orei.
• home_meta - Editați acest lucru pentru a schimba informațiile meta ale paginii dvs. de pornire.
• table_of_content - Raneto ar trebui să afișeze un conținut?

Utilizarea editorului online

Raneto vine cu o interfață online ușor de utilizat pentru gestionarea paginilor, categoriilor și altele. Deși nu vă permite să faceți totul, cu siguranță este util dacă trebuie să faceți o editare rapidă din mers.

Îl puteți accesa activând setarea config.default.js(după cum am menționat mai sus), apoi vizitând VPS-ul dvs. și făcând clic pe butonul de conectare din colțul din dreapta sus. Introduceți numele de utilizator și parola (le puteți modifica config.default.js) și faceți clic pe autentificare. Pur și simplu faceți clic pe pagina pe care trebuie să o editați, faceți clic pe Actionsmeniul derulant și alegeți acțiunea pe care doriți să o finalizați. Puteți adăuga pagini apăsând +butonul de lângă numele categoriei și puteți crea categorii folosind câmpul de introducere din colțul din stânga sus.

Adăugarea de pagini

Adăugarea de pagini este la fel de simplă precum crearea unui nou .mddocument Markdown ( ) în example/contentfolder.

După ce ați creat un nou fișier Markdown, este important să adăugați câteva informații de bază în partea de sus a fișierului. Deschideți fișierul în editorul de text preferat. Trebuie să adăugăm următoarele în partea de sus a fișierului.

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

Dacă aveți nevoie, puteți utiliza, de asemenea, următoarele variabile în paginile dvs.:

• %base_url% - Acest lucru vă permite să menționați adresa URL a site-ului dvs. web.
• %image_url% - Acest lucru vă permite să obțineți adresa URL de bază a directorului dvs. de imagini.

Adăugarea de categorii

Puteți adăuga categorii la baza de cunoștințe cu ușurință. Creați doar un director nou în example/contentdirector și puneți paginile pe care doriți să le faceți în acea categorie în acel folder. De exemplu, să zicem ne - am dorit o categorie numită helpcu pagini numite contact, help-meși awesome. Fișierele ar arăta astfel:

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

Puteți adăuga cât mai multe sub-foldere doriți în categorii.

Categoriile pot avea și informații meta. Creați un fișier numit metaîn folderul de categorii. Sunt acceptate următoarele atribute (toate opționale):

• Titlu - Înlocuiește titlul bazat pe numele folderului.
• Sortare - Vă permite să sortați ordinea categoriilor, funcționează la fel ca sortarea paginilor.
• ShowOnHome - adevărat / fals.

Pagina personalizată personalizată

Dacă doriți să adăugați o pagină de pornire personalizată, tot ce trebuie să faceți este să adăugați un fișier marcator apelat index.mdla example/contentfolderul dvs.

Sortarea paginilor

Raneto sortează automat paginile în ordine alfabetică, dar puteți aplica un sortare manuală adăugând un Sortelement la meta pagina. Valoarea sortului trebuie să fie un număr întreg, de exemplu:

Sort: 7

Această pagină ar apărea acum înainte de pagini cu o valoare de sortare de 8 sau mai multe, dar după pagini cu o valoare de 6 sau mai puțin.

Modificarea șablonului

Dacă sunteți familiarizat cu HTML sau CSS, puteți modifica cu ușurință aspectul instalării dvs. Raneto. Raneto folosește Handlebars, un limbaj de șablonare JavaScript, care modularizează editarea HTML. Puteți găsi fișierele temă în themes/defaultfolder. Dacă doriți mai multe informații despre editarea șabloanelor Renato, puteți accesa secțiunea de ajutor a acestora . După ce ați terminat de editat șablonul, asigurați-vă că reporniți aplicația.