Chapitre 13 Pagedown

13.1 Pagedown

Pagedown est une implémentation pour Rmarkdown de paged.js, qui permet de réaliser des documents html paginés.

13.2 Paged.js

paged.js est une bibliothèque javascript visant à mettre en oeuvre [les propriétés css dédiées au médias paginés(https://www.w3.org/TR/css-page-3/) du W3C.

Ces spécifications visent à pouvoir réaliser des documents prêt pour l’impression avec les technologies du web (html, css, js).

Ces spécifications sont toujours en draft pour le moment au sein du W3C, donc pas vraimente reconnues par les principaux navigateurs. D’où le besoin de cette bibliothèque javascrit pour pouvoir les mettre en oeuvre. ]

Pour installer pagedown depuis le CRAN :

install.packages('rstudio/pagedown')

Depuis Rstudio, cela vous apporte un nouveau type de document rmarkdown, accessible depuis File -> New File -> Rmarkdown... -> From template -> Paged HTML document.

Une fois celui ci créé, vous pouvez cliquer sur knit de l’interface de Rstudio. Cela vous compilera le document par défaut en html, qui sera accessible dans le répertoire du projet et visible par défaut dans le viewer.

La structure du yaml est relativement proche d’un document Rmarkdown classique.

A noter toutefois une option utile à retenir, la balise knit: pagedown::chrome_print qui vous permet de compiler directement votre document en pdf grâce à la fonction pagedown::chrome_print() livrée dans le package.

Cette fonction par ailleurs peut être utilisée pour imprimer en pdf tout document html en pdf ou en format image. Elle utilise la technologie d’impression de google chrome.

title: "A Multi-page HTML Document"
author: "Yihui Xie and Romain Lesur"
date: "2025-01-17"
output:
  pagedown::html_paged:
    toc: true
    \# change to true for a self-contained document, but it'll be a litte slower for Pandoc to render
    self_contained: false
\# uncomment this line to produce HTML and PDF in RStudio:
\#knit: pagedown::chrome_print