Si të instaloni Raneto në Ubuntu 17.10

Raneto është një bazë njohurish falas dhe me burim të hapur, e ndërtuar në Node.js që është e lehtë për t'u konfiguruar dhe përdorur, si dhe e lehtë për t'u administruar. Kategoritë dhe faqet janë shkruar në Markdown, gjë që e bën të lehtë modifikimin. Nëse Markdown nuk është gjëja juaj, Raneto ju lejon gjithashtu të përdorni HTML.

Parakushtet

• Një VPS me Ubuntu 17.10 të instaluar.
• Qasja SSH në VPS-në tuaj.
• Kuptimi bazë i terminalit Linux.

Hyrja

Së pari, ne duhet të identifikohemi në serverin tonë duke përdorur SSH. Për ta bërë këtë, hapni klientin tuaj të preferuar SSH.

ssh root@SERVER_IP

Pasi të keni futur fjalëkalimin tuaj (mund ta merrni nga paneli i kontrollit Vultr) do të regjistroheni në VPS-në tuaj.

Instalimi i Node.js & PM2

Raneto funksionon në Node.js, një kohë ekzekutimi dhe kornizë javascript. Në këtë tutorial, ne do të përdorim Node.js v8 për shkak të mbështetjes afatgjatë. Filloni instalimin duke shtypur komandën e mëposhtme.

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

Pasi të ketë përfunduar ekzekutimi i këtij skripti, mund të ekzekutoni instalimin kryesor.

sudo apt-get install -y nodejs

Pasi të ketë përfunduar ky instalues, do të keni një kopje të përditësuar të Node.js të instaluar në VPS-në tuaj. Më pas, do të instalojmë PM2, një menaxher procesi për Node.js që e bën më të lehtë ekzekutimin e Raneto (dhe shumë aplikacione të tjera Node.js).

npm install pm2 -g

Tani kemi të gjithë softuerin që na nevojitet për të instaluar Raneto.

Instalimi i Raneto

Ne do të përdorim Git për të klonuar depon e Raneto në serverin tonë.

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

Kjo do të krijojë një dosje të quajtur Raneto. Futni dosjen.

cd Raneto

Instaloni NPM.

npm install

Drejtoni Gulp duke shtypur sa vijon.

npm run gulp

Pasi Gulp të ketë mbaruar ekzekutimin, ne mund të nisim aplikacionin tonë duke përdorur një nga dy komandat e mëposhtme.

npm start
# or
npm example/server.js

Tani do të mund të përdorni instalimin tuaj të ri Raneto duke lundruar te SERVER_IP:3000. Pjesa tjetër e këtij tutoriali do t'ju mësojë se si të konfiguroni më tej Raneto, të krijoni faqe të reja, të shtoni kategori, të rregulloni renditjen, të shtoni një faqe fillestare të personalizuar dhe të modifikoni shabllonin.

Konfigurim i mëtejshëm

Tani keni një instalim të paracaktuar të Raneto të pritur në VPS-në tuaj. Para se të filloni të bëni ndonjë gjë tjetër, unë sugjeroj që të bëni disa ndryshime në konfigurimin dhe konfigurimin e paracaktuar.

Le të hedhim një vështrim në config.default.js, i cili ndodhet në exampledosje. Ky skedar konfigurimi është mjaft i gjatë, por ju lutemi mos u mbingarkoni, pasi komentohet shumë. Këtu janë vetitë që duhet të modifikoni:

• site_title - Ndryshojeni këtë në titullin e faqes suaj të internetit.
• base_url- Kjo duhet të vendoset në URL-në e faqes suaj. Mund të përdoret si variabël gjatë redaktimit të faqeve.
• support_email- Ndryshojeni këtë në një email të vlefshëm. Do të shfaqet në fundin e faqes.
• copyright - Teksti i fundit.
• analytics - Shtoni një kod gjurmimi të Google Analytics këtu.
• allow_editing - Dëshironi të jeni në gjendje të redaktoni skedarë duke përdorur redaktuesin e uebit?
• authentication_for_read - Dëshironi që njerëzit të identifikohen për të parë faqen e internetit?
• credentials - Shto përdorues këtu nëse identifikimi është i aktivizuar.
• locale - Gjuhe.
• datetime_format - Formati i datës dhe orës.
• home_meta - Ndryshojeni këtë për të ndryshuar informacionin meta të faqes tuaj kryesore.
• table_of_content - A duhet të shfaqë Raneto një tabelë të përmbajtjes?

Duke përdorur Redaktorin Online

Raneto vjen me një ndërfaqe në internet të lehtë për t'u përdorur për menaxhimin e faqeve, kategorive dhe më shumë. Ndërsa nuk ju lejon të bëni gjithçka, sigurisht që është e dobishme nëse keni nevojë të bëni një modifikim të shpejtë në lëvizje.

Mund ta përdorni duke aktivizuar cilësimin config.default.js(siç u përmend më lart) dhe më pas duke vizituar VPS-në tuaj dhe duke klikuar butonin e hyrjes në këndin e sipërm djathtas. Futni emrin e përdoruesit dhe fjalëkalimin tuaj (mund t'i ndryshoni në config.default.js) dhe klikoni login. Thjesht klikoni në faqen që duhet të modifikoni, klikoni në Actionsdrop-down dhe zgjidhni veprimin që dëshironi të përfundoni. Mund të shtoni faqe duke shtypur +butonin pranë emrit të kategorisë dhe mund të krijoni kategori duke përdorur fushën e hyrjes në këndin e sipërm majtas.

Shtimi i faqeve

Shtimi i faqeve është po aq i thjeshtë sa krijimi i një dokumenti të ri Markdown ( .md) në example/contentdosje.

Pasi të keni krijuar një skedar të ri Markdown, është e rëndësishme që të shtoni disa informacione bazë në krye të skedarit. Hapni skedarin në redaktuesin tuaj të preferuar të tekstit. Duhet të shtojmë sa vijon në krye të skedarit.

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

Nëse keni nevojë, mund të përdorni edhe variablat e mëposhtëm në faqet tuaja:

• %base_url% - Kjo ju lejon të përmendni URL-në e faqes suaj të internetit.
• %image_url% - Kjo ju lejon të merrni URL-në bazë të drejtorisë suaj të imazhit.

Shtimi i kategorive

Ju mund të shtoni kategori në bazën tuaj të njohurive lehtësisht. Thjesht krijoni një dosje të re në example/contentdrejtori dhe vendosni faqet që dëshironi të jeni në atë kategori në atë dosje. Për shembull, themi se donim një kategori të quajtur helpme faqe të quajtura contact, help-medhe awesome. Skedarët do të duken kështu:

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

Ju mund të shtoni sa më shumë nën-dosje që dëshironi brenda kategorive.

Kategoritë mund të kenë gjithashtu meta informacion. Krijoni një skedar të quajtur metanë dosjen e kategorisë. Atributet e mëposhtme mbështeten (të gjitha opsionale):

• Titulli - Anulon titullin bazuar në emrin e dosjes.
• Rendit - Ju lejon të renditni rendin e kategorive, funksionon në të njëjtën mënyrë si renditja e faqeve.
• ShowOnHome - e vërtetë/e gabuar.

Faqja kryesore e personalizuar

Nëse dëshironi të shtoni një faqe fillestare të personalizuar, gjithçka që duhet të bëni është të shtoni një skedar shënjimi të thirrur index.mdnë example/contentdosjen tuaj .

Renditja e faqeve

Raneto i rendit automatikisht faqet sipas alfabetit, por ju mund të aplikoni një renditje manuale duke shtuar një Sortartikull në meta të faqes. Vlera e renditjes duhet të jetë një numër i plotë, për shembull:

Sort: 7

Kjo faqe tani do të shfaqet para faqeve me vlerë renditjeje 8 ose më shumë, por pas faqeve me vlerë 6 ose më pak.

Ndryshimi i shabllonit

Nëse jeni të njohur me HTML ose CSS, mund ta ndryshoni lehtësisht pamjen e instalimit tuaj Raneto. Raneto përdor Handlebars, një gjuhë modelimi JavaScript, që modularizon redaktimin e HTML. Ju mund t'i gjeni skedarët e temës në themes/defaultdosje. Nëse dëshironi më shumë informacion mbi modifikimin e shablloneve të Renato, mund të vizitoni seksionin e ndihmës së tyre . Pasi të keni përfunduar modifikimin e shabllonit, sigurohuni që ta rinisni aplikacionin.