2 Edition de la table des matières

La poule ou l'Œuf et le XmLateX

VI Créer sa structure

Chapitre 2

Edition de la table des matières

Il faut tout d’abord distinguer Table des matières et Menu.

La Table des matières fait référence aux éléments de votre livre proprement dit : page Titre, parties, chapitres, annexes, etc. À moins d’indication contraire ce sont ces éléments qui seront listés dans la page Table des matières de votre livre.

Le menu fait référence au menu de gauche de votre site/livre. Il contient la table des matières plus les liens d’administration du livre.

2.1 Module de création de la table des matières

Pour accéder à l'éditeur de la table des matières, l'utilisateur autorisé va dans la partie Services/Configuration/Table des matières. L’architecture du menu apparaît sous sa forme développée en commençant par le titre du livre.

Il faut avant tout noter que tous les éléments d’un livre sont obligatoirement constitués d’une partie comprenant au moins un chapitre. Selon vos besoins il faut ensuite jouer avec leurs différentes options: visibilité, le type, la numérotation, le nombre, etc.

Lorsque l’on sélectionne une partie ou quelque chapitre que ce soit les boutons d’édition qui les concernent apparaissent à droite.

Figure 2.1 L'éditeur de Table des matières

–	Les titres de parties visibles sont alignés à gauche, sans indentation, en caractères gras et noirs,
–	Un titre de partie invisible est aligné de la même façon que les titres de parties visibles mais est en caractères gris clair. Dans ce cas c’est le titre du chapitre qui sera visible dans la table des matières, il se trouve donc en caractères gras et noirs: exemple ici, partie vidéos, chapitre Vidéos,
–	Les titres de chapitre sont alignés à gauche avec une indentation. S’ils appartiennent à une partie visible ils sont en caractères noirs,
–	Une croix rouge devant un titre de partie ou de chapitre indique qu’ils ne sont pas publics, il n’apparaîtront qu’en mode administration,
–	Un titre de partie sur lequel on a cliqué, faisant apparaître son cadre d’édition à gauche, se trouve en caractères rouges et gras,
–	Un titre de chapitre sur lequel on a cliqué, faisant apparaître son cadre d’édition à gauche, se trouve en caractères oranges et gras.

2.2 Le boutonEnregistrer les modifications

On retrouve dans tous les cas le boutonEnregistrer les modificationss.

Aucune des modifications que vous aurez apportées à la table des matières ne sera enregistrée tant que vous n’aurez pas cliqué sur Enregistrer les modifications. Vous pouvez donc essayer toutes les manipulations possibles et imaginables. Pour remettre l’ensemble des parties et des chapitres à zéro il vous suffit de recharger la page (CTRL R dans Firefox) ou simplement de la quitter sans enregistrer vos modifications.

Attention: Aucune des modifications que vous aurez enregistrées n’apparaîtra dans le menu du Site/Livre tant que vous n’aurez pas cliqué soit sur la toque dans le menu de gauche, soit sur le bouton Retour Configuration .

2.3 Créer un nouvel élément de table des matières

Figure 2.2 Les éléments d’une table des matières

Un certain nombre d’éléments « standards » entrant dans la composition d’un livre ont été prédéfinis et préformatés dans La Poule ou l'Œuf. Choissez dans la liste le type d’élément que vous voulez ajouter. Toutes ses options ainsi que sa disposition dans la table des matières pourront ensuite être modifiés au moyen des cadres d’édition des parties et chapitres.

2.3.1 Les différents types d’élément

Par défaut tous les nouveaux éléments sont imprimables, publics et pris en compte dans le cache du navigateur.

–	Libres: une partie et un chapitre classiques
–	Grand titre: une partie de type invisible et un chapitre de type Grand titre
–	Table des matières: partie invisible avec un chapitre de type Table des matières qui se rempliera automatiquement au fur et à mesure que vous insèrerez des Titres de niveau 1, 2 ou 3au fil du texte.
–	Table des figures: partie invisible avec un chapitre de type Table des figures qui se rempliera automatiquement au fur et à mesure que vous insèrerez des images (figures) au fil du texte.
–	Liste des tableaux: partie invisible avec un chapitre de type Liste des tableaux qui se rempliera automatiquement au fur et à mesure que vous insèrerez tableaux au fil du texte.
–	Partie d’introduction
–	Avant-propos
–	Préface
–	Remerciements
–	Convention
–	Partie (classique)
–	Chapitre (classique)
–	Annexe: partie et chapitre de type Annexe
–	Glossaire/lexique: partie invisible avec un chapitre de type Glossaire qui se rempliera automatiquement au fur et à mesure que vous appellerez vos entrées de glossaire au cours du texte.
–	Postface
–	Bibliographie: partie invisible avec un chapitre de type Bibliographie qui se rempliera automatiquement au fur et à mesure que vous appellerez vos références bibliographiques au cours du texte.
–	Index: partie invisible avec un chapitre de type Index qui se rempliera automatiquement au fur et à mesure que vous créerez vos entrées d’index au cours du texte.
–	Colophon: Notice qui donne les renseignements suivants ou au moins quelques-uns uns d'entre eux : le nom de l'ouvrage, de l'auteur, de l'imprimeur, le lieu et l'année d'édition, ainsi que certains détails sur l'exécution du livre.
–	Achevé d’imprimé

2.4 Créer une partie

Figure 2.3 Cadre d’édition d’une partie

2.4.1 Le cadre d’édition d’une partie

Les parties sont les premiers niveaux d'organisation d’un Site/Livre. Elles ont toutes en commun de devoir contenir au moins 1 chapitre.

Lorsque l'on clique sur le nom d'une partie dans le menu du site/livre le premier des chapitres qu'elle contient s'affiche.

Lorsque l’on clique sur le nom d’une partie dans l’éditeur de table des matières apparaît, à droite, sous le bouton d’édition du titre, un cadre indiquant le nom de la partie en question et offrant trois boutons d’édition:

-	Supprimer permet, après confirmation, de supprimer une partie et tous ses chapitres.
-	Nouvelle partie permet de créer une nouvelle partie et son chapitre associé. Cette nouvelle partie viendra s’inscrire tout en bas du menu éditable. Pour la positionner différemment il suffit de la sélectionner et de la faire glisser à l’endroit voulu dans le menu.
-	Editer permet d’accéder aux options d’une partie déjà créée, soit son nom, son type et l'option Public qui permet de la rendre confidentielle ou non. Cette fenêtre d’édition s’ouvre automatiquement lors de la création d’une nouvelle partie.

Un quatrième bouton, Nouveau Chapitre, permet de créer un nouveau chapitre dans la partie active. Nous reviendrons sur cette action dans la section Création d’un nouvel élément chapitre dans le menu. 2.5

2.4.2 Les options d'édition d'une partie

Intitulé: le nom de la partie. Le bouton Éditer, à gauche donne accès à l’éditeur qui permet de donner un nom contenant des caractères spéciaux.

Genre: voir Les différents types d’éléments ci-dessus. Vous pouvez ici changer le type d’un élément préalablement créé.

Type: à choisir entre 5 options.

Figure 2.4 Les types de parties

Partie: exemple «Créer sa structure» dans le livre dans lequel nous nous trouvons actuellement. Une partie de ce type se voit automatiquement attribuer un numéro par l’éditeur en fonction de sa place par rapport aux autres parties numérotées du menu.

1.	Dans le menu du livre/site elle apparaît avec son numéro. Si l’on clique dessus tous ses chapitres et niveaux de hiérarchie inférieurs s’affichent et sont accessibles
2.	Dans la table des matières du livre imprimable elle apparaît avec son numéro et tous ses chapitres et niveaux de hiérarchie inférieurs sont développés.

Annexe: Une partie de type annexe est créée par défaut avec un chapitre de type Annexe. Les unes et les autres possèdent une numérotation différente des parties et chapitres classiques.

Sans numérotation: exemple «Annexe». Cette option permet de ne donner des numéros qu’aux parties correspondant au corps du livre comme c’est le cas d’ordinaire pour un livre imprimé.

1.	Dans le menu du livre/site une partie de ce type apparaît sans numéro. Si l’on clique dessus tous ses chapitres et niveaux de hiérarchie inférieurs s’affichent et sont accessibles.
2.	Dans la table des matières du livre imprimable elle apparaît avec sans numéro et tous ses chapitres et niveaux de hiérarchie inférieurs sont développés.

Sans numérotation ni entrée dans la table (des matières du livre imprimable). Exemple «Services» Ce type va être utilisé pour des informations exclusives au site.

1.	Dans le menu du livre/site une partie de ce type apparaît sans numéro. Si l’on clique dessus tous ses chapitres et niveaux de hiérarchie inférieurs s’affichent et sont accessibles.
2.	Dans la table des matières du livre imprimable elle n’apparaît pas ni aucun de ses chapitres et niveaux de hiérarchie inférieurs.

Invisible: exemple «Liste des tableaux». Cette option permet d’afficher une partie ayant, pour des raisons d’organisation, un seul chapitre tout en évitant d’afficher le nom des deux niveaux de hiérarchie relatifs à un seul et même contenu.

1.	Dans le menu du livre/site une partie de ce type n’apparaît pas. À sa place apparaît par contre le nom de son premier chapitre, et seulement de celui-là, sans numéro.
2.	Dans la table des matières du livre imprimable elle n’apparaît pas. À sa place apparaît par contre le nom de son premier chapitre, et seulement de celui-là, sans numéro.

Partie initiale, principale ou finale: un livre est structurellement découpé en trois parties, qui correspondent aux pages liminaires (gardes, faux-titre, titre, dédicace, parfois préface ou introduction et une table des matières, lorsque celles-ci ne sont pas chiffrées ni paginées en chiffres romains), au corps, et à la fin du livre (annexes, glossaire, index, achevé d’imprimé, etc). Signifier l’emplacement de votre partie parmi ces sections du livre permet de les gérer finement pour les différents formats d’exportation.

Public : Si vous décochez cette option la partie ne sera pas visible dans le menu et les lecteurs ne pourront y accéder qu'en connaissant son adresse Internet.

Outils : Si vous cochez cette option la partie sera répertoriée dans la section Outils du menu de votre Site/Livre et n'apparaîtra pas dans la table des matières de votre livre.

2.5 Edition d’un chapitre

Les chapitres sont les seconds niveaux de hiérarchie d’un Site/Livre. Ils n’apparaissent dans le menu du site que lorsque l’on clique sur la partie qui les contient.

Un chapitre est :

-	un élément d’organisation des contenus (que nous appellerons élément chapitre) qui donne son nom au chapitre dans le menu, dans l'affichage, gère l'organisation en pages html, etc.

-	un contenu (texte, etc.) sous la forme d’un fichier associé ou sous la forme d’une entrée dans une base de données (que nous appellerons objet chapitre ou wiki).

Créer un chapitre demande la création de ces deux entités. L’une renvoie à l’autre: on clique sur l’intitulé de l'élément chapitre dans le menu et le contenu de l'objet chapitre apparaît sur le site.

Figure 2.5 Création d'un chapitre.

Au moment de la création d'un chapitre dans l'éditeur de la table des matières on crée l'élément chapitre qui définit un première page, ainsi qu'un premier wiki (objet chapitre) lié à cette page. La création de pages et wikis supplémentaires se fait hors de l'éditeur de table des matières. (Voir 3.0 )

Pour des raisons techniques il est recommandé d’organiser les contenus de vos chapitres sous forme d’entrées dans la base de données. Nous traiterons des deux options mais vous demandons de suivre celle-ci.

2.5.1 Création d’un nouvel élément chapitre dans le menu

2 cas de figure peuvent se présenter:

-	Création automatique d’un chapitre lors de la création d’une partie: Lors de la création d’une partie, un élément chapitre est automatiquement généré dans le menu. Si l’on clique dessus son cadre d’édition apparaît et l’on peut créer son entrée associée et choisir ses options en cliquant sur le bouton Éditer (voir ci-dessous).
-	Création d’un chapitre à l’intérieur d’une partie existante: Lorsque l’on clique sur le nom d’une partie dans l'éditeur de table des matières, son cadre d’édition apparaît. On peut alors cliquer sur le bouton Nouveau chapitre qui va permettre de créer les deux éléments d’un nouveau chapitre dans cette même partie.

Par défaut un nouveau chapitre est intitulé est New chapter et il est de type En construction.

2.5.2 Le cadre d’édition d’un chapitre

Lorsque l’on clique sur le nom d’un chapitre dans l'éditeur de table apparaît, à droite, sous le cadre d’édition des parties, un cadre indiquant le nom du chapitre en question et offrant deux boutons d’édition:

-	Supprimer permet, après confirmation, de supprimer un chapitre et son fichier associé.
-	Editer permet d’accéder aux options éditables d’un chapitre déjà créé:

Figure 2.6 Cadre d’édition d’un chapitre

2.5.3 Créer un chapitre

Intitulé: C’est le nom du chapitre tel qu’il apparaîtra dans le menu et la table des matières.

Référence: Ce numéro est automatiquement donné au nouveau chapitre, vous ne pouvez en aucun cas le modifier vous-même.

Imprimable : Si cette option est cochée le chapitre apparaîtra sur la page Services/Configuration/Exportation où l’on pourra le sélectionner pour l'archiver ou le publier sous d'autres formats.

Public :Par défaut cette option est active et le chapitre public. Désactiver cette option permet de rendre un chapitre invisible aussi bien dans le menu du livre/site que dans la table des matières du livre imprimable. Il n’est plus alors accessible que par son adresse Internet exacte, de type: http://localhost/poule-ou-oeuf/pouloeuf/chapitre-8-fr.poule.

Cache : Permet une mise en mémoire de la page affichée sur Internet pour une visualisation plus rapide.

Bulle :Le texte inscrit dans ce champ apparaît lorsque la souris passe sur le nom du chapitre dans le menu. Il s’agit d’une bulle d’aide donnant quelques détails sur le contenu du chapitre (ex: Aide au démarrage).

Type de chapitre :

Chapitre : le nom de ce chapitre apparaîtra dans lemenu précédé d'un numéro qui lui est attribué automatiquement par l’éditeur en fonction de sa place par rapport aux autres chapitres numérotés de la partie.

1.	Dans le menu du livre/site un chapitre de ce type apparaît avec son numéro lorsque l’on clique sur la partie à laquelle il appartient. Lorsque l’on clique sur le nom du chapitre les niveaux de hiérarchie inférieure qu’il contient s’affichent dans le menu et son fichier associé, son contenu, s’affiche dans le navigateur.
2.	Dans la table des matières du livre imprimable il apparaît avec son numéro et tous ses niveaux de hiérarchie inférieurs sont développés.

Annexe: Une annexe a ceci de particulier qu'elle n'est pas numérotée de la même façon qu'un chapitre de «texte». La typographie de sa numérotation est indiquée dans le préambule de la collection à laquelle appartient le livre.

Sans numérotation:

1.	Dans le menu du livre/site un chapitre de ce type apparaît, sans numéro, lorsque l’on clique sur la partie à laquelle il appartient. Lorsque l’on clique sur le nom du chapitre les niveaux de hiérarchie inférieure qu’il contient s’affichent dans le menu et son fichier associé, son contenu, s’affiche dans le navigateur.
2.	Dans la table des matières du livre imprimable il apparaît sans numéro et tous ses niveaux de hiérarchie inférieurs sont développés.

Sans numérotation ni entrée dans la table: exemple des chapitres de la partie «Services».

1.	Dans le menu du livre/site un chapitre de ce type apparaît sans numéro. Si l’on clique dessus tous ses niveaux de hiérarchie inférieurs s’affichent et sont accessibles.
2.	Dans la table des matières du livre imprimable il n’apparaît pas ni aucun de ses niveaux de hiérarchie inférieurs. Ce type va être utilisé pour des informations exclusives au site.

Sans entête pour LATEX:

Sans entête pour LATEX et HTML:

Auteur(s): Nom du ou des auteur(s) du chapitre.

Date: Date que l’auteur ou le chargé de projet désire indiquer.

Groupe propriétaire: L'administrateur du livre compose des groupes d'auteurs dans la page Services/Configuration/Auteurs. En indiquant l'un de ces noms de groupe dans ce champ il donne accès aux auteurs qui en font partie à l'écriture dans ce chapitre.

Groupe de discussion: L'accès à la discussion sur un chapitre peut être ouverte à tous les lecteurs, si vous n'indiquez aucun nom de groupe dans ce champ, ou restreinte à un groupe d'auteur déterminé dans la page Services/Configuration/Auteurs.

Discussion: En sélectionnant cette option vous permettez aux internautes de laisser des commentaires sur ce chapitre (Pour plus d’information sur lescommentaires voir les chapitre: Les différents niveaux d’intervention dans un livre/L’accès aux discussions.)

Pour valider vos choix cliquez sur Enregistrer

L’élément chapitre est alors créé, nommé et ses options ont été choisies. Il reste à créer l’objet chapitre dans lequel sera écrit le contenu du chapitre.

2.5.4 Définir le type de chapitre

Dans le cadre d’édition d’un chapitre, les champs Type de fichier et la case à cocher BD (pour Base de Données) permettent de créer et de gérer les options de l’objet chapitre.

Case BD (Base de données) est cochée par défaut lorsque vous créez un nouveau chapitre. Cette option a l'avantage de la rapidité de disponibilité des contenus, la possibilité de faire des recherches dans la BD, etc. Si vous souhaitez pouvoir accéder facilement à vos fichiers de contenu afin d'écrire directement dans le code alors décochez-là. Vos chapitres seront créés sous forme de fichiers auxquels vous pourrez accéder par ftp.

Figure 2.7 Les différents types de chapitre

Type de fichier:

–

En construction: Par défaut lorsqu'un élément chapitre est créé dans la table des matières il est de type "En Construction".

–

Texte (X❤LATEX): C'est dans ce type de fichier que vous pourrez écrire vos textes, inclure vos images, etc.

Si vous donnez le type Texte à un chapitre une page est définie dans votre chapitre et un wiki inséré dans cette page. Votre chapitre est prêt pour l'écriture. Pour rajouter des pages et/ou des wikis dans ce même chapitre sortez de l'éditeur de table des matières et allez sur la page web du chapitre en question.

Les autres types de fichier, ci-dessous, font appel à des fonctions prédéfinies. Ces pages seront créées automatiquement et leurs options seront éditables directement dans la page Web par le biais d'un bouton Options accessible uniquement aux utilisateur autorisés (coordinateurs).

–	Liste des tableaux: un chapitre de ce type dispensera automatiquement la liste des tableaux (À venir) inclus dans un livre, chacun d’entre eux constituant un lien vers le tableau en question dans le Site/livre ou donnant le numéro de page de sa localisation (pour les autres formats de publication).
–	Liste universelle: un chapitre de ce type dispensera automatiquement la liste des éléments choisis inclus dans un livre (voir 9.3 ). Chacun d’entre eux constituera un lien vers l’élément en question dans le Site/livre ou donnera le numéro de page de sa localisation (pour les autres formats de publication).
–	Liste de labels: un chapitre de ce type dispensera automatiquement la liste des label (étiquettes) posés dans un livre (voir 9.2 ). Chacun d’entre eux constituera un lien vers l’étiquette en question dans le Site/livre ou donnera le numéro de page de sa localisation (pour les autres formats de publication).
–	Liste des variables
–	Data Projection Model
–	Grand Titre: Un chapitre de ce type génère la page de Grand Titre du livre qu’Il ne faut pas confondre cette page avec la couverture (celle-ci sera générée par l’éditeur au cours du processus de publication papier). C’est donc la page de titre qui se trouvre à l’intérieur de l’ouvrage mais en page d’accueil du Site/Livre (Exemple Grand Titre de ce livre).
–	Index: un chapitre de ce type dispensera automatiquement la liste, par ordre alphabétique, des entrée d’index déposées dans un livre (voir 2.2 ).
–	Table des matières: Un chapitre de ce type va générer automatiquement la table des matières du livre (à ne pas confondre avec le menu du Site/Livre). C’est cette table des matières qui sera publiée dans le PDF, par exemple, avec les numéros de page associés aux chapitres etc. Attention: ce type de chapitre ne sert pas à inclure le chapitre en question dans la table des matières ou le menu du livre. Un chapitre, s’il est public (voir plus haut) sera par défaut inclus dans la table des matières et dans le menu du site/livre.
–	Glossaire: (version 1.2, à venir) Un chapitre de ce type va répertorier et publier automatiquement l’ensemble des entrées de glossaire posées et appelées dans les différentes pages du livre.

Fermez le cadre d'édition de votre chapitre en cliquant sur Enregistrer.

N’oubliez pas de cliquer sur Enregistrer les modifications pour valider vos modifications.

Votre nouveau chapitre apparaît dans le menu du Site/Livre lorsque l’on clique sur la partie dans laquelle il se trouve.

Si l’on clique dessus apparaît dans le Site/Livre une page portant le titre du livre, le nom de la partie, le titre du chapitre et un bouton d'accès au bloc d’édition wiki.

2.6 Changer la position d’une partie ou d’un chapitre dans le menu

Pour changer la position d’une partie ou d’un chapitre dans le menu il suffit de le sélectionner, dans l'éditeur de la table des matières, et de le faire glisser à l’endroit voulu dans le menu.

Une partie pointe toujours vers le premier des chapitres qu'elle contient. Si ce chapitre est déplacé le nouveau « premier chapitre » deviendra automatiquement la nouvelle référence de la partie.

2.7 Suppression d'une partie

Vous ne pouvez pas supprimer une partie qui contient plus d'un chapitre. Si elle en contient plus supprimez d'abord les autres chapitres un par un. Question de sécurité!

Pour supprimer une partie qui ne contient qu'un chapitre:

Sélectionnez-là dans l'éditeur de la table des matières.

Cliquez sur le bouton "supprimer" dans le cadre d'édition de la partie.

Une fenêtre s'ouvre demandant "Voulez-vous supprimer cette Partie?".

Cliquez sur "Ok".

Une autre fenêtre s'ouvre demandant "Doit-on supprimer les blocs wiki associés?"

1.	Si vous ne voulez pas perdre le contenu du chapitre supprimé avec la partie cliquez sur "Annuler"
2.	Si vous voulez supprimer également le contenu du chapitre supprimé avec la partie cliquez sur "OK"

Pour enregistrer vos suppressions cliquez sur le bouton "Construire la table des matières".

2.8 Suppression d'un chapitre

Comme nous l'avons vu un chapitre est composé de l'«élément chapitre», élément d'organisation dans la table des matières, et de ses wikis (sous forme d'entrées dans la base de données ou de fichiers) dans lesquels se trouve le contenu du chapitre.

On peut décider de ne supprimer que l'«élément chapitre», dans le cas où l'on voudrait par exemple rattacher son contenu (wiki) à un autre chapitre déjà créé (voir Créer sa structure/Pages et Wikis 3.0 pour un copier/coller de wiki avant suppression d’un chapitre) .

Mais on peut aussi vouloir tout supprimer, entrée de la table des matières et contenu:

Dans le cadre d'édition du chapitre sélectionné cliquez sur "Supprimer".

Une fenêtre s'ouvre demandant "Voulez-vous supprimer ce chapitre?"

Cliquez sur OK.

Une autre fenêtre s'ouvre demandant "Doit-on supprimer les blocs wiki associés?"

1.	Si vous ne voulez pas perdre le contenu du chapitre que vous supprimez cliquez sur "Annuler"
2.	Si vous voulez supprimer également le contenu du chapitre cliquez sur "OK"

Pour enregistrer vos suppressions cliquez sur le bouton "Construire la table des matières".

Discussion : 1

Pages : 1 2 3

Discussion

Administrateur du livre

Creative Commons by-sa - http://creativecommons.org/licenses/by-sa/2.0/fr/