« Installer VisualEditor pour MediaWiki 1.30.0 » : différence entre les versions

De Adadov.net wiki
(12 versions intermédiaires par le même utilisateur non affichées)
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 10 : Ligne 14 :


== Installation de Parsoid ==
== Installation de Parsoid ==
{{Info|1=Parsoid 0.9.0 n'est pas supporté sous mediawiki avant la version 1.31}}
{{Info|1=Parsoid 0.9.0 n'est pas supporté sous mediawiki 1.30}}


=== Installation des dépendances ===
=== Installation des dépendances ===
Ligne 19 : Ligne 23 :
=== 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 https://gerrit.wikimedia.org/r/p/mediawiki/services/parsoid
{{LxTerm|git clone <nowiki>https://gerrit.wikimedia.org/r/p/mediawiki/services/parsoid</nowiki>
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.
Ligne 35 : Ligne 39 :


  uri: '<nowiki>http://monwiki/w/api.php'</nowiki>
  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 ===
Ligne 41 : Ligne 47 :
Pour ça il faut ajouter un script à SystemD.
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="text">
On va donc créer le script {{Path|/etc/systemd/system/parsoid.service}} avec le contenu suivant:
 
<source lang="ini">
[Unit]
[Unit]
Description=Mediawiki Parsoid web service on node.js
Description=Mediawiki Parsoid web service on node.js
Ligne 62 : Ligne 70 :
PrivateTmp=true
PrivateTmp=true
StandardOutput=syslog
StandardOutput=syslog
</syntaxhighlight>Une fois le script sauvé, on peut activer et démarrer le serveur via systemd.
</source>
 
Une fois le script sauvé, on peut activer et démarrer le serveur via systemd.
{{LxTerm|systemctl enable --now parsoid.service}}
{{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 ==
== 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}}
<source 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';
</source>
Vous devriez maintenant pouvoir profiter de l'éditeur visuel de mediawiki.

Version du 19 mai 2018 à 16:44

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.

Voici comment ...

Installation de Parsoid

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-pythondblclick to copy

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/parsoiddblclick to copy
[root@linux] # git checkout 0.8.0

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

[root@linux] # npm installdblclick to copy

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.servicedblclick to copy

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:

[root@linux] # curl -L http://localhost:8000/localhost/v3/page/html/[page]/dblclick to copy

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

Pour récupérer les sources on utilisera encore GIT.

[root@linux] # git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/VisualEditor.gitdblclick to copy
[root@linux] # cd VisualEditor
[root@linux] # git checkout 1.30.0
[root@linux] # 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 LocalSettings.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';

Vous devriez maintenant pouvoir profiter de l'éditeur visuel de mediawiki.