Kako namestiti Raneto na Ubuntu 17.10

Raneto je brezplačna in odprtokodna baza znanja, zgrajena na Node.js, ki je enostavna za nastavitev in uporabo ter enostavna za upravljanje. Kategorije in strani so zapisane v Markdownu, kar olajša urejanje. Če Markdown ni vaša stvar, vam Raneto omogoča tudi uporabo HTML.

Predpogoji

• VPS z nameščenim Ubuntu 17.10.
• SSH dostop do vašega VPS.
• Osnovno razumevanje terminala Linux.

Prijavljanje

Najprej se moramo prijaviti v naš strežnik s pomočjo SSH. Če želite to narediti, odprite svoj najljubši odjemalec SSH.

ssh root@SERVER_IP

Po vnosu gesla (lahko ga dobite na nadzorni plošči Vultr) boste prijavljeni v svoj VPS.

Namestitev Node.js in PM2

Raneto deluje na Node.js, izvajalnem okolju in ogrodju javascript. V tej vadnici bomo uporabljali Node.js v8 zaradi njegove dolgoročne podpore. Začnite namestitev tako, da vnesete naslednji ukaz.

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

Ko se ta skript zažene, lahko zaženete glavno namestitev.

sudo apt-get install -y nodejs

Ko bo ta namestitveni program končan, boste imeli na vašem VPS nameščeno posodobljeno kopijo Node.js. Nato bomo namestili PM2, upravljalnik procesov za Node.js, ki olajša izvajanje Raneto (in mnogih drugih aplikacij Node.js).

npm install pm2 -g

Zdaj imamo vso programsko opremo, ki jo potrebujemo za namestitev Raneto.

Namestitev Raneto

Git bomo uporabili za kloniranje skladišča Raneto na naš strežnik.

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

To bo ustvarilo mapo z imenom Raneto. Vnesite mapo.

cd Raneto

Namestite NPM.

npm install

Zaženite Gulp tako, da vnesete naslednje.

npm run gulp

Ko se Gulp zažene, lahko zaženemo našo aplikacijo z enim od naslednjih dveh ukazov.

npm start
# or
npm example/server.js

Zdaj boste lahko dostopali do vaše nove namestitve Raneto tako, da se pomaknete na SERVER_IP:3000. Preostanek te vadnice vas bo naučil, kako nadalje konfigurirati Raneto, narediti nove strani, dodati kategorije, prilagoditi razvrščanje, dodati domačo stran po meri in urediti predlogo.

Nadaljnja konfiguracija

Zdaj imate privzeto namestitev Raneto, ki gostuje na vašem VPS. Preden začnete delati karkoli drugega, predlagam, da naredite nekaj sprememb v privzeti konfiguraciji in nastavitvah.

Oglejmo si config.default.js, ki se nahaja v examplemapi. Ta konfiguracijska datoteka je precej dolga, vendar vas prosimo, da ne bodite preobremenjeni, saj je močno komentirana. Tu so lastnosti, ki jih morate urediti:

• site_title - To spremenite v naslov vašega spletnega mesta.
• base_url– To mora biti nastavljeno na URL vašega spletnega mesta. Uporablja se lahko kot spremenljivka pri urejanju strani.
• support_email- Spremenite to v veljavno e-pošto. Prikazan bo v nogi spletnega mesta.
• copyright - Besedilo v nogi.
• analytics – Tukaj dodajte kodo za sledenje Google Analytics.
• allow_editing - Ali želite imeti možnost urejanja datotek s spletnim urejevalnikom?
• authentication_for_read - Ali želite, da se ljudje prijavijo za ogled spletnega mesta?
• credentials - Tukaj dodajte uporabnike, če je prijava omogočena.
• locale - Jezik.
• datetime_format - Oblika datuma in ure.
• home_meta - Uredite to, da spremenite metapodatke svoje domače strani.
• table_of_content - Ali naj Raneto prikaže kazalo?

Uporaba spletnega urejevalnika

Raneto ima enostaven za uporabo spletni vmesnik za upravljanje strani, kategorij in še več. Čeprav vam ne omogoča, da naredite vse, je vsekakor koristno, če morate hitro urediti na poti.

Do njega lahko dostopate tako, da omogočite nastavitev v config.default.js(kot je navedeno zgoraj), nato obiščete svoj VPS in kliknete gumb za prijavo v zgornjem desnem kotu. Vnesite svoje uporabniško ime in geslo (lahko jih spremenite v config.default.js) in kliknite prijava. Preprosto kliknite stran, ki jo želite urediti, kliknite Actionsspustni meni in izberite dejanje, ki ga želite dokončati. Strani lahko dodate tako, da pritisnete +gumb poleg imena kategorije, kategorije pa lahko ustvarite z vnosnim poljem v zgornjem levem kotu.

Dodajanje strani

Dodajanje strani je tako preprosto kot ustvarjanje novega .mddokumenta Markdown ( ) v example/contentmapi.

Ko ustvarite novo datoteko Markdown, je pomembno, da na vrh datoteke dodate nekaj osnovnih informacij. Odprite datoteko v svojem najljubšem urejevalniku besedil. Na vrh datoteke moramo dodati naslednje.

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

Če želite, lahko na svojih straneh uporabite tudi naslednje spremenljivke:

• %base_url% - To vam omogoča, da omenite URL vašega spletnega mesta.
• %image_url% - To vam omogoča, da dobite osnovni URL vašega imenika slik.

Dodajanje kategorij

Svojo bazo znanja lahko enostavno dodate kategorije. Samo ustvarite novo mapo v example/contentimeniku in v to mapo vstavite strani, ki jih želite v tej kategoriji. Recimo, da želimo kategorijo, imenovano helps stranmi, imenovanimi contact, help-mein awesome. Datoteke bi izgledale takole:

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

V kategorije lahko dodate toliko podmap, kot želite.

Kategorije imajo lahko tudi meta informacije. Ustvarite datoteko, imenovano metav mapi kategorije. Podprti so naslednji atributi (vsi izbirni):

• Naslov – preglasi naslov na podlagi imena mape.
• Razvrsti - Omogoča vam razvrščanje vrstnega reda kategorij, deluje na enak način kot razvrščanje strani.
• ShowOnHome - res/napačno.

Domača stran po meri

Če želite dodati domačo stran po meri, morate index.mdv svojo example/contentmapo dodati datoteko markdown, ki jo kličete .

Razvrščanje strani

Raneto samodejno razvrsti strani po abecedi, lahko pa uporabite ročno razvrščanje tako, da dodate Sortelement meta strani. Vrednost sorte mora biti celo število, na primer:

Sort: 7

Ta stran bi se zdaj prikazala pred stranmi z vrednostjo razvrščanja 8 ali več, vendar za stranmi z vrednostjo 6 ali manj.

Spreminjanje predloge

Če poznate HTML ali CSS, lahko preprosto spremenite videz vaše namestitve Raneto. Raneto uporablja Handlebars, jezik predlog JavaScript, ki modularizira urejanje HTML. Datoteke teme lahko najdete v themes/defaultmapi. Če želite več informacij o urejanju predlog Renato, lahko obiščete njihov razdelek za pomoč . Ko končate z urejanjem predloge, se prepričajte, da znova zaženete aplikacijo.