2 Stucture du document
La structuration d’un document est un point essentiel dans sa qualité.
Pour rappel, avec Markdown, cette structure est particulièrement simple à mettre en œuvre avec l’utilisation du caractère # (# titre de niveau 1, ## titre de niveau 2…).
Markdown permet six niveaux de titre mais il est rare de dépasser quatre niveaux dans un document déjà complexe.
# Titre de niveau 1
## Titre de niveau 2
### Titre de niveau 3
#### Titre de niveau 4
##### Titre de niveau 5
###### Titre de niveau 6Ces niveaux seront différents en fonction de la classe du document.
Pour un livre on aura des parties (qui commenceront par défaut sur une page paire, à droite, donc avec l’ajout éventuel d’une page blanche), des chapitres, des sections et des sous-sections. Pour un rapport, ce sera la même structure mais il n’y a pas de notion de pages paires et impaires. Pour un article, le niveau 1 (# titre) sera un chapitre.
| classe | page titre | niveau 1 | niveau 2 | résumé | entêtes |
|---|---|---|---|---|---|
| article | non (page 1) | Chapitre | Section | oui | non1 |
| report | oui | Partie | Chapitre | oui, page 2 | non |
| book | oui | Partie (page paire) | Chapitre | non | oui |
Il va sans dire qu’un même niveau ne peut pas apparaître seul. Si un chapitre ne contient qu’une seule section, le titre de cette section doit être supprimé ou faire partie du titre du chapitre. Un document structuré se construit comme un arbre et on ne peut avoir une branche contenant seulement une sous-branche.
Pour un document html, contrairement à un document pdf où le titre du document se trouve dans l’entête YAML, le titre de niveau 1 (# titre 1) est le titre de la page. Il ne doit donc apparaître qu’une fois.
Le deuxième outil de structuration qui est utilisé est le paragraphe (pour rappel, deux sauts de ligne en Markdown). Il faut être attentif à rendre le texte lisible et donc éviter de mettre plusieurs idées dans un même paragraphe.
Un troisième outil, dernier niveau dans la granularité, est l’outil listes déjà décrit dans le manuel.
Le caractère #, les paragraphes et les listes (simples ou numériques) sont donc les trois éléments à utiliser pour structurer un document avec Markdown et LaTeX.
Il est bien évidemment possible d’en ajouter avec le paquet fancy.↩︎