Wikilivres/Organisation d'un wikilivre

Un wikilivre, comme un livre normal, doit être décomposé en chapitres et sous-chapitres.

Découpage d'un livre modifier

Un livre comporte plusieurs chapitres. Il est conseillé de faire une page par chapitre, et de répartir les chapitres les plus longs sur plusieurs pages en faisant des sous-chapitres.

Il n'est pas recommandé de mettre plusieurs chapitres sur la même page : le lecteur ne s'intéressant qu'à un chapitre en particulier pourrait ne pas le voir s'il est situé après un autre dans la même page.

Titre des chapitres modifier

Cette section présente différentes recommandations respectant la convention sur les titres. Il est fortement recommandé de les respecter afin de faciliter la maintenance du livre.

Organisation générale modifier

Afin de suivre la convention sur les titres, les titres des pages d'un livre devraient avoir les titres suivants (exemple) :

Titre de la page wiki Description du contenu de la page wiki
Le titre du livre Page de présentation du livre (courte introduction) et du sommaire.
Le titre du livre/Introduction Présentation détaillée, introduction détaillée, à qui se livre s'adresse-t'il ? ...
Le titre du livre/Titre du premier chapitre Contenu du premier chapitre du livre.
Le titre du livre/Titre du second chapitre Contenu du second chapitre du livre.
Le titre du livre/Titre du second chapitre Contenu du second chapitre du livre.
... ...

L'ordre des chapitres doit être logique, suivre un cheminement (séquence par étapes).

Niveau modifier

Il n'est pas recommandé d'aller au delà d'un niveau sous le titre du livre. S'il y a des sous-chapitres, il vaut mieux nommer la page avec un titre unique dans tout le livre (ex: Le titre du livre/Ce sous-chapitre), plutôt qu'utiliser un niveau supplémentaire et un titre repris dans un autre chapitre (risque de confusion entre les sous-chapitres). Par exemple, au lieu de :

  • Matrices/Addition/Explication ;
  • Matrices/Multiplication/Explication ;

il vaut mieux avoir :

  • Matrices/Explication de l'addition ;
  • Matrices/Explication de la multiplication.

Dans le sommaire, les liens vers les sous-chapitres doivent être mis plus en retrait par rapport à ceux des chapitres.

Les principaux avantages sont :

  • pouvoir renommer facilement un chapitre sans avoir à renommer ses sous-chapitres (sinon de nombreux liens sont à mettre à jour) ;
  • pouvoir utiliser facilement certains modèles de navigation (tel {{NavTitre}} et {{NavChapitre}}).

Pas de numérotation modifier

Afin de pouvoir réorganiser l'ordre des chapitres et sous-chapitres plus facilement, il est fortement déconseillé de numéroter les titres de chapitres et sous-chapitres. Il est préférable de choisir un titre approprié, explicite, court et simple (pas d'article).

L'ordre des chapitres doit être logique, suivre un cheminement (séquence par étapes).

Sections modifier

Chaque chapitre est décomposé en section. Les titres d'une section et d'une sous-section utilisent la syntaxe suivante :

== Titre de la section ==
=== Titre de la sous-section ===
...

Le niveau 1 de titre ( = Titre = ) est réservé aux titres des chapitres quand ils sont repris dans la version imprimable d'un livre.

La numérotation automatique des sections d'une page peut être activée dans les préférences utilisateur (Apparence > Options avancées > Numéroter automatiquement les titres de section).

Sommaire modifier

Afin de faciliter la navigation entre les chapitres et que le lecteur sache où il se situe dans le livre, il est recommandé de créer un sommaire repris sur toutes les pages et dans la page de présentation :

  • sur la page de présentation, le sommaire doit utiliser une taille normale de police de caractère ;
  • sur les autres pages, il s'agit d'un modèle en général nommé Le titre du livre/Sommaire. Les titres des chapitres doivent utiliser une petite taille de police de caractère. Pour cela, tout le sommaire peut être encadré par les balises <small> et </small>. L'inclusion du modèle dans les pages du livre se fait en utilisant la syntaxe suivante :
<noinclude>{{:Le titre du livre/Sommaire}}</noinclude>

Si le sommaire est trop long, il est possible de ne mettre que le titre des chapitres et de ne lister les sous-chapitres que pour le sommaire du chapitre en question. C'est-à-dire faire un sommaire par grand chapitre.

Modèle de navigation modifier

En plus du sommaire, il est recommandé d'utiliser un modèle de navigation entre les chapitres et sous-chapitres, afin de passer facilement au chapitre suivant ou de revenir au chapitre précédent.

La catégorie Modèle pour la navigation recense tous les modèles de navigations utilisables.

On y distingue par exemple les modèles dynamiques {{Haut de page}} et {{Bas de page}}, dont l'automatisme provient du sommaire du livre, des modèles statiques {{NavDébut}} et {{NavTitre}}, qui acceptent les liens rouges mais sont fastidieux à tenir à jour, et peuvent donc nécessiter de faire appel à un bot pour cela.