Како инсталирати Рането на Убунту 17.10

Рането је бесплатна база знања отвореног кода, изграђена на Ноде.јс која је лака за подешавање и коришћење, као и за администрацију. Категорије и странице су написане у Маркдовну, што олакшава уређивање. Ако Маркдовн није ваша ствар, Рането вам такође дозвољава да користите ХТМЛ.

Предуслови

• ВПС са инсталираним Убунту 17.10.
• ССХ приступ вашем ВПС-у.
• Основно разумевање Линук терминала.

Пријављивањем

Прво, морамо се пријавити на наш сервер користећи ССХ. Да бисте то урадили, отворите свој омиљени ССХ клијент.

ssh root@SERVER_IP

Након што унесете своју лозинку (можете је добити са Вултр контролне табле) бићете пријављени на свој ВПС.

Инсталирање Ноде.јс & ПМ2

Рането ради на Ноде.јс, јавасцрипт рунтиме-у и оквиру. У овом водичу ћемо користити Ноде.јс в8 због његове дугорочне подршке. Започните инсталацију тако што ћете откуцати следећу команду.

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

Након што се ова скрипта заврши са радом, можете покренути главну инсталацију.

sudo apt-get install -y nodejs

Када овај инсталатер заврши, имаћете ажурирану копију Ноде.јс инсталирану на вашем ВПС-у. Затим ћемо инсталирати ПМ2, менаџер процеса за Ноде.јс који олакшава покретање Рането-а (и многих других Ноде.јс апликација).

npm install pm2 -g

Сада имамо сав софтвер који нам је потребан да инсталирамо Рането.

Инсталирање Ранета

Користићемо Гит за клонирање Рането спремишта на наш сервер.

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

Ово ће креирати фасциклу под називом Raneto. Унесите фасциклу.

cd Raneto

Инсталирајте НПМ.

npm install

Покрените Гулп тако што ћете уписати следеће.

npm run gulp

Када Гулп заврши са радом, можемо покренути нашу апликацију помоћу једне од две следеће команде.

npm start
# or
npm example/server.js

Сада ћете моћи да приступите вашој новој Рането инсталацији тако што ћете отићи на SERVER_IP:3000. Остатак овог упутства ће вас научити како да даље конфигуришете Рането, правите нове странице, додајете категорије, подешавате сортирање, додајете прилагођену почетну страницу и измените шаблон.

Даља конфигурација

Сада имате подразумевану Рането инсталацију хостовану на вашем ВПС-у. Пре него што почнете да радите било шта друго, предлажем да направите неколико промена у подразумеваној конфигурацији и подешавању.

Хајде да погледамо config.default.js, који се налази у exampleфасцикли. Ова конфигурациона датотека је прилично дуга, али немојте бити преоптерећени, јер је у великој мери коментарисана. Ево својства која треба да измените:

• site_title - Промените ово у наслов ваше веб странице.
• base_url– Ово би требало да буде подешено на УРЛ вашег сајта. Може се користити као променљива приликом уређивања страница.
• support_email- Промените ово у важећу е-пошту. Приказаће се у подножју сајта.
• copyright - Текст у подножју.
• analytics – Овде додајте код за праћење Гоогле аналитике.
• allow_editing - Да ли желите да можете да уређујете датотеке помоћу веб уређивача?
• authentication_for_read - Да ли желите да се људи пријављују да би видели веб локацију?
• credentials - Додајте кориснике овде ако је пријава омогућена.
• locale - Језик.
• datetime_format - Формат датума и времена.
• home_meta - Уредите ово да бисте променили мета информације своје почетне странице.
• table_of_content - Да ли Рането треба да прикаже садржај?

Коришћење онлајн уређивача

Рането долази са онлајн интерфејсом који је једноставан за коришћење за управљање страницама, категоријама и још много тога. Иако вам не дозвољава да урадите све, свакако је од помоћи ако треба да направите брзу измену у покрету.

Можете му приступити тако што ћете омогућити подешавање у config.default.js(као што је горе поменуто), а затим посетите свој ВПС и кликнете на дугме за пријаву у горњем десном углу. Унесите своје корисничко име и лозинку (можете их променити у config.default.js) и кликните на пријаву. Једноставно кликните на страницу коју треба да измените, кликните на Actionsпадајући мени и изаберите радњу коју желите да довршите. Странице можете додати притиском на +дугме поред назива категорије, а категорије можете креирати користећи поље за унос у горњем левом углу.

Додавање страница

Додавање страница је једноставно као креирање новог Маркдовн ( .md) документа у example/contentфасцикли.

Када направите нову Маркдовн датотеку, важно је да додате неке основне информације на врх датотеке. Отворите датотеку у свом омиљеном уређивачу текста. Морамо да додамо следеће на врх датотеке.

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

Ако је потребно, можете да користите и следеће променљиве на својим страницама:

• %base_url% – Ово вам омогућава да поменете УРЛ своје веб локације.
• %image_url% - Ово вам омогућава да добијете основну УРЛ адресу вашег директоријума слика.

Додавање категорија

Можете лако да додате категорије у своју базу знања. Само направите нову фасциклу у example/contentдиректоријуму и ставите странице које желите да буду у тој категорији у ту фасциклу. На пример, рецимо да желимо категорију која се зове helpса страницама под називом contact, help-meи awesome. Фајлови би изгледали овако:

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

Унутар категорија можете додати онолико поддиректорија колико желите.

Категорије такође могу имати мета информације. Направите датотеку која се зове metaу фолдеру категорије. Подржани су следећи атрибути (сви опциони):

• Наслов – Замењује наслов на основу назива фасцикле.
• Сортирај – Омогућава вам да сортирате редослед категорија, ради на исти начин као и сортирање страница.
• СховОнХоме - тачно/нетачно.

Прилагођена почетна страница

Ако желите да додате прилагођену почетну страницу, све што треба да урадите је да додате маркдовн датотеку која се зове index.mdу вашу example/contentфасциклу.

Сортирање страница

Рането аутоматски сортира странице по абецедном реду, али можете применити ручно сортирање додавањем Sortставке у мета странице. Вредност сортирања мора бити цео број, на пример:

Sort: 7

Ова страница би се сада појавила пре страница са вредношћу сортирања од 8 или више, али после страница са вредношћу од 6 или мање.

Промена шаблона

Ако сте упознати са ХТМЛ-ом или ЦСС-ом, лако можете да промените изглед ваше Рането инсталације. Рането користи Хандлебарс, ЈаваСцрипт шаблонски језик, који модуларизира ХТМЛ уређивање. Датотеке тема можете пронаћи у themes/defaultфасцикли. Ако желите више информација о уређивању Ренато шаблона, можете посетити њихов одељак за помоћ . Када завршите са уређивањем шаблона, уверите се да сте поново покренули апликацију.