Mediawiki Editeur Visuel

modifié le : 13 septembre 2022,
par Guillaume Chéramy
 

Pour ceux qui veulent avoir un éditeur plus "confortable" que le wikicode, il est possible d'installer l'extension VisualEditor.

Cette extension, à besoins d'un parser en nodejs pour fonctionner qui se nomme Parsoid.

Installation de Parsoid

L'installation se fait sur une distribution Debian 8 :

# echo "deb https://releases.wikimedia.org/debian jessie-mediawiki main" | tee /etc/apt/sources.list.d/parsoid.list
# echo "deb http://ftp.us.debian.org/debian/ jessie-backports main" >> /etc/apt/sources.list

# apt-key advanced --keyserver keys.gnupg.net --recv-keys 90E9F83F22250DD7

# apt-get install apt-transport-https

# apt-get update

# apt-get install -t jessie-backports nodejs
# apt-get install parsoid

La configuration se fait dans /etc/mediawiki/parsoid/config.yaml
La partie importante à changer :

mwApis:
- # This is the only required parameter,
# the URL of you MediaWiki API endpoint.
uri: 'http://uri_mediawiki/api.php'
# The "domain" is used for communication with Visual Editor
# and RESTBase. It defaults to the hostname portion of
# the `uri` property below, but you can manually set it
# to an arbitrary string.
domain: 'uri_mediawiki' # optional

Modifier uri et domain

On redémarre parsoid et on vérifie qu'il écoute sur le port 8142 (modifier le firewall si besoins).

Sources :
https://www.mediawiki.org/wiki/Parsoid/Setup

Installation de l'extension

Comme précisé la branche master du git à besoins de la version alpha de Mediawiki. Il faut donc récupérer la branche qui correspond à la version de Mediawiki en prod. Pour moi la 1.28.

Dans le répertoire extensions de mediawiki :

# git clone -b REL1_28 https://github.com/wikimedia/mediawiki-extensions-VisualEditor.git VisualEditor
# cd VisualEditor
# git submodule update --init

Modifications à faire dans LocalSettings.php

// VisualEditor
wfLoadExtension( 'VisualEditor' );

// Enable by default for everybody
$wgDefaultUserOptions['visualeditor-enable'] = 1;

// Don't allow users to disable it
$wgHiddenPrefs[] = 'visualeditor-enable';

$wgVirtualRestConfig['modules']['parsoid'] = array(
// URL to the Parsoid instance
// Use port 8142 if you use the Debian package
'url' => 'http://localhost:8142',
// Parsoid "domain", see below (optional)
'domain' => 'mediawiki.hisyl.info',
// Parsoid "prefix", see below (optional)
'prefix' => 'localhost'
);

$wgVirtualRestConfig['modules']['parsoid']['forwardCookies'] = true;

// End VisualEditor

Sources :
https://www.mediawiki.org/wiki/Extension:VisualEditor

Lors de l'édition d'une page on à maintenant la possibilité d'avoir un éditeur plus avancé que le wikicode :

mediawiki_editeur_visuel

Cet article sera sûrement augmenté à l'avenir suivant les paramétrages d'autres modules dépendant de VisualEditor, à suivre.