V nasledujúcom článku sa pozrieme na Wiki.js. Toto je jeden Ľahká a bezplatná open source wiki aplikácia postavená na Node.js. Na rozdiel od iných platforiem wiki, táto ukladá všetok váš obsah priamo do súborov Markdown (.md). Tento obsah sa automaticky synchronizuje so vzdialeným úložiskom Git používateľa.
Je to otvorená, moderná a výkonná wiki aplikácia založené na Node.js, Git a Markdown. Zdrojový kód Wiki.js je verejne dostupný na adrese GitHub, pripravený na stiahnutie a inštaláciu. Je to možné, pretože Wiki.js je úplne otvorený zdrojový kód pod licenciou GNU AGPLv3.
Všeobecné vlastnosti Wiki.js
- Náš obsah budeme môcť písať vo formáte Markdown. Použijeme vstavaný vizuálny editor.
- Na rozdiel od iného softvéru wiki, ktorý ukladá obsah do databázy, Wiki.js ukladať všetok obsah priamo do súborov Markdown (.md). Tento obsah sa automaticky synchronizuje s našim vzdialeným úložiskom Git. Ak máme záujem.
- Aplikácia beží na engine Node.js. Je optimalizované na využitie nízkych zdrojov CPU. Pri rýchlom poskytovaní obsahu používateľom sa spolieha na ukladanie do medzipamäte.
- Generovaný obsah sa automaticky spracuje v a čistý formát čítania. Je prezentovaný v elegantnom používateľskom rozhraní.
- Budeme schopní obmedziť prístup k našej Wiki určitým používateľom alebo dokonca iba častiam obsahu.
- Budeme sa môcť prihlásiť pomocou lokálnej databázy. Budeme sa môcť pripojiť aj pomocou externých poskytovateľov autentifikácie účet Microsoft, Google ID atď.
- Program nám dá možnosť vkladať obrázky, schémy, dokumenty, videá, odkazy atď. K tomu použijeme správca majetku Čo obsahuje.
- Budeme schopní rýchlo nájsť wiki záznam, ktorý hľadáme pomocou zabudovaný vyhľadávací nástroj. Poskytne nám príslušné výsledky a návrhy pri analýze metadát a obsahu našich záznamov wiki.
Požiadavky na server
Aby tento program fungoval, budeme musieť mať na serveri nejaké veci.
- Node.js 6.9.0 alebo novší.
- MongoDB 3.2 alebo vyšší.
- Git 2.7.4 alebo vyšší.
- Úložisko Git (verejné alebo súkromné). Toto je voliteľné.
Nainštalujte Wiki.js na Ubuntu
Tento krátky príspevok uvidíme ako nainštalujte Wiki.js na server Ubuntu 18.04 so všetkými potrebnými požiadavkami.
Nainštalujte Git
Na začiatok si budeme musieť nainštalovať Git na spustenie Wiki.js. Git je predinštalovaný na serveri Ubuntu. Možno ho nebudete musieť inštalovať. Ak však potrebujete najnovšiu verziu Gitu, pridajte nasledujúce úložisko a nainštalujte ho:
sudo add-apt-repository -y ppa:git-core/ppa sudo apt update && sudo apt upgrade sudo apt install git
Nainštalujte si Node.js
Node.js je ďalšou povinnou požiadavkou získať Wiki.js. Na inštaláciu súboru Node.js budeme musieť vykonať iba tieto príkazy:
sudo apt install curl curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash - sudo apt install -y nodejs
Nainštalujte MongoDB
MongoDB je tiež jednou z povinných požiadaviek pre Wiki.js. Budeme nainštalujte verziu, ktorá sa nachádza v úložisku Ubuntu. Budeme musieť vykonať iba tento príkaz:
sudo apt install mongodb
Stiahnite a nainštalujte Wiki.js
Keď budú splnené všetky požiadavky, môžeme stiahnite si inštalačný skript Wiki.js a spustite ho. Ak to chcete urobiť, postupujte takto:
sudo mkdir /var/www/wikijs cd /var/www/wikijs curl -sSo- https://wiki.js.org/install.sh | sudo bash
Po spustení posledného príkazu by sa malo zobraziť a správa o úspechu napríklad:
Po inštalácii budeme požiadaní o spustenie Sprievodca nastavením. Môžeme to spustiť spustením:
sudo node wiki configure
Tento príkaz nám zobrazí správu pre otvorte v prehliadači URL http: // localhost: 3000, ktoré chcete nakonfigurovať wiki.js.
Ak otvoríme prehliadač a vyhľadáme názov hostiteľa servera alebo adresu IP, za ktorou nasleduje port, spustí sa sprievodca. Tu budeme mať rôzne konfiguračné obrazovky. Ak sa nechceme príliš komplikovať, môžeme prijať predvolené nastavenia a pokračovať.
Program overiť, či systém spĺňa požiadavky nevyhnutné.
Ďalšia vec, ktorú budeme musieť vyplniť, je všeobecná konfigurácia.
Potom budeme musieť nakonfigurovať Pripojenie MongoDB. Ak bola inštalácia, ktorú sme predtým vykonali, správna, môžeme stlačiť tlačidlo «Pripojiť«. Ďalšie okno bude okno Konfigurácia ciest. Tu odporúčajú nechať ho pokazený, takže pokračujeme v inštalácii.
Na ďalšej obrazovke môžeme pridajte údaje nášho účtu Git, alebo tento krok preskočte.
Teraz budeme musieť vytvoriť účet správcu prihlásiť sa neskôr.
Po tomto a niekoľkých ďalších obrazovkách nastavenia by mal byť Wiki.js nainštalovaný a pripravený na použitie.
Nakoniec budeme sa musieť prihlásiť. Na vytvorenie našej domovskej stránky použijeme účet správcu, ktorý sme si predtým vytvorili.
A po tomto všetkom sa dostaneme k redaktorovi. Od tohto miesta môžeme začať vytvárať.
Toto je iba základná inštalácia. Pre Získajte viac informácií o tejto platforme wiki, o jeho inštalácii, použití alebo nahliadnutí do oficiálnej dokumentácie, môžeme navštíviť server stránka projektu.