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. Toute modification du Wiki est tracée (avec votre identifiant d'utilisateur) et pourra être annulée si elle était incorrecte ou dispensable. Ceci étant dit, ce Wiki fonctionne sur un principe de communauté et c'est donc notre responsabilité commune de le maintenir aussi fonctionnel et fiable que possible.

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.

Police

La police du Wiki est automatique mais il est possible d'en faire des modifications comme d'utiliser du gras, de l'italique, voire même du gras italique. Il est également possible d'utiliser les balises html (pour les plus connaisseurs). Cependant, il faut garder en tête que cela a tendance à surcharger le texte et parfois (souvent?) à le rendre moins lisible. Il faut donc veiller à utiliser ces outils avec parcimonie pour garder un texte aussi clair que possible.

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.

Liens internes et externes

Mediawiki permet de créer facilement un lien dans le texte vers une page interne au Wiki (avec double crochet [[Accueil]]) ou externe (simple crochet [https://theshiftproject.org/en/home/]). On veillera à utiliser des noms explicites et concis dans la description d'un lien

A éviter, à faire

Voici pour récapituler quelques exemples de syntaxe et mise en page à éviter pour maintenir un outil commun. Si vous avez des doutes sur la façon de rédiger, vous pouvez regarder le code source (cliquer sur Modifier) du tableau suivant pour comparer les formes correctes et incorrectes.

Type	A éviter	A faire
Police	Ceci est un texte très important Attention aux italiques Oulala c'est sérieux	Ceci est un texte très important Attention aux italiques Oulala c'est sérieux
Titres	Grand paragraphe Petit paragraphe Deuxième petit paragraphe	Grand paragraphe Petit paragraphe Deuxième petit paragraphe
Listes à puces	. Un point - Un tiret _ Un underscore $ Un dollar	Un point Un tiret Un underscore Un dollar
Listes numérotées	1. Petit un 2- Petit deux -3 Petit 3	Petit 1 Petit 2 Petit 3