Accueil > Les Internets > Mediawiki – Mes pratiques de base

Mediawiki – Mes pratiques de base


Je mets en place et utilise des Wikis depuis de nombreuses années maintenant, tant pour le privé que pour le travail.

Au fil du temps j’ai déduit quelques principes et mis en place quelques règles quant-à-l’utilisation et l’alimentation du contenu d’un wiki.

Généralités: Le Tao du Wiki

  • Rester dans l’optique KISS (Keep It Stupidly Simple)
  • Utiliser la syntaxe wiki plutôt que des balises html pour conserver un texte (source) clair.
  • Spécifier ce qui sera affiché, et non comment l’afficher. Titre, paragraphe, cellule, code, lien, etc ont chacun une syntaxe wiki appropriée
  • Donner impérativement au moins une catégorie à chaque page et chaque fichier.
  • Ne pas laisser de pages ni de fichiers orphelins (ie. sans lien y pointant)
  • Ne pas laisser de page vide
  • Donner une description à chaque catégorie et à chaque fichier téléversé
  • Ne pas numéroter explicitement les titres de chapitres, sections, etc. Si les titres doivent apparaitre numérotés, aller dans les préférences et cocher la case « Numéroter automatiquement les titres de section » de l’onglet « apparence »

Choisir avec soin le nom des nouvelles pages

Une page mal nommée pourra bien sûr être renommée plus tard, mais chaque renommage crée une page de redirection de l’ancien nom vers le nouveau, ce qui peut amener à des redirections multiples.

L’accumulation des redirections complique l’organisation des pages, donc autant faire un petit effort dès le création d’une nouvelle page.

Création d’une nouvelle page

La création de nouvelles pages est une des pratiques de base dans un wiki.

Plusieurs méthodes de création d’une nouvelle page:

  • Créer un lien vers la nouvelle page dans une page existante. Après enregistrement de la page « source », le lien apparait en rouge car la page n’existe pas encore. Cliquer sur le lien affiche un formulaire permettant de saisir le contenu de la page.
  • Effectuer une rechercher sur la page que l’on souhaite créer. La page de résulta de recherche proposera de créer la nouvelle page

Créer et utiliser des Catégories

Pour faciliter les recherches, chaque page et chaque fichier/image inclus dans mediawiki doit avoir une ou plusieurs catégories.

Il suffit d’ajouter en tête de la page le tag [[Category:nom_de_la_categorie]] pour chaque catégorie souhaitée

Les catégories existant sont listées dans la page [[Special:Categories]]

Si une des catégories choisies n’existe pas, son libellé apparait normalement en rouge (suivant les préférences du contributeur), et il suffit de cliquer sur le lien pour la créer (même méthode qu’une page classique).

Il est fortement conseillé donner une description, même brève, à chaque catégorie.

Eviter les pages trop longues

S’il devient difficile de se repérer dans une page, ou de la modifier, c’est que la page est peut-être trop longue.

Il faut alors en s’appuyant sur son sommaire commencer par éliminer les redondances (il y en a sûrement) et regrouper les informations dans des sections, sous-sections, etc.

Si la page reste peu pratique à utiliser et à modifier, alors il faudra en déplacer certaines parties vers de nouvelles pages, le texte déplacé étant remplacé par un lien vers la nouvelle page. Ne pas oublier d’assigner les catégories nécessaires (cf un peu plus haut).

Cette pratique permet également d’éviter certains conflits d’édition (situation où plusieurs contributeurs modifient en même temps une même page). Mediawiki gère très bien ces conflits d’édition, mais autant s’éviter des complications souvent inutiles.

Il y a bien entendu certaines situations où une page restera imposante, quoi qu’on fasse.

Utiliser la syntaxe wiki plutôt que des balises html

Préférer la syntaxe wiki aux balises html pour obtenir un texte (source) propre et compréhensible.

La syntaxe wiki permet de spécifier ce qui sera affiché; Titre, paragraphe, liste, code, lien, etc ont chacun une syntaxe simple et appropriée, sauf peut-être les tableaux dont la syntaxe est (juste) un peu plus compliquée.

Dit simplement, le rédacteur s’occupe de quoi afficher tandis que le logiciel s’occupe de comment l’afficher. Ce doit être du WYSIWYM (What You See Is What You Mean).

Penser en outre qu’il faudra surement revenir modifier la page demain, dans trois semaines ou dans six mois, et que quelqu’un d’autre aura éventuellement s’y coller… il sera difficile de s’y retrouver si le texte est confus (ex: tableaux complexes, listes trop imbriquées, etc).

Quelques options utiles dans les préférences

Chaque contributeur peut choisir des règles d’affichage et de fonctionnement qui lui sont propres, en cliquant sur le lien « Préférences ». Ce lien est en général en haut et à droite des pages du wiki. Apparait alors un formulaire avec plusieurs onglet.

J’ai adopté les réglages suivants:

Onglet « Apparence »:

  • Format maximal des images : 800x600px
  • Afficher en rouge les liens vers les pages inexistantes : activé
  • Afficher la table des matières (pour les pages ayant plus de 3 sections) : activé
  • Numéroter automatiquement les titres de section : activé

Onglet « Modifications récentes »:

  • Utiliser les modifications récentes améliorées (nécessite JavaScript) : activé

Pour conclure

Il ne s’agit pas de techniques avancées, mais juste de quelques principes de base concernant l’alimentation d’un wiki.

Même si MediaWiki a été plusieurs fois cité, tout ceci reste applicable avec d’autres logiciels de Wiki.

Creative Commons License

Publicités
Catégories :Les Internets Étiquettes : ,
  1. Titi
    27 juillet 2012 à 15:22

    Merci pour ce petit guide, c’est un retour d’expérience appréciable.

    J'aime

  2. 9 janvier 2013 à 19:34

    Merci. ce billet devrait être re pris dans wikibooks. Norbert

    J'aime

    • John Butch3r
      31 janvier 2013 à 19:16

      Merci pour les compliments

      J'aime

  1. No trackbacks yet.

Répondre

Entrez vos coordonnées ci-dessous ou cliquez sur une icône pour vous connecter:

Logo WordPress.com

Vous commentez à l'aide de votre compte WordPress.com. Déconnexion /  Changer )

Photo Google

Vous commentez à l'aide de votre compte Google. Déconnexion /  Changer )

Image Twitter

Vous commentez à l'aide de votre compte Twitter. Déconnexion /  Changer )

Photo Facebook

Vous commentez à l'aide de votre compte Facebook. Déconnexion /  Changer )

Connexion à %s

Ce site utilise Akismet pour réduire les indésirables. En savoir plus sur la façon dont les données de vos commentaires sont traitées.

%d blogueurs aiment cette page :