1  Structure et mise en forme du document

Ce chapitre présente les blocs de base de tout document Quarto : la hiérarchie des titres, la numérotation, les cross-références de sections, et la mise en forme inline.

1.1 Hiérarchie des titres

Quarto supporte quatre niveaux de titres numérotés dans ce template (paramètre number-depth: 4 dans _extension.yml). La syntaxe utilise les dièses Markdown :

# Titre de chapitre (niveau 1)

## Titre de section (niveau 2)

### Titre de sous-section (niveau 3)

#### Titre de sous-sous-section (niveau 4)

En PDF, ces niveaux correspondent respectivement aux commandes LaTeX \chapter, \section, \subsection et \subsubsection. En HTML, ils génèrent les balises <h2> à <h5> (le <h1> étant réservé au titre du livre).

1.1.1 Sous-section de démonstration

Ceci est une ### en situation. La numérotation automatique produit ici « 1.1.1 ».

1.1.1.1 Sous-sous-section de démonstration

Et ceci est une ####, numérotée « 1.1.1.1 ». Au-delà de ce niveau, Quarto ne numérote plus — utilisez des listes ou des paragraphes en gras si vous avez besoin d’un cinquième niveau.

AvertissementProfondeur maximale recommandée

Un plan à quatre niveaux numérotés est généralement le maximum acceptable dans une thèse. Un plan plus profond est souvent le signe que la structure doit être repensée.

1.2 Sections numérotées et non numérotées

Par défaut, tous les titres de niveau 1 à 4 sont numérotés. Pour retirer la numérotation, on ajoute la classe {.unnumbered} :

## Section sans numéro {.unnumbered}

Pour les pages de la partie liminaire et postliminaire (remerciements, résumé, conclusion…), on combine {.unnumbered} avec {.toc-black} — cette dernière classe demande au filtre Lua d’afficher le titre en noir dans la table des matières, et déclenche la numérotation romaine en front matter quand pagestyle-sections: true :

# Conclusion {.unnumbered}

# Remerciements {.unnumbered .toc-black}
Important.unnumbered vs .unnumbered .toc-black
  • {.unnumbered} seul : titre non numéroté, affiché en couleur dans la toc (chapitres du corps de thèse : introduction, conclusion).
  • {.unnumbered .toc-black} : titre non numéroté, affiché en noir dans la toc (parties liminaires et postliminaires).

Ne mettez jamais {.unnumbered} sur un chapitre du corps de thèse numéroté (chapitres 1, 2, 3…) — ce serait incohérent avec le plan général.

1.3 Cross-références de sections (@sec-)

Pour créer un renvoi vers une section, il faut : (1) donner un identifiant au titre cible avec {#sec-label}, puis (2) y faire référence avec @sec-label :

## Hiérarchie des titres {#sec-titres}

Comme expliqué en @sec-titres, les niveaux vont de `#` à `####`.

Rendu :

Comme expliqué en Section 1.1, les niveaux vont de # à ####.

Quarto résout automatiquement le numéro et le lien hypertexte dans les deux formats.

AstuceConvention de nommage des labels

Utilisez le préfixe sec- pour les sections, fig- pour les figures, tbl- pour les tableaux, eq- pour les équations. Ces préfixes sont imposés par Quarto pour que les cross-références fonctionnent correctement dans les deux formats.

1.4 Titre court (short-title)

Quand un titre de chapitre ou de section est trop long pour tenir dans le running header du PDF ou dans la table des matières, on utilise l’attribut short-title :

# Un titre vraiment très long qui déborde dans le header {short-title="Titre court"}

## Une sous-section au titre interminable {short-title="Titre court"}

Le titre court est utilisé dans le running header (en-tête de page recto/verso) et dans la table des matières. Le titre long reste tel quel dans le corps du texte.

Astuce

Visez 40 à 50 caractères maximum pour un short-title. Au-delà, il risque de déborder lui aussi selon la mise en page.

1.5 Mise en forme inline

1.5.1 Emphase et code

**gras**, *italique*, ***gras italique***, `code inline`
~~barré~~, ^exposant^, ~indice~
:::

Rendu :

gras, italique, gras italique, code inline, barré, exposant, indice.

ImportantUsage académique du gras et de l’italique

Dans une thèse, le gras et l’italique servent à marquer la terminologie lors de sa première introduction, ou à citer un titre d’ouvrage. Les utiliser pour décorer le texte ou insister sur des phrases entières est une pratique à éviter.

1.5.2 Soulignement

Markdown n’a pas de syntaxe native pour le soulignement. Quarto utilise la notation span avec la classe .underline :

[texte souligné]{.underline}

Rendu :

texte souligné.

En PDF, Pandoc génère \underline{…} ; en HTML, un <span> avec text-decoration: underline. La syntaxe <u>texte</u> fonctionne en HTML mais est ignorée en PDF.

Mise en gardeLe soulignement est à éviter dans une thèse

Le soulignement est un héritage de la machine à écrire, époque où l’italique n’était pas disponible. Dans un document typographié, il est réservé aux liens hypertexte. Pour mettre en valeur un terme, utilisez *italique* ou **gras**.

1.5.3 Listes

- Premier élément non ordonné
- Deuxième élément
  - Sous-élément (indentation 2 espaces)

1. Premier élément ordonné
2. Deuxième élément
   a. Sous-élément (indentation 3 espaces)

Rendu :

  • Premier élément non ordonné
  • Deuxième élément
    • Sous-élément (indentation 2 espaces)
  1. Premier élément ordonné
  2. Deuxième élément
    1. Sous-élément (indentation 3 espaces)
NoteLe numéro écrit n’a pas d’importance

Pandoc ne lit que le numéro du premier élément (pour déterminer le départ du compteur) ; tous les suivants sont ignorés et auto-incrémentés. Ces deux syntaxes produisent le même rendu :

1. Premier    
2. Deuxième
3. Troisième
1. Premier
1. Deuxième
1. Troisième

La convention 1. 1. 1. est même recommandée : plus besoin de renuméroter si l’on insère ou déplace un élément. La même logique s’applique aux sous-listes : a. a. a. suffit pour obtenir a., b., c.…

1.5.4 Listes de tâches

La syntaxe - [ ] / - [x] produit une liste de tâches. La casse de x n’a pas d’importance (X fonctionne aussi) :

- [ ] Rédiger l'introduction
- [x] Choisir le template Quarto
- [ ] Soumettre au directeur de thèse

Rendu :

NoteRendu différent selon le format de sortie

En HTML, Quarto génère de vraies cases à cocher <input type="checkbox"> (désactivées, non interactives).

En PDF (pdflatex), Pandoc utilise les symboles mathématiques $\square$ (case vide) et $\boxtimes$ (case cochée) du package amssymb. L’apparence est correcte mais typographiquement différente des cases HTML.

Mise en gardeUsage dans une thèse

Les listes de tâches sont adaptées aux notes de travail, aux annexes méthodologiques, ou à un README. Dans le corps de la thèse, préférez une liste non ordonnée classique accompagnée d’un verbe d’état (« complété », « en cours »…) : c’est plus neutre et plus conforme au registre académique.

1.5.5 Blockquotes

> « La typographie est le métier de donner une forme visuelle au langage. »
>
> — Robert Bringhurst [@Bringhurst2004]

Rendu :

« La typographie est le métier de donner une forme visuelle au langage. »

— Robert Bringhurst (Bringhurst 2004)

Mise en gardeListes de définitions en pdflatex

La syntaxe Pandoc de liste de définitions (terme\n: définition) est supportée par Quarto mais produit un rendu sans style visuel particulier en pdflatex. Si vous avez besoin de listes de définitions mises en forme, utilisez un tableau Markdown (voir Section 3.4) ou un environnement LaTeX brut.

1.5.6 Notes de bas de page

Quarto propose deux syntaxes pour les notes de bas de page.

Syntaxe inline — la note est écrite directement dans le texte, entre ^[ et ] :

Le Cnam a été fondé en 1794^[Décret de la Convention nationale du 19 vendémiaire
an III (10 octobre 1794).] à l'initiative de l'abbé Grégoire.

Rendu :

Le Cnam a été fondé en 17941 à l’initiative de l’abbé Grégoire.

Syntaxe par référence — l’appel de note et son contenu sont séparés. Utile pour les notes longues ou pour garder le texte principal lisible :

La thèse doit être déposée sur theses.fr[^depot] avant la soutenance.

[^depot]: Portail national des thèses géré par l'abes,
    accessible sur <https://theses.fr>.

Rendu :

La thèse doit être déposée sur theses.fr2 avant la soutenance.

En PDF, les deux syntaxes produisent une note numérotée en bas de page. En HTML, elles produisent une note de bas de page interactive (numéro cliquable avec renvoi vers l’appel de note).

AstuceQuelle syntaxe choisir ?

Préférez la syntaxe inline ^[…] pour les notes courtes (une phrase) — le contenu reste visible au fil de la rédaction. Utilisez la syntaxe par référence [^label] pour les notes longues ou multi-paragraphes, et pour éviter de surcharger visuellement la source Markdown quand la note dépasse deux lignes.

1.5.7 Sauts de page

Quarto fournit le shortcode pour insérer un saut de page compatible avec les deux formats de sortie :

Fin du contenu de cette section.

{{< pagebreak >}}

Début de la section suivante.

En PDF, génère \newpage. En HTML, il insère une règle de style page-break-after: always — sans effet à l’écran, mais utile si la page HTML est imprimée depuis le navigateur.

Astuce\newpage vs \clearpage

Si vous avez besoin de \clearpage (vide les figures et tableaux flottants en attente avant de sauter) plutôt que \newpage, utilisez un bloc LaTeX brut dans un {.content-visible when-format="pdf"} :

::: {.content-visible when-format="pdf"}
```{=latex}
\clearpage
```
:::

Dans une thèse avec de nombreuses figures, \clearpage est souvent préférable pour éviter que les flottants s’accumulent et apparaissent bien après leur point d’insertion dans le texte.

Mise en gardeLes sauts de page manuels sont à utiliser avec parcimonie

En règle générale, laissez LaTeX gérer la mise en page. Les sauts manuels résolvent un problème local mais peuvent en créer d’autres plus loin dans le document (pages blanches, flottants déplacés). Préférez les ajuster en toute fin de rédaction, une fois le contenu figé.

Bringhurst, Robert. 2004. The Elements of Typographic Style. 3ᵉ éd. Hartley & Marks.

  1. Décret de la Convention nationale du 19 vendémiaire an III (10 octobre 1794).↩︎

  2. Portail national des thèses géré par l’abes, accessible sur https://theses.fr.↩︎