Wikibase/Installation

Ce document traite de l'installation de l'extension Wikibase pour MediaWiki. Pour les instructions à propos de l'installation manuelle de Wikibase Suite, voir Wikibase/Suite . Pour les instructions à propos de l'installation manuelle de Wikibase Suite sous Docker, voir Wikibase/Docker .

This page provides step-by-step instructions for installing a basic, minimal version of Wikibase. If you're interested in more advanced configurations, please refer to the advanced configuration guide. More detailed documentation bound to each version of the code can be found in the docs folder of the Wikibase source repository: see doc.wikimedia.org.

Prérequis

MediaWiki

Since Wikibase is an extension (actually two extensions) to MediaWiki, you'll first need to set up MediaWiki.

Avertissement :

Wikibase ne gère pas la compatibilité avec les anciennes versions de MediaWiki ! Il est très probable que les versions récentes de Wikibase ne fonctionnent pas avec les versions plus anciennes de MediaWii (et vice versa). Use the most recent versions of MediaWiki and Wikibase (master branches), or download the Wikibase release that matches your version of MediaWiki.

Composer

The easiest way to install all dependencies for Wikibase is to use Composer. Install Composer using these instructions.

Installation

L'installation basique de Wikibase comprend quatre étapes :

1. Obtenir Wikibase
2. Installer les dépendances
3. Modifier LocalSettings.php
4. Exécuter les scripts de maintenance

Le guide suivant va vous conduire au travers de ces étapes.

Avant de commencer

Make sure you've set up MediaWiki and installed Composer.

Fresh MediaWiki

Obtenir Wikibase

Determine which version of MediaWiki you have by navigating to wiki/Special:Version; use the Wikibase release corresponding to your MediaWiki version.

If you have the latest version of MediaWiki, download the latest version of Wikibase (or the version matching your MediaWiki installation) into the extensions folder of your MediaWiki installation.

Installer les dépendances

Thanks to the composer-merge-plugin, you can simply rename the composer.local.json-sample file in the root of your MediaWiki install directory to composer.local.json.

Puis à partir de la racine de votre installation MediaWiki, exécutez :

rm composer.lock

Puis, en supposant que composer est disponible comme binaire :

composer install --no-dev

Modifier LocalSettings.php

For repositories whose version numbers are 1.36+

If you intend to run a wiki where Wikibase entries are edited, then you want a Wikibase repository and should include the following in your 'LocalSettings.php'.

wfLoadExtension( 'WikibaseRepository', "$IP/extensions/Wikibase/extension-repo.json" );
require_once "$IP/extensions/Wikibase/repo/ExampleSettings.php";

For clients whose version numbers are 1.36+

If you intend to run a wiki which takes data from a different wiki instance where the entries are created, then you want a Wikibase client and should include the following in your 'LocalSettings.php'.

wfLoadExtension( 'WikibaseClient', "$IP/extensions/Wikibase/extension-client.json" );
require_once "$IP/extensions/Wikibase/client/ExampleSettings.php";

For repositories whose version numbers are 1.36 or lower

If you intend to run a wiki where Wikibase entries are edited, then you want a Wikibase repository and should include the following in your 'LocalSettings.php'.

$wgEnableWikibaseRepo = true;
require_once "$IP/extensions/Wikibase/repo/Wikibase.php";
require_once "$IP/extensions/Wikibase/repo/ExampleSettings.php";

For clients whose version numbers are 1.36 or lower

If you intend to run a wiki which takes data from a different wiki instance where the entries are created, then you want a Wikibase client and should include the following in your 'LocalSettings.php'.

$wgEnableWikibaseClient = true;
require_once "$IP/extensions/Wikibase/client/WikibaseClient.php";
require_once "$IP/extensions/Wikibase/client/ExampleSettings.php";

Exécuter les scripts de maintenance

En fin, exécuter quelques scripts de maintenance -- parmi eux le script de mise à jour de la base de données et les scripts qui remplissent la table des sites ainsi que la table interwiki.

Version de MediaWiki :

≥ 1.36

php maintenance/run.php ./maintenance/update.php
php maintenance/run.php ./extensions/Wikibase/lib/maintenance/populateSitesTable.php
php maintenance/run.php ./extensions/Wikibase/repo/maintenance/rebuildItemsPerSite.php
php maintenance/run.php ./maintenance/populateInterwiki.php

Version de MediaWiki :

≤ 1.35

php maintenance/update.php
php extensions/Wikibase/lib/maintenance/populateSitesTable.php
php extensions/Wikibase/repo/maintenance/rebuildItemsPerSite.php
php maintenance/populateInterwiki.php

Par défaut, exécuter populateSitesTable.php va remplir le tableau des sites avec la liste des projets Wikimedia. See Manual:Sites table#Managing the sites table for how to list non-WMF projects.

Running populateInterwiki.php will overwrite existing links in your interwiki table with Wikipedia values.

Vérifier l'installation

• Navigate to the Special:NewItem page in your MediaWiki and create your first Item. Saisissez une étiquette, une description facultative, des alias et cliquez sur Create pour créer. Vous devriez être redirigé vers la page de l'élément.

Special:NewItem page spéciale

Votre premier élément

• Vérifiez qu'il existe un élément Add links pour ajouter des liens, dans la section des liens de langue de la barre latérale, sur la page d'accueil.

Page du premier élément

Références

Fichier README de Wikibase