Wiki.js, een open source wiki gebaseerd op Node.js, Git en Markdown

Over Wiki.js

In het volgende artikel gaan we kijken naar Wiki.js. Dit is een Lichtgewicht en gratis open source wiki-app gebouwd met Node.js​ In tegenstelling tot andere wiki-platforms, slaat deze al je inhoud rechtstreeks op in Markdown-bestanden (.md​ Deze inhoud wordt automatisch gesynchroniseerd met de externe Git-opslagplaats van de gebruiker.

Het is een open source, moderne en krachtige wiki-applicatie gebaseerd op Node.js, Git en Markdown​ De broncode van Wiki.js is publiekelijk beschikbaar op GitHub, klaar om te downloaden en te installeren. Dit is mogelijk omdat Wiki.js volledig open source is, onder de GNU AGPLv3-licentie.

Wiki.js algemene kenmerken

  • We kunnen onze inhoud in Markdown-indeling schrijven. We zullen de ingebouwde visuele editor.
  • In tegenstelling tot andere wikisoftware die inhoud opslaat in een database, is Wiki.js sla alle inhoud rechtstreeks op in Markdown-bestanden (.md)​ Deze inhoud wordt automatisch gesynchroniseerd met onze externe Git-repository. Als we geïnteresseerd zijn.
  • De applicatie draait op de Node.js-engine. Is geoptimaliseerd om lage CPU-bronnen te gebruiken​ Het is sterk afhankelijk van caching om snel inhoud aan gebruikers te leveren.
  • De gegenereerde inhoud wordt automagisch verwerkt in een schoon leesformaat​ Het wordt gepresenteerd in een elegante gebruikersinterface.
  • We zullen in staat zijn tot de toegang tot onze Wiki beperken aan bepaalde gebruikers of zelfs slechts delen van de inhoud.
  • We kunnen inloggen met behulp van de lokale database. We kunnen ook verbinding maken met externe authenticatieleveranciers zoals Microsoft-account, Google-ID, enz.
  • Het programma geeft ons de mogelijkheid om afbeeldingen, diagrammen, documenten, video's, links, etc. in te voegen. Hiervoor gebruiken we de vermogensbeheerder Die bevat.
  • We zullen het wiki-item dat we zoeken snel kunnen vinden met behulp van de ingebouwde zoekmachine. Het geeft ons relevante resultaten en suggesties bij het analyseren van de metadata en inhoud van onze wiki-items.

Serververeisten

Om dit programma te laten werken, hebben we een aantal dingen op onze server nodig.

  • Node.js 6.9.0 of hoger.
  • MongoDB 3.2 of hoger.
  • Git 2.7.4 of hoger.
  • Een Git-opslagplaats (openbaar of privé​ Dit is optioneel.

Installeer Wiki.js op Ubuntu

In dit korte bericht zullen we zien hoe installeer Wiki.js op een Ubuntu 18.04-server met al uw noodzakelijke vereisten.

Installeer Git

Om te beginnen moeten we Git installeren om Wiki.js. Git is vooraf geïnstalleerd op de Ubuntu-server. Mogelijk hoeft u het niet te installeren. Als u echter nodig heeft de nieuwste versie van Git, voeg de volgende repository toe en installeer deze:

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

sudo apt update && sudo apt upgrade

sudo apt install git

Installeer Node.js

Node.js is een andere verplichte vereiste om Wiki.js. We hoeven alleen de volgende opdrachten uit te voeren om Node.js te installeren:

sudo apt install curl

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

sudo apt install -y nodejs

Installeer MongoDB

MongoDB is ook een van de verplichte vereisten voor Wiki.js. Wij gaan installeer de versie die in de Ubuntu-repository staat​ We hoeven alleen het commando uit te voeren:

sudo apt install mongodb

Download en installeer Wiki.js

Zodra aan alle vereisten is voldaan, kunnen we download het installatiescript Wiki.js en start het​ Om deze run te doen:

sudo mkdir /var/www/wikijs

cd /var/www/wikijs

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

Nadat u de laatste opdracht hebt uitgevoerd, ziet u een succes bericht zoals de volgende:

installeer wiki.js

Na installatie wordt ons gevraagd om het installatiewizard​ We kunnen het starten door uit te voeren:

sudo node wiki configure

Dit commando laat ons een bericht zien aan open de URL http: // localhost: 3000 in de browser om te configureren wiki.js.

configureer wiki.js

Als we onze browser openen en zoeken naar de hostnaam van de server of het IP-adres gevolgd door de poort, zal de wizard starten. Hier hebben we verschillende configuratieschermen. Als we niet te ingewikkeld willen worden, we kunnen de standaardinstellingen accepteren en doorgaan.

configuratie van de wiki.js-browser

Het programma valideren dat het systeem aan de vereisten voldoet noodzakelijk.

wiki.js systeemcontrole

Het volgende dat we moeten invullen is de algemene configuratie.

Algemene Wiki.js-instellingen

Dan zullen we het MongoDB-verbinding​ Als de installatie die we eerder hebben uitgevoerd correct is, kunnen we op de knop «Verbinden​ Het volgende venster is dat van de Paden configuratie​ Hier raden ze aan om het defect te laten, zodat we doorgaan met de installatie.

Op het volgende scherm kunnen we voeg de gegevens van ons Git-account toeof sla deze stap over.

Git-configuratie in Wiki.js

Nu zullen we moeten maak een beheerdersaccount aan om later in te loggen.

beheerdersaccountinstellingen in Wiki.js

Hierna en een paar andere installatieschermen zou Wiki.js geïnstalleerd en klaar voor gebruik moeten zijn.

Maak de startpagina met Wiki.js

Aan het einde we zullen moeten inloggen​ We zullen het beheerdersaccount gebruiken dat we eerder hebben gemaakt om onze startpagina te maken.

Wiki.js inlogpagina

En na dit alles komen we bij de redacteur. Dit is waar we kunnen beginnen met creëren.

Wiki.js-editor

Dit is slechts een basisinstallatie. Voor krijg meer informatie over dit wiki-platform, over de installatie, het gebruik of om de officiële documentatie te zien, kunnen we de projectpagina.


Laat je reactie achter

Uw e-mailadres wordt niet gepubliceerd. Verplichte velden zijn gemarkeerd met *

*

*

  1. Verantwoordelijk voor de gegevens: Miguel Ángel Gatón
  2. Doel van de gegevens: Controle SPAM, commentaarbeheer.
  3. Legitimatie: uw toestemming
  4. Mededeling van de gegevens: De gegevens worden niet aan derden meegedeeld, behalve op grond van wettelijke verplichting.
  5. Gegevensopslag: database gehost door Occentus Networks (EU)
  6. Rechten: u kunt uw gegevens op elk moment beperken, herstellen en verwijderen.