Wiki.js, un wiki open source bazat pe Node.js, Git și Markdown

Despre Wiki.js

În articolul următor vom analiza Wiki.js. Acesta este unul Aplicație wiki ușoară și gratuită open source construită cu Node.js. Spre deosebire de alte platforme wiki, acesta vă salvează tot conținutul direct în fișiere Markdown (.md). Acest conținut este sincronizat automat cu depozitul Git de la distanță al utilizatorului.

Este o aplicație wiki open source, modernă și puternică bazat pe Node.js, Git și Markdown. Codul sursă Wiki.js este disponibil public la adresa Github, gata pentru descărcare și instalare. Acest lucru este posibil deoarece Wiki.js este complet open source, sub licența GNU AGPLv3.

Caracteristici generale Wiki.js

  • Vom putea scrie conținutul nostru în format Markdown. Vom folosi editor vizual încorporat.
  • Spre deosebire de alte programe wiki care salvează conținut într-o bază de date, Wiki.js salvați tot conținutul direct în fișierele Markdown (.md). Acest conținut este sincronizat automat cu depozitul nostru Git la distanță. Dacă suntem interesați.
  • Aplicația rulează pe motorul Node.js. Este optimizat pentru a utiliza resurse CPU reduse. Se bazează foarte mult pe cache pentru a livra rapid conținut utilizatorilor.
  • Conținutul generat este procesat automat într-un format de citire curat. Este prezentat într-o interfață de utilizator elegantă.
  • Vom fi capabili restricționează accesul la Wiki anumitor utilizatori sau chiar doar părți din conținut.
  • Vom putea să ne conectăm folosind baza de date locală. De asemenea, ne vom putea conecta folosind furnizori externi de autentificare cum ar fi Contul Microsoft, ID-ul Google etc.
  • Programul ne va oferi posibilitatea de a insera imagini, diagrame, documente, videoclipuri, linkuri etc. Pentru aceasta vom folosi manager de active Care încorporează.
  • Vom putea găsi rapid intrarea wiki pe care o căutăm folosind motor de căutare încorporat. Ne va oferi rezultate și sugestii relevante atunci când analizăm metadatele și conținutul intrărilor noastre wiki.

Cerințe de server

Pentru a face acest program să funcționeze, va trebui să avem câteva lucruri pe serverul nostru.

  • Node.js 6.9.0 sau o versiune ulterioară.
  • MongoDB 3.2 sau mai mare.
  • Git 2.7.4 sau mai mare.
  • Un depozit Git (publice sau private). Acest lucru este opțional.

Instalați Wiki.js pe Ubuntu

Această scurtă postare vom vedea cum instalați Wiki.js pe un server Ubuntu 18.04 cu toate cerințele necesare.

Instalați Git

Pentru a începe, va trebui să instalăm Git pentru a rula Wiki.js. Git vine preinstalat pe serverul Ubuntu. Este posibil să nu aveți nevoie să îl instalați. Cu toate acestea, dacă aveți nevoie ultima versiune de Git, adăugați următorul depozit și instalați-l:

sudo add-apt-repository -y ppa:git-core/ppa

sudo apt update && sudo apt upgrade

sudo apt install git

Instalați Node.js

Node.js este o altă cerință obligatorie pentru a obține Wiki.js. Va trebui să executăm următoarele comenzi numai pentru a instala Node.js:

sudo apt install curl

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

sudo apt install -y nodejs

Instalați MongoDB

MongoDB este, de asemenea, una dintre cerințele obligatorii pentru Wiki.js. Noi mergem spre instalați versiunea care vine în depozitul Ubuntu. Va trebui doar să executăm comanda:

sudo apt install mongodb

Descărcați și instalați Wiki.js

Odată îndeplinite toate cerințele, putem descărcați scriptul de instalare Wiki.js și lansați-l. Pentru a face acest lucru, executați:

sudo mkdir /var/www/wikijs

cd /var/www/wikijs

curl -sSo- https://wiki.js.org/install.sh | sudo bash

După executarea ultimei comenzi, ar trebui să vedeți un mesaj de succes ca următoarele:

instalați wiki.js

După instalare, ni se va cere să rulăm asistent de configurare. Îl putem începe rulând:

sudo node wiki configure

Această comandă ne va arăta un mesaj către deschideți URL-ul http: // localhost: 3000 în browser pentru configurare wiki.js.

configurați wiki.js

Dacă ne deschidem browserul și căutăm numele gazdei serverului sau adresa IP urmată de port, expertul va începe. Aici vom avea diferite ecrane de configurare. Dacă nu vrem să ne complicăm prea mult, putem accepta setările implicite și continuă.

configurare din browserul wiki.js

Programul validați că sistemul îndeplinește cerințele necesar.

verificarea sistemului wiki.js

Următorul lucru pe care va trebui să-l completăm este configurație generală.

Setări generale Wiki.js

Apoi va trebui să configurăm Conexiune MongoDB. Dacă instalarea pe care am efectuat-o înainte a fost corectă, putem apăsa butonul «Conectați«. Următoarea fereastră va fi cea a Configurarea căilor. Aici recomandă să îl lăsați să fie defect, așa că vom continua cu instalarea.

Pe ecranul următor putem adăugați datele contului nostru Gitsau săriți peste acest pas.

Configurarea Git în Wiki.js

Acum va trebui creați un cont de administrator pentru a vă conecta mai târziu.

setările contului de administrator în Wiki.js

După aceasta și câteva alte ecrane de configurare, Wiki.js ar trebui să fie instalat și gata de utilizare.

Creați pagina de pornire cu Wiki.js

La sfarsit va trebui să ne autentificăm. Vom folosi contul de administrator pe care l-am creat anterior pentru a crea pagina noastră de pornire.

Pagina de autentificare Wiki.js

Și după toate acestea, vom ajunge la editor. De aici putem începe să creăm.

Editor Wiki.js

Aceasta este doar o instalare de bază. Pentru obțineți mai multe informații despre această platformă wiki, despre instalarea sa, utilizarea sa sau pentru a vedea documentația oficială, putem vizita pagina proiectului.


Lasă comentariul tău

Adresa ta de email nu va fi publicată. Câmpurile obligatorii sunt marcate cu *

*

*

  1. Responsabil pentru date: Miguel Ángel Gatón
  2. Scopul datelor: Control SPAM, gestionarea comentariilor.
  3. Legitimare: consimțământul dvs.
  4. Comunicarea datelor: datele nu vor fi comunicate terților decât prin obligație legală.
  5. Stocarea datelor: bază de date găzduită de Occentus Networks (UE)
  6. Drepturi: în orice moment vă puteți limita, recupera și șterge informațiile.