MediaWiki
| 🏠 Accueil | 📚 Index | 🐧 Linux | 🌐 Réseau | 🔒 Cybersécurité | 🖥️ Virtualisation | ✅ Checklists d'intervention | 📚 Tutoriels | 🤝 Services |
|---|
MediaWiki est un logiciel libre de gestion de contenu spécialisé dans les wikis. Il permet de créer des pages interconnectées, de conserver l'historique des modifications, de gérer les utilisateurs et de structurer une importante documentation.
Il est notamment utilisé pour Wikipédia et de nombreux projets documentaires. Il convient également à la création d'une base de connaissances technique, d'un manuel informatique ou d'une documentation interne.
1. Qu'est-ce que MediaWiki ?
MediaWiki est un CMS spécialisé dans la publication collaborative de connaissances. Contrairement à un CMS principalement conçu pour un site vitrine ou une boutique, il privilégie les pages documentaires, les liens internes, les catégories et l'historique des modifications.
Il permet notamment de :
- Créer des pages d'information et des tutoriels.
- Relier les pages entre elles grâce aux liens internes.
- Classer les documents dans des catégories.
- Conserver les anciennes versions des pages.
- Comparer les modifications et restaurer une version précédente.
- Gérer les comptes, les groupes et les droits d'accès.
- Ajouter des fonctionnalités grâce aux extensions.
- Personnaliser l'apparence du wiki avec un thème et du CSS.
- Organiser une base de connaissances qui évolue progressivement.
Des pages interconnectées Chaque page peut renvoyer vers des notions, des procédures et des tutoriels associés.
Un historique détaillé Les modifications sont enregistrées afin de suivre l'évolution du contenu.
Un logiciel extensible Les extensions, modèles, pages système et feuilles de style permettent de personnaliser le wiki.
2. À quoi sert MediaWiki ?
MediaWiki peut être utilisé dans de nombreux contextes.
| Utilisation | Exemple |
|---|---|
| Documentation informatique | Procédures d'installation de logiciels, configuration réseau et dépannage. |
| Base de connaissances | Articles décrivant des problèmes récurrents et leurs solutions. |
| Documentation technique | Documentation d'un serveur, d'une application ou d'une infrastructure. |
| Support informatique | Guides pour aider les utilisateurs à résoudre des incidents. |
| Formation | Cours, fiches pratiques, lexiques et exercices. |
| Projet collaboratif | Rédaction de documents par plusieurs contributeurs. |
| Documentation personnelle | Notes techniques, commandes, configurations et procédures. |
Pour Wiki Pat-Informatik, MediaWiki permet de regrouper les tutoriels, les fiches de dépannage, les informations sur les logiciels et les procédures d'administration dans un seul espace documentaire.
3. Comment fonctionne MediaWiki ?
MediaWiki est une application web. Le navigateur communique avec le serveur, qui exécute le logiciel et utilise les ressources nécessaires pour afficher les pages.
1. Navigateur
2. Apache
3. MediaWiki et PHP
4. Base de données et fichiers
Les principaux composants
- MediaWiki : le logiciel principal du wiki.
- PHP : le langage utilisé pour exécuter l'application.
- Base de données : généralement MariaDB ou MySQL dans une installation classique.
- Serveur web : Apache ou Nginx, selon la configuration retenue.
- Répertoire des fichiers : images, documents et autres médias téléversés.
- LocalSettings.php : fichier principal de configuration de l'installation.
- Skin : interface graphique utilisée pour afficher les pages.
- Extensions : modules qui ajoutent des fonctionnalités.
Les contenus et leurs historiques sont principalement conservés dans la base de données. Les fichiers téléversés sont stockés dans le répertoire prévu à cet effet. Une sauvegarde complète doit donc prendre en compte les deux.
4. Installer MediaWiki
L'installation doit être adaptée à la version de MediaWiki choisie et à l'environnement du serveur.
Prérequis techniques
Avant de commencer, vérifier :
- La version du système d'exploitation.
- La version de PHP et les extensions PHP requises.
- La compatibilité de MariaDB ou MySQL.
- La présence d'Apache ou d'un autre serveur web compatible.
- Les permissions des répertoires.
- La disponibilité d'un nom de domaine et d'un certificat HTTPS.
- L'espace disque nécessaire aux contenus et aux sauvegardes.
Important : consulter les prérequis officiels de la version installée. Ne pas reprendre automatiquement une configuration prévue pour une ancienne version.
Les grandes étapes
Étape 1 — Préparer le serveur
Mettre le système à jour, vérifier les versions logicielles et installer les composants compatibles.
Étape 2 — Préparer la base de données
Créer une base dédiée et un compte réservé à MediaWiki, avec uniquement les droits nécessaires.
Étape 3 — Télécharger MediaWiki
Récupérer une version stable depuis le site officiel et déployer les fichiers dans le répertoire prévu.
Étape 4 — Configurer le serveur web
Créer l'hôte virtuel Apache ou la configuration équivalente, puis préparer l'accès HTTPS.
Étape 5 — Lancer l'installation
Accéder à l'assistant web, renseigner la base de données et les paramètres du wiki, puis suivre les instructions.
Étape 6 — Finaliser et sécuriser
Vérifier la configuration, les permissions, la création du compte administrateur, le HTTPS et le fonctionnement des pages.
La documentation officielle décrit la procédure d'installation et les prérequis à respecter.
5. Découvrir l'interface de MediaWiki
L'interface dépend du thème installé et de sa configuration. Avec le skin Vector 2022, on retrouve généralement plusieurs zones importantes.
🔎 Recherche
Permet de retrouver une page à partir de mots-clés ou de son titre.
📑 Navigation
Regroupe les menus et les liens utiles pour parcourir le wiki.
✏️ Actions sur les pages
Selon les droits, permet de consulter, modifier ou afficher l'historique d'une page.
👤 Compte utilisateur
Donne accès aux préférences et aux fonctions personnelles autorisées.
Quelques pages spéciales utiles
Les pages spéciales sont des fonctions intégrées à MediaWiki. Elles ne se créent pas comme des articles ordinaires.
- Pages spéciales — liste des outils disponibles.
- Recherche — rechercher dans le wiki.
- Pages orphelines — repérer des pages sans liens entrants.
- Pages demandées — identifier des liens internes vers des pages inexistantes.
- Catégories — consulter les catégories du wiki.
- Modifications récentes — suivre l'activité.
- Téléverser un fichier — disponible si le téléversement est autorisé.
- Version — consulter les informations sur le logiciel et les extensions installées.
La disponibilité de certaines fonctions dépend des réglages et des droits attribués.
6. Créer et modifier une page
La rédaction constitue l'une des principales activités d'un wiki.
Créer une nouvelle page
- Rechercher le titre souhaité dans la barre de recherche.
- Si la page n'existe pas et que les droits le permettent, utiliser le lien proposé pour la créer.
- Saisir le contenu en utilisant la syntaxe wiki.
- Ajouter les liens internes et la catégorie appropriée.
- Prévisualiser la page.
- Vérifier le résultat puis enregistrer.
Exemple de syntaxe wiki
| Objectif | Syntaxe | Résultat | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| Titre de section | == Introduction == |
Un titre de niveau 2. | ||||||||
| Texte en gras | Important |
Important | ||||||||
| Texte en italique | Exemple |
Exemple | ||||||||
| Lien interne | Linux |
Linux | ||||||||
| Lien avec libellé | Windows |
Windows | ||||||||
| Lien externe | Documentation |
Documentation | ||||||||
| Liste à puces | * Premier élément |
Une liste à puces. | ||||||||
| Liste numérotée | # Première étape |
Une liste numérotée. | ||||||||
| Image | [[ ]] |
Affiche une image téléversée. | ||||||||
| Catégorie | |
Classe la page dans la catégorie Linux. | ||||||||
| Modèle |
|
Bonnes pratiques de rédaction
- Utiliser un titre explicite.
- Commencer par une courte présentation.
- Organiser les explications avec des titres hiérarchisés.
- Décrire les manipulations dans l'ordre.
- Préciser les versions logicielles lorsque c'est important.
- Ajouter des exemples, des captures d'écran et des commandes utiles.
- Vérifier les liens internes et les liens externes.
- Prévisualiser la page avant de l'enregistrer.
- Ajouter un résumé de modification compréhensible.
7. Organiser les pages avec les catégories
Les catégories permettent de regrouper les pages par sujet. Elles facilitent la navigation et aident à construire une documentation cohérente.
Exemple
En bas d'une page consacrée à Linux, on peut ajouter :
[[Catégorie:Linux]] [[Catégorie:Systèmes d'exploitation]] [[Catégorie:Serveur]]
Les noms de catégories doivent être choisis avec cohérence. Il est préférable de réutiliser une catégorie existante plutôt que de créer plusieurs catégories presque identiques.
Conseils pour un wiki informatique
- Créer des catégories correspondant aux grands domaines : réseau, sécurité, systèmes, logiciels et matériel.
- Utiliser des sous-catégories lorsque le volume de pages le justifie.
- Éviter de multiplier les catégories sans contenu.
- Vérifier régulièrement les pages non catégorisées.
- Ajouter des liens entre les pages d'un même domaine.
8. Les modèles MediaWiki
Un modèle permet de réutiliser un même bloc de contenu dans plusieurs pages. Il est particulièrement utile pour les éléments communs, les encadrés d'avertissement, les menus ou les fiches normalisées.
Exemple d'utilisation
Si le modèle `Navigation` existe sur le wiki, il peut être inséré dans une page avec :
{{Navigation}}
MediaWiki affiche alors le contenu défini dans le modèle correspondant.
Exemples de modèles utiles
- Modèle de navigation générale.
- Modèle d'avertissement de sécurité.
- Modèle de prérequis.
- Modèle de procédure pas à pas.
- Modèle de liens vers des ressources officielles.
- Modèle de pied de page.
Pour créer un modèle, il faut généralement créer une page dans l'espace de noms `Modèle:`. Les modèles peuvent recevoir des paramètres afin d'adapter leur contenu à chaque page.
Attention : un modèle doit être testé avant d'être utilisé partout. Une modification peut avoir des conséquences sur toutes les pages qui l'incluent.
9. Personnaliser l'apparence du wiki
MediaWiki permet de personnaliser son interface, notamment avec un skin, des feuilles de style CSS et du JavaScript.
Les skins
Un skin détermine l'apparence générale du wiki : menus, navigation, largeur de contenu et présentation des commandes.
Le skin Vector 2022 est utilisé par de nombreux projets Wikimedia. Il propose une interface moderne avec des menus de navigation et des outils adaptés à la consultation des pages.
Le CSS
Le CSS permet de modifier la présentation des éléments :
- Couleurs des titres et des encadrés.
- Espacement et bordures.
- Présentation des tableaux.
- Mise en page des cartes.
- Taille et alignement de certains éléments.
Les personnalisations globales sont souvent placées dans une page comme `MediaWiki:Common.css`, lorsque les droits permettent de la modifier.
Le JavaScript
Le JavaScript peut servir à ajouter des comportements à l'interface, par exemple :
- Ajuster un menu.
- Ajouter une interaction à certains éléments.
- Modifier certains comportements de navigation.
- Adapter des éléments de l'interface.
Une page comme `MediaWiki:Common.js` peut servir à des scripts communs, sous réserve des droits et de la configuration du wiki.
Précaution : une erreur dans le CSS ou le JavaScript peut perturber l'affichage ou la navigation. Tester les modifications, conserver une copie de l'ancienne version et éviter les changements inutiles dans les éléments natifs de Vector 2022.
10. Les extensions MediaWiki
Les extensions permettent d'ajouter des fonctions qui ne sont pas présentes dans l'installation de base.
Elles peuvent notamment servir à :
- Améliorer l'édition.
- Ajouter des fonctions de recherche.
- Gérer des formulaires.
- Afficher des diagrammes ou des données.
- Intégrer des services externes.
- Modifier certains comportements du wiki.
Installer une extension
La procédure varie selon l'extension. En général :
- Vérifier la compatibilité avec la version de MediaWiki.
- Lire la documentation et les dépendances.
- Télécharger l'extension depuis une source fiable.
- Installer ses fichiers selon les instructions officielles.
- Ajouter la configuration demandée dans `LocalSettings.php`, si nécessaire.
- Exécuter les mises à jour de base de données lorsque la documentation le demande.
- Tester les fonctions et vérifier les journaux.
Règle de sécurité : ne pas installer une extension simplement parce qu'elle semble utile. Vérifier son origine, son état de maintenance, sa compatibilité et les droits qu'elle demande.
Documentation : Guide officiel des extensions MediaWiki.
11. Gestion des utilisateurs et des droits
MediaWiki propose plusieurs groupes d'utilisateurs et des permissions configurables. Les possibilités exactes dépendent des réglages du wiki.
Principaux profils
| Profil | Rôle habituel |
|---|---|
| Visiteur non connecté | Consulte les pages autorisées publiquement. |
| Utilisateur enregistré | Dispose d'un compte et des droits accordés à son groupe. |
| Administrateur | Peut effectuer des actions administratives selon les droits attribués. |
| Bureaucrate | Peut gérer certaines affectations de droits, selon la configuration. |
| Bot | Compte utilisé pour des tâches automatisées autorisées. |
Restreindre les modifications
Pour un wiki principalement documentaire, il est possible de limiter la modification des pages aux comptes autorisés.
La configuration doit être choisie selon le besoin :
- Autoriser la lecture publique tout en limitant l'écriture.
- Réserver certaines pages sensibles aux administrateurs.
- Limiter la création de comptes ou contrôler leur attribution.
- Vérifier les droits des groupes anonymes et enregistrés.
- Tester le résultat en étant connecté et déconnecté.
Les réglages de droits doivent être effectués avec prudence. Une restriction mal conçue peut empêcher les utilisateurs légitimes de contribuer ou laisser certaines pages modifiables par erreur.
Documentation : Gestion des droits des utilisateurs.
12. Sauvegarder et restaurer un wiki
Une sauvegarde MediaWiki doit inclure les données indispensables à la reconstruction du site.
Base de données Pages, historiques, comptes, paramètres et autres données gérées par la base.
Fichiers Médias téléversés, fichiers de configuration et personnalisations nécessaires.
Restauration Procédure documentée et testée dans un environnement maîtrisé.
Bonnes pratiques
- Planifier les sauvegardes selon la fréquence des modifications.
- Conserver une copie hors du serveur principal.
- Protéger les sauvegardes par des permissions adaptées.
- Ne pas laisser des archives sensibles dans un répertoire accessible publiquement.
- Tester régulièrement la restauration.
- Conserver une copie de `LocalSettings.php` dans un emplacement sécurisé.
- Documenter les versions de MediaWiki, PHP, de la base de données et des extensions.
Documentation : Sauvegarder un wiki.
13. Mettre à jour MediaWiki
La maintenance est essentielle pour conserver un wiki fiable et sécurisé.
Une mise à jour peut apporter des corrections de bugs, des améliorations fonctionnelles et des correctifs de sécurité. Elle peut également nécessiter des changements de configuration ou des mises à jour d'extensions.
Procédure recommandée
- Lire les notes de version de la version cible.
- Vérifier les prérequis et les incompatibilités.
- Vérifier la compatibilité des extensions et du skin.
- Réaliser une sauvegarde de la base et des fichiers.
- Tester la procédure dans un environnement séparé lorsque c'est possible.
- Appliquer les instructions officielles de mise à jour.
- Exécuter les scripts de maintenance ou de mise à jour de base de données requis.
- Contrôler les pages, les comptes, les médias et les fonctions principales.
- Vérifier les journaux et conserver un relevé de l'opération.
Important : ne pas remplacer aveuglément les fichiers d'une installation existante. Suivre la procédure correspondant à la version de départ et à la version cible.
Documentation : Mise à niveau de MediaWiki.
14. Sécurité et bonnes pratiques d'administration
- Maintenir MediaWiki, PHP et les composants serveur à jour.
- Utiliser HTTPS avec un certificat valide.
- Protéger le fichier `LocalSettings.php`.
- Limiter les comptes administrateurs.
- Vérifier les extensions et skins installés.
- Appliquer des permissions de fichiers adaptées.
- Surveiller les journaux du serveur et les erreurs applicatives.
- Sauvegarder régulièrement et tester les restaurations.
- Contrôler les possibilités de téléversement de fichiers.
Fichier de configuration
`LocalSettings.php` contient des paramètres sensibles, notamment les informations de connexion à la base de données et différentes options de fonctionnement.
Il ne doit pas être exposé au public ni publié dans un dépôt accessible sans protection. Il faut également éviter de copier son contenu dans des forums ou des documents partagés sans retirer les informations confidentielles.
Téléversement de fichiers
Si les utilisateurs peuvent téléverser des fichiers, il faut examiner les types autorisés, les permissions, la configuration du serveur et les risques associés aux fichiers malveillants.
Journaux et surveillance
La surveillance peut inclure :
- Les journaux d'accès et d'erreurs Apache.
- Les journaux disponibles dans MediaWiki.
- Les erreurs PHP.
- L'espace disque.
- L'état de la base de données.
- Les tentatives de connexion et les modifications inhabituelles.
15. Résoudre les problèmes courants
| Problème | Vérifications possibles |
|---|---|
| Page blanche ou erreur HTTP 500 | Examiner les journaux Apache et PHP, les permissions et les erreurs de configuration. |
| Erreur de connexion à la base de données | Vérifier le service de base de données, le nom de la base, le compte et ses droits. |
| Image absente | Vérifier le chemin du fichier, les permissions et la configuration du répertoire des téléversements. |
| CSS non appliqué | Vérifier le nom de la page CSS, les droits, le cache du navigateur et les erreurs de chargement. |
| JavaScript inactif | Contrôler la console du navigateur, les erreurs de script et les conflits éventuels. |
| Extension incompatible | Vérifier sa compatibilité avec la version installée et ses dépendances. |
| Menu incorrect | Vérifier les réglages du skin, les personnalisations CSS/JS et le comportement en visiteur et en utilisateur connecté. |
| Mise à jour échouée | Consulter les notes de version, les journaux et les instructions de migration. |
Méthode de dépannage : reproduire le problème, relever le message exact, consulter les journaux, identifier la dernière modification et tester une correction à la fois. Avant de modifier des fichiers système ou la configuration, effectuer une sauvegarde.
16. Organiser un wiki informatique efficace
Un wiki de qualité repose autant sur son organisation que sur ses fonctionnalités techniques.
Structure documentaire
- Créer une page d'accueil claire.
- Organiser les contenus par domaines.
- Ajouter un lexique informatique.
- Développer des tutoriels étape par étape.
- Regrouper les procédures de dépannage.
- Créer des pages de référence pour les logiciels et les technologies.
- Ajouter des liens vers les pages associées.
- Indiquer les versions et les dates de mise à jour lorsque cela est utile.
Qualité des articles
Chaque page technique devrait idéalement contenir :
- Une présentation du sujet.
- Les prérequis nécessaires.
- Les étapes de configuration ou de dépannage.
- Des exemples pratiques.
- Les précautions de sécurité.
- Les erreurs courantes et leurs solutions.
- Des ressources officielles.
- Des liens vers les pages connexes.
Amélioration progressive
Il n'est pas nécessaire de créer toutes les pages dès le début. Il est souvent plus efficace de partir des contenus existants, de les compléter au fil des besoins et d'ajouter des pages lorsque les liens ou les sujets le justifient.
17. Les avantages et les limites de MediaWiki
- Logiciel libre.
- Historique et suivi des modifications.
- Pages interconnectées.
- Catégories et modèles.
- Gestion des utilisateurs et des droits.
- Extensions et personnalisation.
- Bien adapté à la documentation volumineuse.
- Installation et maintenance techniques.
- Syntaxe wiki à apprendre.
- Personnalisation avancée parfois complexe.
- Compatibilité des extensions à vérifier.
- Sauvegardes et mises à jour à gérer soi-même en auto-hébergement.
- Conception graphique moins orientée vers les pages marketing qu'un CMS généraliste.
18. Ressources officielles
- Site officiel MediaWiki
- Manuel de référence
- Aide à l'utilisation
- Installation
- Configuration
- Extensions
- Gestion des droits
- Sauvegardes
- Mises à jour
- Notes de version