Mise en page Wiki

Ce Wiki est un outil collaboratif qui permet de mettre en commun nos connaissances et notre travail au sein de l'association. Pour le rendre le plus accessible, lisible et utile possible, il est utile d'utiliser une mise en page standard, comme c'est le cas sur Wikipedia.

Il existe de nombreuses ressources en ligne sur le fonctionnement de MediaWiki, qui est le système de partage sur lequel se base la plupart des Wiki. Une des plus complète est Working with MediaWiki qui couvre aussi bien la création et la gestion du site que la rédaction. Nous allons essayer de donner ici les pistes pour l'utiliser et y contribuer de la meilleure manière.

Créer et éditer des pages

L'essentiel se trouve sur cette page. A noter que notre Wiki est fermé, il est donc indispensable de s'inscrire et de se connecter pour y participer. Cela permet de suivre plus facilement les modifications faites par les différents contributeurs. Pour créer un nouvelle page, il suffit de rejoindre une page inexistante (par exemple Nouvelle_page) et de cliquer sur Créer pour ouvrir la fenètre de modification de cette page. On essaiera de limiter le nombre de nouvelles pages créées et de leur donner des noms aussi explicites que possible.

Pour l'édition des pages, chaque utilisateur inscrit peut y participer en essayant, évidemment de maintenir les fonctionnalités du site et sa mise en page. En cas de doute, vous pouvez contacter l'administrateur du Wiki qui pourra vous aider.

Mise en page standard

L'essentiel se trouve sur cette page, qu'il est important de maîtriser pour rédiger des pages du présent Wiki afin de maintenir une mise en page commune. De manière générale, voici quelques grands principes à appliquer à ce Wiki.

En-têtes

Les titres et en-têtes sont essentiellement présents pour séparer les différentes parties d'un article. Ils ressortiront automatiquement dans le sommaire si celui-ci est activé sur une page. On essaie donc d'en faire un usage raisonné et organisé. De même, il n'est pas nécessaire de mettre en gras, italique ou CAPITALES les titres puisqu'ils ressortent d'eux-mêmes de la page. On essaie de plus de se limiter à deux niveaux de titres, sauf exceptions, pour garder un formatage lisible.

Les titres de niveau 2 (générés par un double signe égal ==) sont suivis automatiquement d'une ligne horizontale de séparation et représentent donc les grandes parties alors que ceux de niveau 3 (===) sont utilisés pour des sous-parties. On essaie donc de limiter (voire de s'interdire) l'utilisation des barres de séparation horizontales et de leur préférer les titres de niveau 2. L'utilisation des titres permet également de faire des paragraphes de modification, c'est-à-dire de faciliter la modification par paragraphe au lieu de l'ensemble de la page.

Listes et bullets

MediaWiki contient nativement une génération de bullets points et de listes numérotées. Il suffit pour cela d'utiliser le signe * en début de ligne, éventuellement doublé (**) pour une indentation de la liste. Cette syntaxe est à privilégier en toute circonstances à d'autres signes comme le tiret, le paragraphe, le dollar, etc.

Les listes numérotées sont également automatiques avec le signe dièse (#) qui permet d'avoir un décompte automatique (pratique notamment lorsqu'une liste peut être amenée à changer). Le décompte est remis à 0 après un double retour à la ligne. A privilégier, évidemment, plutôt qu'une numérotation manuelle.