En-tête YAML

Vous pouvez contrôler de nombreux autres paramètres du « document entier » en modifiant les paramètres de l’en-tête YAML.

Vous vous demandez peut-être ce que signifie YAML : il s’agit d’un « “yet another markup language », conçu pour représenter des données hiérarchiques d’une manière facile à lire et à écrire pour les humains. R Markdown l’utilise pour contrôler de nombreux détails de la sortie.

L’en-tête d’un document R Markdown (arfois appelé YAML header) est délimité par deux lignes de pointillés et contient les métadonnées du document (titre, auteurs, options générales de mise en page…). Il contient au minimum le titre du document et le format de sortie. Il peut être enrichi d’autres champs pour modifier certaines métadonnées (par exemple la date) ou le style du document compilé. Voici un exemple d’en-tête:

Paramètres

Les documents R Markdown peuvent inclure un ou plusieurs paramètres dont les valeurs peuvent être définies lorsque vous rendez le rapport. Les paramètres sont utiles lorsque vous souhaitez rendre à nouveau le même rapport avec des valeurs distinctes pour diverses entrées clés.

Par exemple, vous pouvez produire des rapports de vente par branche, des résultats d’examen par étudiant ou des statistiques démographiques par pays. Pour déclarer un ou plusieurs paramètres, utilisez le champ par ams. Cet exemple utilise un paramètre my_class pour déterminer la classe de voitures à afficher :

---
title: "R Markdown cours 8 du ACT3035"
author: "Noureddine Meraihi"
date: "2022-10-24"
output: 
  html_document:
    keep_md: true
    self_contained: true
bibliography: book.bib
description: "Un document qui donne des exemples de base pour R Markdown su cours 8 ACT2025"
---
```{r setup, include = FALSE}
library(ggplot2)
library(dplyr)
class <- mpg %>% filter(class == params$my_class)
```
# Fuel economy for `r params$my_class`s
```{r, message = FALSE}
ggplot(class, aes(displ, hwy)) +
  geom_point() +
  geom_smooth(se = FALSE)
```