Annexe A — YAML configuration

This appendix documents the two main configuration files of the template: _quarto.yml (metadata shared across all renders) and _quarto-fr.yml / _quarto-en.yml (metadata specific to each language profile).

A.1 Metadata in _quarto.yml — cover page

_quarto.yml holds the fields shared across all profiles: jury, supervisors, institutional information. Title, author, and defence date belong in the language profile (see Language profiles below).

book:
  downloads: [pdf]                     # PDF button in the HTML sidebar

discipline: "60th CNU section — Mechanics, mechanical engineering, civil engineering"
specialite: "Acoustics"
ecole-doctorale: "Sciences des Métiers de l'Ingénieur"
laboratoire: "MACS Laboratory, Cnam Paris"
directeur: "Prof. First LAST, Full Professor, Cnam Paris"
cotutelle: false

dedicace: "Optional dedication…"       # remove if absent

A.2 Jury composition for the cover page

jury:
  - nom: "Ms First LAST"
    titre: "Title, Research Unit, Institution"
    role: "Chair"
  - nom: "Mr First LAST"
    titre: "Title, Research Unit, Institution"
    role: "Reviewer"
  - nom: "Ms First LAST"
    titre: "Title, Research Unit, Institution"
    role: "Reviewer"
  - nom: "Mr First LAST"
    titre: "Associate Professor HDR, Unit, Institution"
    role: "Examiner"
  - nom: "Mr First LAST"
    titre: "Full Professor, MACS, Cnam Paris"
    role: "Thesis supervisor"

A.3 Infrastructure section options

glossaire: true          # true = loads the LaTeX glossaries package
pagestyle-sections: true # true = roman/arabic/Roman numbering per section
bibliography-manual: true
minitoc-newpage: false   # true = page break after each mini-TOC
chapter-openright: true  # false = for digital version without right-hand page
index: false             # true = generates an index via \index{term}

A.4 Collaborative comments (quarto-comments)

extensions:
  quarto-comments:
    enabled: true    # false before final deposit on theses.fr
    authors:
      doc:
        name: "First LAST"       # doctoral student
      dir:
        name: "Supervisor"
      # Colors auto-assigned from Bootstrap 5 palette; override if needed:
      # codir:
      #   name: "Co-supervisor"
      #   color_html: "#198754"
      #   color_latex: "green!30"

See Section 5.3 for shortcode syntax and PDF/HTML rendering details.

A.5 Web annotations with Hypothesis (opt-in)

To allow reviewers to annotate the HTML version directly in their browser, uncomment this block in _quarto.yml:

format:
  cnam-thesis-html:
    comments:
      hypothesis:
        theme: clean   # clean = discreet ; classic = sidebar always visible

Create a private group on hypothes.is and share the invite link. Annotations are tied to the page URL — works best on a stable deployment (GitHub Pages). See Section 5.3 for more details.

A.6 Python execution

execute:
  freeze: auto    # recomputes only if the chunk code changes
  echo: true      # shows code by default (overridable per chunk)

A.7 Language profiles: _quarto-fr.yml and _quarto-en.yml

Language profiles override _quarto.yml when rendering with --profile fr or --profile en. They define the language-specific metadata — title, author, defence date — as well as the chapter list and technical render options.

A.7.1 Chapter list (first thing to customise)

This is the first thing to change when taking the template in hand. The full list of files that make up the book is defined in _quarto-en.yml (or _quarto-fr.yml), under the book.chapters key:

book:
  chapters:
    - index.qmd                                    # HTML home page — do not remove
    - content_en/frontmatter/acknowledgements.qmd
    - content_en/frontmatter/resume.qmd            # French abstract (Cnam requirement)
    - content_en/frontmatter/abstract.qmd
    - content_en/frontmatter/tables.qmd            # TOC + PDF lists — do not remove
    - content_en/frontmatter/glossaire-entries.qmd # remove if glossaire: false
    - content_en/frontmatter/acronyms.qmd          # remove if glossaire: false
    - content_en/frontmatter/glossary.qmd          # remove if no glossary terms
    - content_en/chapters/00-introduction.qmd
    - content_en/chapters/01-chapter1.qmd          # <- add your chapters here
    - content_en/chapters/02-chapter2.qmd
    - content_en/backmatter/conclusion.qmd
    - content_en/backmatter/bibliography.qmd
  appendices:
    - content_en/backmatter/appendices.qmd
    - content_en/backmatter/appendices-pdfa.qmd

To add a chapter: create a .qmd file in content_en/chapters/ and insert it in this list at the desired position.

AvertissementDo not remove index.qmd or tables.qmd

index.qmd is the Quarto book entry point — removing it breaks the HTML render. tables.qmd generates the table of contents, list of figures and list of tables in the PDF.

A.7.2 Other profile options

thesis-lang: en      # thesis language: fr or en
validate: false      # set to true before depositing to theses.fr (see @sec-pdfa)

book:
  title: "Thesis title"
  subtitle: "Optional subtitle"        # remove if absent
  author: "First LAST"
  output-file: these_en               # base name of the generated PDF (these_en_<author>.pdf)

date-soutenance: "10 October 1794"    # DO NOT use date:

project:
  output-dir: _thesis-en    # output directory
  post-render:
    - ./_scripts/postrender.ts en _thesis-en

format:
  cnam-thesis-html:
    toc-title: "Table of Contents"   # English sidebar TOC title