MediaWiki pour débutants/Configuration de votre wiki
Un livre de Wikibooks.
| Introduction | Installer | Utiliser | Naviguer | Configurer | Extensions | Fonctions | Maintenance |
|---|
Dans cette section, nous allons apprendre les bases de la configuration de MediaWiki et voir comment modifier l'apparence générale de votre wiki, afin de l'adapter à votre projet. Pour savoir ce qu'il est possible de faire et vous donner des idées, il peut être utile de visiter des wikis : une liste vous est donnée à la fin de cette page.
Les éléments de configuration que nous allons aborder ne demandent pas de manipulations compliquées. Il faut seulement connaître quelques opérations de base, comme copier, enregistrer ou charger un fichier sur un serveur. Dans ce qui suit, vous trouverez des lignes dans un langage que vous ne comprendrez peut-être pas : ceci n'est pas un obstacle, puisqu'il vous suffira de suivre exactement les étapes des procédures décrites.
Il existe deux manières générales de configurer votre site :
- en modifiant en ligne certains paramètres et certaines pages particulières ;
- en modifiant ou ajoutant des fichiers dans le dossier de votre site.
Sections |
[modifier] Utiliser des images
Nous allons tout d'abord rendre possible la copie d'images et de certains fichiers sur votre site : une fois installé, MediaWiki ne permet pas de faire de telles copies. Vous devez vous-mêmes en donner l'autorisation. En outre, il faut également autoriser le redimensionnement des images pour en maîtriser l'affichage.
La première chose à faire est d'éditer votre fichier LocalSettings.php. Ce fichier contient la configuration générale de votre wiki et il se trouve à la racine du dossier de votre wiki.
Une fois que vous avez ouvert le fichier avec un éditeur de texte, cherchez les lignes suivantes :
## To enable image uploads, make sure the 'images' directory ## is writable, then set this to true: $wgEnableUploads = false; $wgUseImageResize = false; # $wgUseImageMagick = true; # $wgImageMagickConvertCommand = "/usr/bin/convert";
Et remplacez les false par true, de cette manière :
## To enable image uploads, make sure the 'images' directory ## is writable, then set this to true: $wgEnableUploads = true; $wgUseImageResize = true; # $wgUseImageMagick = true; # $wgImageMagickConvertCommand = "/usr/bin/convert";
Sauvegardez cette modification, et copiez le fichier sur votre site. Ouvrez une page de votre site, et vous aurez, dans la boîte à outils à droite de l'écran, un lien Copier une image.
Mais ceci ne suffit pas pour pouvoir manipuler les images quand elles sont sur votre site ; il faut activer GD pour thumb et redimension des images :
Cette activation peut être réalisée en éditant le fichier php.ini, dans le dossier Apache. Si vous utilisez une installation locale, vous avez accès à ce fichier (c:\Wamp\Apache\) et vous pouvez le modifier avec un éditeur de texte (attention à ne modifier que ce qui est nécessaire). En revanche, si vous êtes chez un hébergeur, vous n'y avez pas accès. Généralement, par défaut, l'hébergeur peut avoir activé cette fonctionnalité : pour le vérifier, copier une image sur votre site, et essayez de l'afficher en modifiant sa taille). Si ce n'est pas le cas, envoyez-lui un courrier pour savoir si cela est possible.
Cherchez la ligne :
;extension=php_gd2.dll
supprimez le point virgule puis enregistrez.
Vous pouvez maintenant copier des images sur votre site, et les afficher avec les dimensions que vous souhaitez.
Pour modifier la taille limite
$wgMaxUploadSize
Pour modifier la valeur limite pour le message d'avertissement
$wgUploadSizeWarning
 |
Astuce pour les administrateurs : Pour permettre le téléchargement de fichiers, l'administrateur du wiki doit éditer le fichier LocalSettings.php et décommenter l'option $wgEnableUploads = true;. Les fichiers téléchargés seront stockés dans le répertoire des images spécifié par la variable $wgUploadPath dans le fichier LocalSettings.php. Ce répertoire doit être autorisé en écriture si le téléchargement de fichiers est activé. Les paramètres de configuration $wgUploadPath et $wgUploadDirectory décrivent les paramètres de configuration des téléchargements. |
[modifier] Configurer le niveau d'accès à votre wiki
Par défaut, toute personne accédant à votre wiki est en mesure d'en modifier les pages, sauf certaines pages protégées par le logiciel ou par vous. La configuration de base de l'accès à votre wiki se fait par la modification du fichier LocalSettings.php. D'autres configurations sont possibles, mais elles sont plus complexes à mettre en œuvre et nous les aborderons plus loin dans ce livre.
[modifier] Déterminer qui peut éditer ou voir votre wiki
Afin d'exclure de l'édition les utilisateurs non enregistrés, éditez votre fichier LocalSettings.php, et ajoutez les lignes suivantes :
# Qui peut éditer : false signifie que seuls les utilisateurs enregistrés peuvent éditer. $wgGroupPermissions['*']['edit'] = false;
Afin d'interdire la visualisation de votre wiki, sauf les pages d'Accueil et d'inscription, aux personnes non enregistrées, éditez votre fichier LocalSettings.php, et ajoutez les lignes suivantes :
# Pages anonymous (not-logged-in) users may see $wgWhitelistRead = array( "Accueil", "Special:Userlogin" ); $wgGroupPermissions['*']['read'] = false;
[modifier] Blocage d'urgence
[modifier] Configurer l'apparence
[modifier] Changer le logo
Dans le fichier LocalSettings.php, à la ligne 50 il faut modifier l'image :
$wgLogo = "$wgStylePath/skins/common/images/wiki.png";
Cette image se trouve dans le répertoire /skins/common/images/ et mesure 135×135 pixels. Il suffit de télécharger une nouvelle image du même format et de modifier la ligne $wgLogo.
[modifier] Changer le fond
La configuration du fond de votre wiki va se faire à partir de votre site, par la modification de la page MediaWiki:Monobook.css. Cette page permet de modifier de nombreux éléments de l'affichage. Vous ne pouvez la modifier qu'en tant qu'administrateur du site, car elle fait partie des pages que MediaWiki protège à l'installation.
body
{
background: white;
}
Ceci permet l'affichage d'un fond blanc.
body
{
background: rgb(238, 255, 238) url(adresse de l'image de fond) repeat;
}
En plaçant l'adresse d'un motif entre les parenthèses, il vous servira de fond en arrière-plan.
[modifier] Personnaliser les couleurs
[modifier]
|
Astuce pour les administrateurs : Vous pouvez personnaliser les liens de navigation via Special:Allmessages. Par exemple, éditez MediaWiki:Sitesupport (nom affiché) et MediaWiki:Sitesupport-url (page de destination). Ou créez votre propre menu dans MediaWiki:Sidebar. |
La boîte de navigation est une boîte située à gauche de l'écran, et dans laquelle on trouve des liens généraux ou particuliers qui, spécialement placés à cet endroit, sont accessibles depuis n'importe quelle page de votre wiki. Il est donc important de la configurer, puisque les liens que vous y placerez peuvent être adaptés à votre projet. Par exemple, si vous créez un index (pour des livres, des sites, etc.), il est pratique de pouvoir accéder directement à celui par un lien toujours affiché à l'écran.
Cette boîte est modifiable à partir de la page MediaWiki:Sidebar. Vous ne pouvez la modifier qu'en tant qu'administrateur.
Par défaut, le contenu de cette boîte est le suivant :
* navigation ** mainpage|mainpage ** portal-url|portal ** currentevents-url|currentevents ** recentchanges-url|recentchanges ** randompage-url|randompage ** helppage|help ** sitesupport-url|sitesupport
[modifier] Pour aller plus loin
- Personnaliser son monobook, niveau simple (placez les codes prévus pour les monobooks personnels dans les monobooks de votre wiki pour que la configuration s'étende à tout votre site).
- Fonctions avancées, niveau plus élevé
- La configuration du fichier LocalSettings.php (en anglais)
- Liste de sites utilisant MediaWiki
