Kuinka asentaa Raneto Ubuntuun 17.10

Raneto on ilmainen ja avoimen lähdekoodin tietokanta, joka on rakennettu Node.js:lle ja joka on helppo asentaa ja käyttää sekä helposti hallita. Luokat ja sivut on kirjoitettu Markdownissa, mikä tekee muokkaamisesta helppoa. Jos Markdown ei ole sinun juttusi, Raneto sallii myös HTML:n käytön.

Edellytykset

• VPS, johon on asennettu Ubuntu 17.10.
• SSH-yhteys VPS:ään.
• Linux-päätelaitteen perusymmärrys.

Kirjautua sisään

Ensin meidän on kirjauduttava palvelimellemme SSH:n avulla. Voit tehdä tämän avaamalla suosikki SSH-asiakkaasi.

ssh root@SERVER_IP

Kun olet syöttänyt salasanasi (saat sen Vultr-hallintapaneelista), kirjaudut sisään VPS:ään.

Node.js:n ja PM2:n asentaminen

Raneto toimii Node.js:llä, javascript-ajoympäristöllä ja -kehyksellä. Tässä opetusohjelmassa käytämme Node.js v8:aa sen pitkän aikavälin tuen vuoksi. Aloita asennus kirjoittamalla seuraava komento.

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

Kun tämä komentosarja on suoritettu, voit suorittaa pääasennuksen.

sudo apt-get install -y nodejs

Kun tämä asennusohjelma on valmis, sinulla on päivitetty kopio Node.js:stä asennettuna VPS:ään. Seuraavaksi asennamme PM2:n, Node.js:n prosessinhallinnan, joka helpottaa Raneton (ja monien muiden Node.js-sovellusten) suorittamista.

npm install pm2 -g

Meillä on nyt kaikki ohjelmistot, joita tarvitsemme Raneton asentamiseen.

Raneton asennus

Aiomme käyttää Gitiä Raneto-arkiston kloonaamiseen palvelimellemme.

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

Tämä luo kansion nimeltä Raneto. Syötä kansio.

cd Raneto

Asenna NPM.

npm install

Suorita Gulp kirjoittamalla seuraava.

npm run gulp

Kun Gulp on suoritettu, voimme käynnistää sovelluksemme käyttämällä jompaakumpaa seuraavista komennoista.

npm start
# or
npm example/server.js

Pääset nyt käyttämään uutta Raneto-asennusta navigoimalla osoitteeseen SERVER_IP:3000. Loput tästä opetusohjelmasta opettavat sinulle, kuinka Ranetoa määritetään edelleen, luodaan uusia sivuja, lisätään luokkia, säädetään lajittelua, lisätään mukautettu kotisivu ja muokataan mallia.

Lisäkonfiguraatiot

Sinulla on nyt oletusarvoinen Raneto-asennus VPS:ssäsi. Ennen kuin alat tehdä mitään muuta, ehdotan, että teet muutamia muutoksia oletuskonfiguraatioon ja -asetuksiin.

Katsotaanpa config.default.js, joka sijaitsee examplekansiossa. Tämä asetustiedosto on melko pitkä, mutta älä huolestu, sillä sitä on paljon kommentoitu. Tässä ovat ominaisuudet, joita sinun tulee muokata:

• site_title - Muuta tämä verkkosivustosi otsikoksi.
• base_url- Tämä tulee asettaa sivustosi URL-osoitteeseen. Sitä voidaan käyttää muuttujana sivuja muokatessa.
• support_email- Muuta tämä toimivaksi sähköpostiksi. Se näkyy sivuston alatunnisteessa.
• copyright - Alatunnisteen teksti.
• analytics - Lisää Google Analytics -seurantakoodi tähän.
• allow_editing - Haluatko pystyä muokkaamaan tiedostoja verkkoeditorin avulla?
• authentication_for_read - Haluatko ihmisten kirjautuvan sisään nähdäkseen verkkosivuston?
• credentials - Lisää käyttäjiä tähän, jos kirjautuminen on käytössä.
• locale - Kieli.
• datetime_format - Päivämäärän ja kellonajan muoto.
• home_meta - Muokkaa tätä muuttaaksesi etusivusi metatietoja.
• table_of_content - Pitäisikö Raneton näyttää sisällysluettelo?

Online-editorin käyttäminen

Ranetossa on helppokäyttöinen verkkokäyttöliittymä sivujen, luokkien ja muiden hallintaan. Vaikka se ei anna sinun tehdä kaikkea, se on varmasti hyödyllinen, jos sinun on tehtävä nopea muokkaus liikkeellä ollessasi.

Pääset siihen ottamalla asetuksen käyttöön config.default.js(kuten yllä mainittiin) ja käymällä sitten VPS:ssäsi ja napsauttamalla kirjautumispainiketta oikeassa yläkulmassa. Syötä käyttäjätunnuksesi ja salasanasi (voit vaihtaa ne kohdassa config.default.js) ja napsauta Kirjaudu sisään. Napsauta vain muokattavaa sivua, napsauta Actionsavattavaa valikkoa ja valitse toiminto, jonka haluat suorittaa. Voit lisätä sivuja painamalla +kategorian nimen vieressä olevaa painiketta ja voit luoda luokkia vasemman yläkulman syöttökentän avulla.

Sivujen lisääminen

Sivujen lisääminen on yhtä helppoa kuin uuden Markdown ( .md) -asiakirjan luominen example/contentkansioon.

Kun olet luonut uuden Markdown-tiedoston, on tärkeää, että lisäät perustietoja tiedoston alkuun. Avaa tiedosto suosikkitekstieditorissasi. Meidän on lisättävä seuraavat tiedot tiedoston alkuun.

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

Voit tarvittaessa käyttää sivuillasi myös seuraavia muuttujia:

• %base_url% - Tämän avulla voit mainita verkkosivustosi URL-osoitteen.
• %image_url% - Tämän avulla voit saada kuvahakemistosi perus-URL-osoitteen.

Luokkien lisääminen

Voit lisätä luokkia tietokantaasi helposti. Luo vain uusi kansio example/contenthakemistoon ja laita siihen luokkaan haluamasi sivut kyseiseen kansioon. Oletetaan esimerkiksi, että halusimme luokan, helpjonka sivut ovat contact, help-meja awesome. Tiedostot näyttäisivät tältä:

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

Voit lisätä luokkiin niin monta alikansiota kuin haluat.

Luokat voivat sisältää myös metatietoja. Luo tiedosto nimeltä metakategoriakansio. Seuraavia määritteitä tuetaan (kaikki valinnaiset):

• Otsikko - Ohittaa otsikon kansion nimen perusteella.
• Lajittele - Voit lajitella luokkien järjestystä, toimii samalla tavalla kuin sivujen lajittelu.
• ShowOnHome - tosi/epätosi.

Mukautettu kotisivu

Jos haluat lisätä oman kotisivun, sinun tarvitsee vain lisätä markdown tiedoston nimeltä index.mdomaan example/contentkansioon.

Sivujen lajittelu

Raneto lajittelee sivut automaattisesti aakkosjärjestykseen, mutta voit käyttää manuaalista lajittelua lisäämällä Sortkohteen sivun metaan. Lajitteluarvon tulee olla kokonaisluku, esimerkiksi:

Sort: 7

Tämä sivu näkyy nyt ennen sivuja, joiden lajitteluarvo on vähintään 8, mutta niiden sivujen jälkeen, joiden arvo on 6 tai vähemmän.

Mallin muuttaminen

Jos tunnet HTML:n tai CSS:n, voit helposti muuttaa Raneto-asennuksesi ulkoasua. Raneto käyttää Handlebarsia, JavaScript-mallinnuskieltä, joka modulisoi HTML-muokkausta. Löydät teematiedostot themes/defaultkansiosta. Jos haluat lisätietoja Renato-mallien muokkaamisesta, voit käydä heidän ohjeosiossa . Kun olet lopettanut mallin muokkaamisen, varmista, että käynnistät sovelluksen uudelleen.