Version actuelle |
Votre texte |
Ligne 2 : |
Ligne 2 : |
|
| |
|
| J'ai récemment installé VisualEditor sur ce wiki ! | | J'ai récemment installé VisualEditor sur ce wiki ! |
|
| |
| Cet éditeur apporte une solution d'édition très intéressante pour les personnes qui ne sont pas familière avec le langage wiki.
| |
|
| |
| Mais cet éditeur demande pas mal de travail pour sa mise en service ...
| |
|
| |
|
| Et après de longues heures de combat, j'ai fini par le faire fonctionner. | | Et après de longues heures de combat, j'ai fini par le faire fonctionner. |
Ligne 14 : |
Ligne 10 : |
|
| |
|
| == Installation de Parsoid == | | == Installation de Parsoid == |
| {{Info|1=Parsoid 0.9.0 n'est pas supporté sous mediawiki 1.30}} | | {{Info|1=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.
| |
| {{LxTerm|dnf install nodejs npm vim-enhanced git policycoreutils-python|user=root}}
| |
| 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 {{Path|/opt/parsoid}} et j'ai demandé le tag de la version 0.8.0 afin d'avoir une version compatible:
| |
| {{LxTerm|git clone <nowiki>https://gerrit.wikimedia.org/r/p/mediawiki/services/parsoid</nowiki>
| |
| git checkout 0.8.0|user=root}}
| |
| Une fois nos sources en place, il ne reste plus qu'à lancer l'installation. Elle devrait se passer sans soucis.
| |
| | |
| {{LxTerm|npm install|user=root}}
| |
| | |
| === 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: '<nowiki>http://monwiki/w/api.php'</nowiki>
| |
| | |
| 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 {{Path|/etc/systemd/system/parsoid.service}} avec le contenu suivant:
| |
| | |
| <syntaxhighlight lang="ini">
| |
| [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
| |
| </syntaxhighlight>
| |
| | |
| Une fois le script sauvé, on peut activer et démarrer le serveur via systemd.
| |
| {{LxTerm|systemctl enable --now parsoid.service}}
| |
| | |
| === Tester Parsoid ===
| |
| Avant d'aller plus loin, on va tester Parsoid.
| |
| | |
| De cette manière on sera certain qu'il fonctionne et communique avec MediaWiki.
| |
| | |
| Pour ça une simple commande suffit:
| |
| {{LxTerm|text=curl -L <nowiki>http://localhost:8000/localhost/v3/page/html/[page]/</nowiki>}}
| |
| Remplacez [page] par le nom d'une page existante de votre wiki.
| |
| | |
| Vous devriez obtenir le code HTML de votre page en retour si tout s'est bien passé.
| |
| | |
| == Installation de l'extension VisualEditor ==
| |
| {{Warning|text=Ne pas oublier de récupérer les sous-modules}}Pour récupérer les sources on utilisera encore GIT.
| |
| {{LxTerm|text=git clone <nowiki>https://gerrit.wikimedia.org/r/p/mediawiki/extensions/VisualEditor.git</nowiki>
| |
| cd VisualEditor
| |
| git checkout 1.30.0
| |
| git submodule update --init}}
| |
| Les commandes ci-dessus vont télécharger les sources, demander le tag 1.30.0 (version de mediawiki) et télécharger les sous-modules.
| |
| | |
| Si on oublie la dernière, on va chercher pendant des heures pourquoi ça ne marche pas ...
| |
| | |
| == Configuration de MediaWiki ==
| |
| Maintenant que nous avons tout ce qu'il faut pour faire fonctionner VisualEditor, il ne reste plus qu'à demander à MediaWiki de le mettre en service.
| |
| | |
| Pour ça on ajoutera les lignes suivantes dans le fichier {{Path|LocalSettings.php}}
| |
| | |
| <syntaxhighlight lang="php">
| |
| $wgVirtualRestConfig['modules']['parsoid'] = array(
| |
| // URL vers Parsoid
| |
| 'url' => 'http://127.0.0.1:8000',
| |
| // Parsoid "domain", configuration par défaut
| |
| 'domain' => 'localhost',
| |
| // Parsoid "prefix", laisser vide
| |
| 'prefix' => '',
| |
| );
| |
| | |
| | |
| wfLoadExtension('VisualEditor');
| |
| // Activer par défaut VisualEditor pour tout le monde
| |
| $wgDefaultUserOptions['visualeditor-enable'] = 1;
| |
| | |
| // Masquer l'option d'activation dans les préférences utilisateur
| |
| $wgHiddenPrefs[] = 'visualeditor-enable';
| |
| </syntaxhighlight>
| |
| | |
| Vous devriez maintenant pouvoir profiter de l'éditeur visuel de mediawiki.
| |