Wiki.js, en open source-wiki baseret på Node.js, Git og Markdown

Om Wiki.js

I den næste artikel skal vi se på Wiki.js. Dette er en Let og gratis open source wiki-app bygget med Node.js. I modsætning til andre wiki-platforme gemmer denne alt dit indhold direkte i Markdown-filer (.md). Dette indhold synkroniseres automatisk med brugerens eksterne Git-lager.

Det er en open source, moderne og kraftfuld wiki-applikation baseret på Node.js, Git og Markdown. Wiki.js kildekode er offentligt tilgængelig på Github, klar til download og installation. Dette er muligt, fordi Wiki.js er fuldstændig open source under GNU AGPLv3-licensen.

Wiki.js generelle funktioner

  • Vi vil være i stand til at skrive vores indhold i Markdown-format. Vi bruger indbygget visuel editor.
  • I modsætning til anden wiki-software, der gemmer indhold i en database, Wiki.js gem alt indhold direkte i Markdown-filer (.md). Dette indhold synkroniseres automatisk med vores eksterne Git-arkiv. Hvis vi er interesserede.
  • Applikationen kører på Node.js-motoren. Det her optimeret til at bruge lave CPU-ressourcer. Det er stærkt afhængigt af cache for hurtigt at levere indhold til brugerne.
  • Det genererede indhold behandles automatisk i en rent læseformat. Det præsenteres i en elegant brugergrænseflade.
  • Vi kan begrænse adgangen til vores Wiki til bestemte brugere eller endda bare dele af indholdet.
  • Vi kan logge ind ved hjælp af den lokale database. Vi vil også være i stand til at oprette forbindelse ved hjælp af eksterne godkendelsesudbydere som Microsoft-konto, Google ID osv.
  • Programmet giver os mulighed for at indsætte billeder, diagrammer, dokumenter, videoer, links osv. Til dette vil vi bruge aktivforvalter Hvilket inkorporerer.
  • Vi vil hurtigt kunne finde den wiki-post, vi leder efter, ved hjælp af indbygget søgemaskine. Det giver os relevante resultater og forslag, når vi analyserer metadataene og indholdet af vores wiki-poster.

Serverkrav

For at få dette program til at fungere, bliver vi nødt til at have nogle ting på vores server.

  • Node.js 6.9.0 eller højere.
  • MongoDB 3.2 eller højere.
  • Git 2.7.4 eller højere.
  • Et Git-arkiv (offentlig eller privat). Dette er valgfrit.

Installer Wiki.js på Ubuntu

Dette korte indlæg vil vi se hvordan installer Wiki.js på en Ubuntu 18.04-server med alle dine nødvendige krav.

Installer Git

For at starte skal vi installere Git for at køre Wiki.js. Git kommer forudinstalleret på Ubuntu-serveren. Du behøver muligvis ikke at installere det. Men hvis du har brug for det den seneste version af Git, tilføj følgende lager og installer det:

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

sudo apt update && sudo apt upgrade

sudo apt install git

Installer Node.js

node.js er et andet obligatorisk krav at få Wiki.js. Vi bliver kun nødt til at udføre følgende kommandoer for at installere Node.js:

sudo apt install curl

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

sudo apt install -y nodejs

Installer MongoDB

MongoDB er også et af de obligatoriske krav til Wiki.js. Vi skal installer den version, der kommer i Ubuntu-arkivet. Vi bliver kun nødt til at udføre kommandoen:

sudo apt install mongodb

Download og installer Wiki.js

Når alle kravene er opfyldt, kan vi download Wiki.js installationsskriptet og start det. Sådan udføres dette:

sudo mkdir /var/www/wikijs

cd /var/www/wikijs

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

Efter at have kørt den sidste kommando, skal du se a succesmeddelelse som følgende:

installer wiki.js

Efter installationen bliver vi bedt om at køre installationsguide. Vi kan starte det ved at køre:

sudo node wiki configure

Denne kommando viser os en besked til åbn URL'en http: // localhost: 3000 i browseren for at konfigurere wiki.js.

konfigurer wiki.js

Hvis vi åbner vores browser og ser efter værtsnavnet på serveren eller IP-adressen efterfulgt af porten, starter guiden. Her har vi forskellige konfigurationsskærme. Hvis vi ikke ønsker at blive for komplicerede, vi kan acceptere standardindstillingerne og fortsæt.

konfiguration fra wiki.js-browseren

Programmet validere, at systemet opfylder kravene nødvendig.

wiki.js systemkontrol

Den næste ting, vi bliver nødt til at udfylde, er generel konfiguration.

Generelle Wiki.js-indstillinger

Så bliver vi nødt til at konfigurere MongoDB-forbindelse. Hvis den installation, vi tidligere har udført, har været korrekt, kan vi trykke på knappen «Tilslut«. Det næste vindue er vinduet for Sti konfiguration. Her anbefaler de at lade det være defekt, så vi fortsætter med installationen.

På den næste skærm kan vi tilføj dataene fra vores Git-konto, eller spring dette trin over.

Git-konfiguration i Wiki.js

Nu bliver vi nødt til Opret en administratorkonto for at logge ind senere.

admin-kontoindstillinger i Wiki.js

Efter dette og et par andre installationsskærme skal Wiki.js være installeret og klar til brug.

Opret startsiden med Wiki.js

I slutningen vi bliver nødt til at logge ind. Vi bruger den administratorkonto, vi oprettede tidligere, til at oprette vores startside.

Wiki.js login-side

Og efter alt dette kommer vi til redaktøren. Det er her, vi kan begynde at skabe fra.

Wiki.js-editor

Dette er bare en grundlæggende installation. Til få flere oplysninger om denne wiki-platform, om dets installation, dets anvendelse eller for at se den officielle dokumentation, kan vi besøge projektside.


Efterlad din kommentar

Din e-mailadresse vil ikke blive offentliggjort. Obligatoriske felter er markeret med *

*

*

  1. Ansvarlig for dataene: Miguel Ángel Gatón
  2. Formålet med dataene: Control SPAM, management af kommentarer.
  3. Legitimering: Dit samtykke
  4. Kommunikation af dataene: Dataene vil ikke blive kommunikeret til tredjemand, undtagen ved juridisk forpligtelse.
  5. Datalagring: Database hostet af Occentus Networks (EU)
  6. Rettigheder: Du kan til enhver tid begrænse, gendanne og slette dine oplysninger.