Installer VisualEditor pour MediaWiki 1.30.0

J'ai récemment installé VisualEditor sur ce wiki !

Et après de longues heures de combat, j'ai fini par le faire fonctionner.

Voici comment ...

Installation de Parsoid

Parsoid 0.9.0 n'est pas supporté sous mediawiki avant la version 1.31

Installation des dépendances

Avant de pouvoir installer Parsoid, il faut installer ses dépendances.

[root@linux] #

dnf install nodejs npm vim-enhanced git policycoreutils-python

dblclick to copy

<nowiki>dnf install nodejs npm vim-enhanced git policycoreutils-python </nowiki>

Si vous ne l'avez pas, pensez à installer GIT aussi. Il est nécessaire pour installer les sources de Parsoid

Installation du serveur

J'ai utilisé GIT pour les récupérer et les placer dans le dossier /opt/parsoid et j'ai demandé le tag de la version 0.8.0 afin d'avoir une version compatible:

[root@linux] #	git clone https://gerrit.wikimedia.org/r/p/mediawiki/services/parsoid	dblclick to copy
[root@linux] #	git checkout 0.8.0

<nowiki>git clone https://gerrit.wikimedia.org/r/p/mediawiki/services/parsoid

git checkout 0.8.0

</nowiki>

Une fois nos sources en place, il ne reste plus qu'à lancer l'installation. Elle devrait se passer sans soucis.

[root@linux] #

npm install

dblclick to copy

<nowiki>npm install </nowiki>

Configuration de Parsoid

La configuration de Parsoid pour une utilisation simple est très rapide.

Copiez le fichier config.sample.yaml vers config.yaml et éditez le.

Modifiez la ligne uri: pour qu'elle pointe sur le fichier api.php de votre wiki.

Elle devra avoir la forme suivante:

uri: 'http://monwiki/w/api.php'

Ne vous occupez pas des autres options pour le moment. Vous verrez plus tard si vous souhaitez pousser votre configuration plus loin.

Ajout du script de démarrage

Le mieux reste de voir Parsoid démarrer automatiquement lors du démarrage du serveur.

Pour ça il faut ajouter un script à SystemD.

On va donc créer le script /etc/systemd/system/parsoid.service avec le contenu suivant:

[Unit]
Description=Mediawiki Parsoid web service on node.js
Documentation=http://www.mediawiki.org/wiki/Parsoid
Wants=local-fs.target network.target
After=local-fs.target network.target

[Install]
WantedBy=multi-user.target

[Service]
Type=simple
User=root
Group=root
WorkingDirectory=/opt/parsoid
# EnvironmentFile=-/etc/parsoid/parsoid.env
ExecStart=/usr/bin/node /opt/parsoid/bin/server.js
KillMode=process
Restart=on-success
PrivateTmp=true
StandardOutput=syslog

Une fois le script sauvé, on peut activer et démarrer le serveur via systemd.

[root@linux] #

systemctl enable --now parsoid.service

dblclick to copy

<nowiki>systemctl enable --now parsoid.service </nowiki>