Wiki.js, un wiki open source basé sur Node.js, Git et Markdown

À propos de Wiki.js

Dans le prochain article, nous allons jeter un œil à Wiki.js. C'est un Application wiki open source légère et gratuite construite avec Node.js. Contrairement aux autres plates-formes wiki, celle-ci enregistre tout votre contenu directement dans des fichiers Markdown (.Maryland). Ce contenu est automatiquement synchronisé avec le référentiel Git distant de l'utilisateur.

C'est une application wiki open source, moderne et puissante basé sur Node.js, Git et Markdown. Le code source de Wiki.js est accessible au public à l'adresse Github, prêt à télécharger et à installer. Ceci est possible car Wiki.js est complètement open source, sous la licence GNU AGPLv3.

Fonctionnalités générales de Wiki.js

  • Nous pourrons rédiger notre contenu au format Markdown. Nous utiliserons le éditeur visuel intégré.
  • Contrairement à d'autres logiciels wiki qui enregistre le contenu dans une base de données, Wiki.js enregistrer tout le contenu directement dans les fichiers Markdown (.md). Ce contenu est automatiquement synchronisé avec notre référentiel Git distant. Si nous sommes intéressés.
  • L'application s'exécute sur le moteur Node.js. Cette optimisé pour utiliser de faibles ressources CPU. Il repose fortement sur la mise en cache pour fournir rapidement du contenu aux utilisateurs.
  • Le contenu généré est traité automatiquement dans un format de lecture propre. Il est présenté dans une interface utilisateur élégante.
  • Nous serons capables restreindre l'accès à notre Wiki à certains utilisateurs ou même à certaines parties du contenu.
  • Nous pourrons nous connecter en utilisant la base de données locale. Nous pourrons également nous connecter en utilisant fournisseurs d'authentification externes comme le compte Microsoft, l'identifiant Google, etc.
  • Le programme nous donnera la possibilité d'insérer des images, des diagrammes, des documents, des vidéos, des liens, etc. Pour cela, nous utiliserons le gestionnaire d'actifs Qui incorpore.
  • Nous pourrons trouver rapidement l'entrée du wiki que nous recherchons en utilisant le moteur de recherche intégré. Il nous fournira des résultats et des suggestions pertinents lors de l'analyse des métadonnées et du contenu de nos entrées de wiki.

Exigences du serveur

Afin de faire fonctionner ce programme, nous aurons besoin de certaines choses sur notre serveur.

  • Node.js 6.9.0 ou supérieur.
  • MongoDB 3.2 ou supérieur.
  • Git 2.7.4 ou supérieur.
  • Un référentiel Git (public ou privé). Ceci est facultatif.

Installez Wiki.js sur Ubuntu

Ce court article, nous verrons comment installer Wiki.js sur un serveur Ubuntu 18.04 avec toutes vos exigences nécessaires.

Installez Git

Pour commencer, nous devrons installer Git pour exécuter Wiki.js. Git est préinstallé sur le serveur Ubuntu. Vous n'aurez peut-être pas besoin de l'installer. Cependant, si vous avez besoin la dernière version de Git, ajoutez le référentiel suivant et installez-le:

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

sudo apt update && sudo apt upgrade

sudo apt install git

Installez Node.js

Node.js est une autre exigence obligatoire pour obtenir Wiki.js. Nous n'aurons qu'à exécuter les commandes suivantes pour installer Node.js:

sudo apt install curl

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

sudo apt install -y nodejs

Installez MongoDB

MongoDB est également l'une des exigences obligatoires pour Wiki.js. Nous allons installer la version fournie dans le référentiel Ubuntu. Nous n'aurons plus qu'à exécuter la commande:

sudo apt install mongodb

Téléchargez et installez Wiki.js

Une fois toutes les conditions remplies, nous pouvons téléchargez le script d'installation de Wiki.js et lancez-le. Pour faire cette course:

sudo mkdir /var/www/wikijs

cd /var/www/wikijs

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

Après avoir exécuté la dernière commande, vous devriez voir un message de réussite comme le suivant:

installer wiki.js

Après l'installation, il nous sera demandé d'exécuter le assistant de configuration. Nous pouvons le démarrer en exécutant:

sudo node wiki configure

Cette commande nous montrera un message à ouvrez l'URL http: // localhost: 3000 dans le navigateur pour configurer wiki.js.

configurer wiki.js

Si nous ouvrons notre navigateur et recherchons le nom d'hôte du serveur ou l'adresse IP suivie du port, l'assistant démarre. Ici, nous aurons différents écrans de configuration. Si nous ne voulons pas être trop compliqués, nous pouvons accepter les paramètres par défaut et continue.

configuration depuis le navigateur wiki.js

Le programme valider que le système répond aux exigences nécessaire.

vérification du système wiki.js

La prochaine chose que nous devrons remplir est le configuration générale.

Paramètres généraux de Wiki.js

Ensuite, nous devrons configurer le Connexion MongoDB. Si l'installation que nous avons effectuée auparavant a été correcte, nous pouvons appuyer sur le bouton «NOUS CONTACTER«. La fenêtre suivante sera la Configuration des chemins. Ici, ils recommandent de le laisser défectueux afin que nous continuions l'installation.

Sur l'écran suivant, nous pouvons ajouter les données de notre compte Git, ou ignorez cette étape.

Configuration de Git dans Wiki.js

Maintenant nous devrons créer un compte administrateur pour vous connecter plus tard.

paramètres du compte administrateur dans Wiki.js

Après cela et quelques autres écrans de configuration, Wiki.js devrait être installé et prêt à fonctionner.

Créez la page d'accueil avec Wiki.js

À la fin nous devrons nous connecter. Nous utiliserons le compte administrateur que nous avons créé précédemment pour créer notre page d'accueil.

Page de connexion Wiki.js

Et après tout cela, nous arriverons à l'éditeur. C'est là que nous pouvons commencer à créer.

Éditeur Wiki.js

Ceci est juste une installation de base. Pour obtenir plus d'informations sur cette plateforme wiki, à propos de son installation, de son utilisation ou pour voir la documentation officielle, nous pouvons visiter le page du projet.


Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont marqués avec *

*

*

  1. Responsable des données: Miguel Ángel Gatón
  2. Finalité des données: Contrôle du SPAM, gestion des commentaires.
  3. Légitimation: votre consentement
  4. Communication des données: Les données ne seront pas communiquées à des tiers sauf obligation légale.
  5. Stockage des données: base de données hébergée par Occentus Networks (EU)
  6. Droits: à tout moment, vous pouvez limiter, récupérer et supprimer vos informations.