10  Introduction aux formats

::: callout-nojupyter notebookte

La version 1.4 de Quarto (janvier 2024) ajoute deux nouveaux formats de type html:

• Le format manuscript: https://quarto.org/docs/manuscripts/
• Le format dashboard: https://quarto.org/docs/dashboards/

Seront traités dans une version ultérieure sous forme de fiche.

:::

10.1 Les différents formats

Documents simples:

• Notebook ou article:
  • html: défaut.
  • Pdf: demande le package tinytex sous RStudio.
  • Word (ou Libre Office).
  • Notebook Jupyter.
• Présentation:
  • html: revealjs (defaut).
  • pdf: beamer, demande le package tinytex sous RStudio.
  • Powerpoint (ou Libre Office).

Contenu de cette partie:

• Options liés aux différents formats dans le yaml, certaines étant propres à un type de format et d’autres communes.
• Pour chaque format, présentations de quelques options ou règles propres.
• Compilation simultanée en plusieurs formats.

Il n’est bien évidemment de lister l’ensemble des options. La documentation de Quarto est complète sur ce point.

Documentation de référence:

Format	Liens
Html notebook/article	Basique Avancé
Html presentation (revealjs)	Basique Avancé Gallery
PDF notebook/article	Basique Avancé
PDF presentation (beamer)	Basique Avancé
Office (ms - open) notebook/article	Basique Avancé MS template
Office (ms - open) Powerpoint	Basique Avancé

Durée de compilation pour le format pdf

En raison d’une durée de compilation assez longue, il est conseillé dans un premier temps de privilégier l’output html.

10.2 Introduction des options par format

• Les options ou arguments communs, comme un titre, sont introduites comme options principale.

• Les options propres à un format sont des sous-options de l’option format qui a été spécifiée.

• Les options communes peuvent avoir des attributs différents, on les renseigne comme sous-options de chaque format.

10.2.1 L’option format

• Pour les notebooks ou les présentations, le format par défaut est le html. On peut le changer dès la création du document dans le menu file.

• L’option pour spécifier le type de document ou présentation est format:.

Par exemple pour une présentation de type beamer (Latex/pdf):

---
format: beamer
---

ou

---
format: 
  beamer: default
---

10.3 Options communes et spécifiques aux formats

10.3.1 Options communes

Exemple: activation de la table des matières pour les formats html et pdf

• Option toc: true

---  
format:
  html: default
  pdf: default

toc: true

---

est identique à:

---
format: 
  html:
    toc: true
  pdf:
    toc: true
---

10.3.1.1 Options ou attributs spécifiques aux formats

Option différente

• En sous option du format sélectionné.
• Exemple: changement de thème pour le html (theme: nom_theme), report d’une table des graphiques (lof:true) et d’une table des tableaux pour le format pdf.

---
format:
  html: 
    theme: zephyr
  pdf:
    lof: true
    lot: true
  
toc: true        
---

Option commune et attributs différents

• En sous option du format, on change les attributs de l’option commune.

• Exemple pour le report du nombre de sous sections dans la table des matières. L’option commune aux deux formats est toc_depth: valeur (par défaut 3). Si on choisit 2 pour le format html et 4 pour le pdf.

---
format:
  html: 
    toc: true
    toc_depth: 2
  pdf:
    toc: true
    toc_depth: 4 
    
---

De nouveau si l’option était commune aux deux formats, on pourrait directement la renseigner en option principale.

---
format:
  html: default 
  pdf:  default
   
toc: true
toc_depth: 2    
---

… même un titre peut être propre à chaque format

---
format:
  html: 
    titre: "HTML"
  pdf: 
    titre: "PDF"  
---

Le titre du document html sera “HTML” et le titre du document pdf sera “PDF”.