Annexe A — Configuration YAML

Cette annexe documente les deux fichiers de configuration principaux du template : _quarto.yml (métadonnées communes à tous les rendus) et _quarto-fr.yml / _quarto-en.yml (métadonnées propres à chaque langue).

A.1 Métadonnées dans `_quarto.yml` — page de garde

_quarto.yml contient les champs communs à tous les profils : jury, encadrants, informations institutionnelles. Le titre, l’auteur et la date de soutenance se trouvent dans le profil de langue (voir la section Profils de langue ci-dessous).

book:
  downloads: [pdf]                  # bouton PDF dans la barre HTML

discipline: "60e section CNU — Mécanique, génie mécanique, génie civil"
specialite: "Acoustique"
ecole-doctorale: "Sciences des Métiers de l'Ingénieur"
laboratoire: "Laboratoire MACS, Cnam Paris"
directeur: "Pr. Prénom NOM, Professeur des Universités, Cnam Paris"
cotutelle: false

dedicace: "Dédicace optionnelle…"   # supprimer si absent

A.2 Composition du jury pour la page de garde

jury:
  - nom: "Mme Prénom NOM"
    titre: "Titre, Unité de recherche, Établissement"
    role: "Présidente"
  - nom: "M. Prénom NOM"
    titre: "Titre, Unité de recherche, Établissement"
    role: "Rapporteur"
  - nom: "Mme Prénom NOM"
    titre: "Titre, Unité de recherche, Établissement"
    role: "Rapportrice"
  - nom: "M. Prénom NOM"
    titre: "Maître de conférences HDR, Unité, Établissement"
    role: "Évaluateur"
  - nom: "M. Prénom NOM"
    titre: "Professeur des Universités, MACS, Cnam Paris"
    role: "Directeur de thèse"

A.3 Options de la section Infrastructure

glossaire: true          # true = charge le package LaTeX glossaries
pagestyle-sections: true # true = numérotation romaine/arabe/Romain par section
bibliography-manual: true
minitoc-newpage: false   # true = saut de page après chaque mini-TOC
chapter-openright: true  # false = pour version numérique sans page de droite
index: false             # true = génère un index via \index{terme}

A.4 Commentaires collaboratifs (`quarto-comments`)

extensions:
  quarto-comments:
    enabled: true    # false avant le dépôt final sur theses.fr
    authors:
      doc:
        name: "Prénom NOM"       # doctorant·e
      dir:
        name: "Directeur·rice"
      # Couleurs auto-assignées depuis la palette Bootstrap 5 ; surcharger si besoin :
      # codir:
      #   name: "Co-directeur·rice"
      #   color_html: "#198754"
      #   color_latex: "green!30"

Voir Section 5.3 pour la syntaxe des shortcodes et le comportement PDF/HTML.

A.5 Annotations web Hypothesis (opt-in)

Pour permettre aux relecteurs d’annoter directement la version HTML dans leur navigateur, décommenter ce bloc dans _quarto.yml :

format:
  cnam-thesis-html:
    comments:
      hypothesis:
        theme: clean   # clean = discret ; classic = barre latérale toujours visible

Créer un groupe privé sur hypothes.is et partager le lien d’invitation. Les annotations sont liées à l’URL — fonctionne mieux sur un déploiement stable (GitHub Pages). Voir Section 5.3 pour plus de détails.

A.6 Exécution Python

execute:
  freeze: auto    # recalcule seulement si le code du chunk change
  echo: true      # affiche le code par défaut (surchargeable par chunk)

A.7 Profils de langue : `_quarto-fr.yml` et `_quarto-en.yml`

Les profils de langue surchargent _quarto.yml au moment du rendu avec --profile fr ou --profile en. Ils définissent les métadonnées propres à la langue — titre, auteur, date de soutenance — ainsi que la liste des chapitres et les options techniques du rendu.

A.7.1 Liste des chapitres (première chose à adapter)

C’est la première chose à modifier lors de la prise en main du template. La liste complète des fichiers qui constituent le livre se trouve dans _quarto-fr.yml (ou _quarto-en.yml), sous la clé book.chapters :

book:
  chapters:
    - index.qmd                                    # page d'accueil HTML — ne pas supprimer
    - content_fr/liminaire/remerciements.qmd
    - content_fr/liminaire/resume.qmd
    - content_fr/liminaire/abstract.qmd
    - content_fr/liminaire/tables.qmd              # TOC + listes PDF — ne pas supprimer
    - content_fr/liminaire/glossaire-entries.qmd   # supprimer si glossaire: false
    - content_fr/liminaire/acronymes.qmd           # supprimer si glossaire: false
    - content_fr/liminaire/glossaire.qmd           # supprimer si pas de termes
    - content_fr/chapitres/00-introduction.qmd
    - content_fr/chapitres/01-chapitre1.qmd        # ← ajouter vos chapitres ici
    - content_fr/chapitres/02-chapitre2.qmd
    - content_fr/postliminaire/conclusion.qmd
    - content_fr/postliminaire/bibliographie.qmd
  appendices:
    - content_fr/postliminaire/annexes.qmd
    - content_fr/postliminaire/annexes-pdfa.qmd

Pour ajouter un chapitre : créer un fichier .qmd dans content_fr/chapitres/ et l’insérer dans cette liste à l’emplacement souhaité.

Ne pas supprimer index.qmd ni tables.qmd

index.qmd est le point d’entrée du livre Quarto — le supprimer casse le rendu HTML. tables.qmd génère la table des matières, la liste des figures et la liste des tableaux dans le PDF.

A.7.2 Autres options du profil

thesis-lang: fr      # langue de rédaction : fr ou en
validate: false      # mettre à true avant dépôt sur theses.fr (voir @sec-pdfa)

book:
  title: "Titre de la thèse"
  subtitle: "Sous-titre éventuel"   # supprimer si absent
  author: "Prénom NOM"
  output-file: these_fr             # nom de base du PDF (these_fr_<auteur>.pdf)

date-soutenance: "10 Octobre 1794"  # NE PAS utiliser date:

project:
  output-dir: _these_fr     # répertoire de sortie
  post-render:
    - ./_scripts/postrender.ts fr _these_fr