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 === | | === Installation des dépendances === |
Ligne 23 : |
Ligne 19 : |
| === Installation du serveur === | | === 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: | | 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> | | {{LxTerm|git clone https://gerrit.wikimedia.org/r/p/mediawiki/services/parsoid |
| git checkout 0.8.0|user=root}} | | 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. | | 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}} | | {{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 === | | === Ajout du script de démarrage === |
| Le mieux reste de voir Parsoid démarrer automatiquement lors du démarrage du serveur.
| | Afin de pouvoir automatiser le démarrage de Parsoid via SystemD, il faut ajouter le script suivant: |
| | | <source lang="text"> |
| 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] | | [Unit] |
| Description=Mediawiki Parsoid web service on node.js | | Description=Mediawiki Parsoid web service on node.js |
Ligne 70 : |
Ligne 48 : |
| PrivateTmp=true | | PrivateTmp=true |
| StandardOutput=syslog | | StandardOutput=syslog |
| </syntaxhighlight> | | </source> |
| | |
| 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.
| |