Aide:Installation du logiciel MediaWiki

Un article de Wikipédia, l'encyclopédie libre.

Cette page a pour but d'expliquer comment installer Mediawiki.

Mediawiki vous permet de vous créer en quelques minutes un wiki personnalisable, soit pour une utilisation privée ou en réseau interne sur votre PC ou plusieurs PC, soit pour votre site.

Wikilivres propose un ouvrage abordant ce sujet : MediaWiki pour débutants.

Sommaire

1 Comment installer un wiki chez soi ?
- 1.1 Linux
- 1.2 Windows
2 Alternative
3 Guide pour aller plus loin

[modifier] Comment installer un wiki chez soi ?

[modifier] Linux

[modifier] Cas général

Les points de départ sont :

Les étapes :

Chercher les sources à partir du lien donné sur http://wikipedia.sourceforge.net/ ou directement à partir de CVS comme expliqué sur sourceforge
Décompresser ces sources dans un répertoire de travail (par exemple: /tmp/wikipedia
Lire le fichier nommé INSTALL se trouvant dans les sources
Il faudra installer Apache, php et MySQL. Les procédures détaillées sont décrites dans le fichier INSTALL. Apache aura besoin de mod_rewrite.
Comme expliqué dans INSTALL, il faudra créer et configurer les fichiers LocalSettings.php et AdminSettings.php; notamment avec les mots de passe des utilisateurs de MySQL et les répertoires choisis dans la configuration de Apache (httpd.conf)
L'installation du logiciel Wikipédia en lui-même se fera en lançant le fichier d'installation php install.php. Il copiera les fichiers php, créera la base de données et les tables.
L'installation crée 2 utilisateurs, mais j'ignore le mot de passe. Mais il est facile d'utiliser MySQL pour donner les droits d'administrateur et/ou de développeur à un utilisateur USER.user_rights -> 'sysop, developer'

Pour les configurations, on peut utiliser :

apache: DocumentRoot "/usr/local/apache/htdocs"
Dans LocalSettings.php :
- $IP = "/usr/local/apache/wiki-php";

[modifier] Distributions utilisant APT

Les distributions concernées sont Debian, Knoppix et Ubuntu.

Installez le paquet nommé "mediawiki"

[modifier] Distribution Gentoo

Les utilisateurs de Gentoo peuvent passer par portage pour installer Mediawiki : http://packages.gentoo.org/search/?sstring=mediawiki.

[modifier] Windows

[modifier] Installation de Mediawiki sur son PC

Télécharger et installer Easyphp : http://www.easyphp.org/ (la version actuelle d'EasyPHP ne prend pas en compte le PHP5 présent à partir de wiki 1.7) ou Wamp : http://www.wampserver.com/
Télécharger Mediawiki : http://sourceforge.net/projects/wikipedia
- Il faut le décompresser deux fois. Si vous n'avez pas de compresseur pour les extensions gz et tar, vous pouvez télécharger par exemple 7-zip : http://www.7-zip.org/
Placer le dossier Mediawiki obtenu dans EasyPHP\www (vous pouvez renommer le dossier mediawiki, par exemple : wiki)
Lancer easyphp.
Lancer votre navigateur.
Tapez l'adresse : http://localhost/mediawiki-X.X/ (X étant le numéro de version du dossier Médiawiki), ou http://localhost/wiki par exemple, si vous avez renommé le dossier.
Suivez le processus d'installation :
- définir une licence ;
- donner un nom à votre wiki ;
- choisir un pseudo et un mot de passe ;
- choisir un mot de passe pour la base de données ;
- il n'est pas nécessaire de remplir les autres cases ;
- Avec Mediawiki 1.6xx, il peut être nécessaire de créer une base de données vide et de donner un mot de passe au login root avec phpmyadmin ; vous entrerez alors le nom de la base, le login root et le mot de passe de root dans la page d'installation de Mediawiki ; ensuite, vous devez ajouter votre mot de passe dans le fichier de configuration de phpmyadmin pour pouvoir y accéder.
Lancez l'installation en cliquant sur Install.
Une fois l'installation terminée, cliquer sur le lien qui s'affiche en bas à droite ;
déplacer le fichier LocalSettings.php qui se trouve dans le dossier mediawiki-X.X/Config vers le dossier supérieur : mediawiki-X.X.
Revenez à votre navigateur et cliquez sur OK dans la barre de navigation : votre wiki apparaît !

note importante : Ce que vous avez créé (serveur, mediawiki et contenu) peut être dupliqué sur d'autres PC sous Windows. Il suffit de copier/coller le répertoire créé "\Program Files\EasyPHP\"

[modifier] Installation de Mediawiki sur un serveur non-dédié

Télécharger et installer Easyphp : http://www.easyphp.org/ ou Wamp : http://www.wampserver.com/
Télécharger Mediawiki : http://sourceforge.net/projects/wikipedia
- Il faut le décompresser deux fois. Si vous n'avez pas de compresseur pour les extensions gz et tar, vous pouvez télécharger par exemple 7-zip : http://www.7-zip.org/
Placer le contenu du dossier Mediawiki obtenu dans EasyPHP/www (vous devez pour cela supprimer le fichier "index.php contenu dans ce dossier. si vous comptez vous servir plus tard d'EasyPhp, archivez "index.php" dans un autre dossier que EasyPHP/www.)
Lancer easyphp.
Lancer dans easyphp : e - Configuration - PhpMyadmin. Aller dans "Privilèges" et cliquer sur la petite icône tout à droite de la colonne "root". Rentrer un mot de passe pour l'utilisateur.
Lancer votre navigateur.
Tapez l'adresse : http://localhost/.
Suivez le processus d'installation :
- définir une licence ;
- donner un nom à votre wiki ;
- choisir un pseudo et un mot de passe ;
- choisir un nom pour la base de données (noté dans la suite NomdelaBDD) ;
- choisir un mot de passe pour la base de données (login et mot de passe de PHPMyAdmin) ;
- il n'est pas nécessaire de remplir les autres cases.
Lancez l'installation en cliquant sur Install.
Une fois l'installation terminée :
- Déplacer le fichier LocalSettings.php qui se trouve dans le dossier EasyPHP/www/Config/ vers le dossier supérieur : EasyPHP/www/.
- Revenez à votre navigateur et cliquez sur OK dans la barre de navigation : votre wiki apparaît !

[modifier] Installation sur free.fr

Ensuite, les étapes à suivre sont les suivantes :
- Transférez par ftp tout le contenu de EasyPHP/www/ sauf LocalSettings.php
- Transférez les tables créées dans votre base de données. Il faut pour cela :
  - Accédez à votre base de données locale, en cliquant dans EasyPhp sur "administration" puis "BDD", ce qui vous amène à une page "PhpMyadmin"
  - Cliquez sur NomdelaBDD dans le volet de gauche : les tables créées par MediaWiki s'affichent dans le volet de droite. Cliquez sur "Exporter" en haut du volet de droite, puis sur "Tout sélectioner", ce qui sélectionne toutes les tables. Sélectionnez pour votre exportation "format zippé". Cliquez enfin sur "exécuter". Un fichier Zip s'enregistre alors sur votre ordinateur. Dézipez-le, vous obtenez un fichier texte nommé comme cela : NomdelaBDD.sql
  - Il faut maintenant transférer cela sur votre base de données free. Vous y accédez par http://sql.free.fr. Vous vous identifiez, puis vous cliquez à gauche sur "Votrelogin", puis sur l'icône marquée "SQL". Vous cliquez alors sur "parcourir" en-dessous de "emplacement du ficher texte", puis "exécuter". Vos tables sont maintenant transférées.
Il faut enfin modifier le fichier "LocalSettings.php". Ouvrez-le avec le bloc-notes. Puis :

Remplacez la ligne du genre $IP = "/var/www/mediawiki"; par la ligne $IP = ".";

ou alors :

Avant la ligne : if( defined( 'MW_INSTALL_PATH' ) ) { ... 
ajoutez la ligne suivante :
define( 'MW_INSTALL_PATH', $_SERVER['DOCUMENT_ROOT'].'/ mon répertoire d'installation' );
(sans oublier de remplacer '/ mon répertoire d'installation :) (source : http://faq.free.fr/adsl/5/9/3/10 )

puis :

Remplacez :  $wgArticlePath = "$wgScript/$1"; par :  #$wgArticlePath = "$wgScript/$1";
(Il suffit d'ajouter le #)

et enfin,

De même, remplacez :  #$wgArticlePath = "$wgScript?title=$1";  par : $wgArticlePath = "$wgScript?title=$1";
(Il suffit d'enlever le #)

Puis, le bloc suivant doit être rempli comme suit :

$wgDBserver         = "sql.free.fr";
$wgDBname           = "<nom de la base>";
$wgDBuser           = "<nom de l'utilisateur chez Free>";
$wgDBpassword       = "<mot de passe>";

Chez Free, le nom de la base est le même que celui de l'utilisateur et que l'adresse du site (sauf si le nom utilisateur contient un point (ex: "prenom.nom"). Dans ce cas, la base s'appelle "prenom_nom").

Enfin, ajoutez n'importe où dans le fichier la ligne suivante :

$wgUseDatabaseMessages = false;

Vous pouvez maintenant envoyer ce fichier à la racine de votre site web.
Enfin, créez un dossier "sessions" à la racine de votre site web.
Tapez dans votre navigateur l'adresse de votre site : votre wiki apparaît !

Attention tout ceci est valable pour la version 1.6.8 de mediawiki les versions 1.7.x et ultérieures tournant en php 5.x et free n'étant pas (septembre 2006) php 5 cela ne fonctionnera pas et il vous faudra utiliser la version 1.6.8 (php 4) de mediawiki.

FREE ET LE PHP5 : De nombreux utilisateurs des pages perso Free pensent que PHP 5 n'est pas disponible chez cet hébergeur gratuit. En réalité, pour des raisons de compatibilité avec d'anciens scripts, le choix est laissé entre PHP 4 et PHP 5 (et ce n'est pas une nouveauté !). Par défaut les fichiers portant l'extension ".php" sont interprêtés par PHP 4. Pour utiliser le moteur PHP 5, deux possibilités :

utiliser des fichiers avec l'extension ".php5" ;
ou plus simplement, créer (ou modifier si on n'en utilise déjà un pour d'autres raisons) un fichier ".htaccess" comportant simplement une ligne avec "php 1" (sans les guillemets).

[modifier] Modifier certaines fonctionnalités

Dans le fichier LocalSettings.php, pour activer l'importation de fichier son et image :

Ouvrir le fichier avec WordPad.
Trouver les lignes suivantes :

# To enable image uploads, make sure the 'images' directory
# is writable, then uncomment this:
# $wgEnableUploads              = true;
# $wgUseImageResize             = true;
# $wgUseImageMagick = true;
# $wgImageMagickConvertCommand = "/usr/bin/convert";

Supprimer les # :

## To enable image uploads, make sure the 'images' directory
## is writable, then uncomment this:
$wgEnableUploads                = true;
$wgUseImageResize               = true;
#$wgUseImageMagick = true;
#$wgImageMagickConvertCommand = "/usr/bin/convert";

Enregistrer. C'est fait !...

[modifier] Activer GD pour thumb et redimension des images

Lancer Easyphp
Cliquez sur le E en haut à gauche de la boîte de Easyphp pour avoir le menu, ou cliquez droit sur l'icône en bas à droite dans la barre Windows
Aller dans Configuration
Aller dans Extensions php
Faire défiler la liste jusqu'à Php_gd2
Cocher la case
Cliquer sur appliquer, puis fermer, et c'est fait

Cette activation peut être réalisée en éditant le fichier php.ini, dans le dossier Apache. Cherchez la ligne :

;extension=php_gd2.dll

supprimez le point virgule puis enregistrez.

[modifier] Installer des extensions

Pour installer une extension, enregistrer le fichier nomdel'extension.php dans votre dossier extensions, puis ajouter une ligne

require_once("extensions/nomsdel'extension.php");

dans le fichier LocalSettings.php.

Exemple :

pour pouvoir créer des boîtes de ce type (Informations sur cette extension) :

grâce à la syntaxe suivante :

 <inputbox>
 type=box type
 parameter1=value
 parameter2=value
 </inputbox>

Copier coller dans un nouveau fichier sous WordPad le fichier http://cvs.sourceforge.net/viewcvs.py/wikipedia/extensions/inputbox/ et l'enregistrer dans votre dossier extension sous le nom inputbox.php.
Ajouter la ligne dans le fichier LocalSettings.php en l'éditant avec WordPad :

require_once("extensions/inputbox.php");

[modifier] Trouver des extensions

[modifier] Transférer une base de données

Si vous souhaitez installer une base de données vers une nouvelle installation de Mediawiki, il est possible d'exporter chaque table et de les recréer une à une par phpmyadmin :

Sélectionner une table ;
Tout cocher, puis exporter ;
Sélectionner sql dans le menu Exporter ;
Sélectionner : Insertions complètes, dans Données.
Exécuter ;
Copier le résultat ;
Aller dans phpmyadmin de la nouvelle base de données ;
Onglet SQL ;
Coller le résultat de l'exportation ;
Exécuter.

Afin de réduire le temps de recopie des tables, vous pouvez exporter ensemble et en même temps les tables les plus petites, et les exécuter en même temps également dans la nouvelle base de données.

[modifier] Installer une base de données (Wikipédia, Wikibooks, etc.)

Etant donné que les informations sont introuvables sur ce sujet, nous vous conseillons la prière ou de tenter divers rituels magiques.

Télécharger une base de données
- Les bases de données wikipédia, wikibooks, wiktionary sont disponibles :
- http://download.wikipedia.org/
Théoriquement, vous pouvez créer la base de données dans MySQL :
- Dans MySQL, il faut taper les commandes suivantes : (cf. Requêtes SQL) :

 
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 16 to server version: 5.0.10-beta-log

Type 'help;' or '\h' for help. Type '\c' to clear the buffer.

mysql> CREATE DATABASE wikipedia;
Query OK, 1 row affected (0.37 sec)
mysql> USE wikipedia;
Database changed
mysql> SOURCE nom_du_fichier_wikimedia.sql;

La copie des informations dans les tables après avoir lancé SOURCE peut prendre plusieurs dizaines de minutes ou plusieurs heures suivant la taille de la base de données.

Installer Mediawiki :
- Donner au site que vous installez le nom exact du site de la base de données : Wikipédia, Wikilivres, etc.
- Remplacer le nom de la base de données par défaut (wikidb).

[modifier] Note

Le répertoire easyphp peut être ensuite copié/collé sur d'autres PC sous Windows, vous pouvez facilement donner Wikipédia (par contre il faudra l'updater grâce au dump dans MySQL

[modifier] Alternative

Eclipse est une plate-forme de développement qui peut très bien se déguiser en éditeur wiki WYSIWYG. Cette méthode évite d'avoir à installer MediaWiki pour ceux qui veulent juste modifier des articles localement tout en ayant une vue sur le résultat. Using Eclipse Wikipedia Editor

[modifier] Guide pour aller plus loin

Récupérée de « http://fr.wikipedia.org../../../i/n/s/Aide%7EInstallation_du_logiciel_MediaWiki_d497.html »

Catégories : MediaWiki • Wikipédia:Conseil au développeur