From be7d31f6af3e4e126fa7dd5712622b236196dccc Mon Sep 17 00:00:00 2001 From: Juliette Engelaere-Lefebvre Date: Fri, 10 Jan 2025 19:05:48 +0100 Subject: [PATCH] =?UTF-8?q?r=C3=A9tablissement=20des=20douvlons=20chap=207?= =?UTF-8?q?=20et=209=20qui=20n'ont=20pas=20=C3=A9t=C3=A9=20vers=C3=A9s=20a?= =?UTF-8?q?u=20rapport=20(bookdown=20et=20autres=20format=20bas=C3=A9s=20s?= =?UTF-8?q?ur=20Rmd)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 07-bookdown_bis.Rmd | 62 +++++ 09_aller_plus_moin_bis.Rmd | 477 +++++++++++++++++++++++++++++++++++++ 2 files changed, 539 insertions(+) create mode 100644 07-bookdown_bis.Rmd create mode 100644 09_aller_plus_moin_bis.Rmd diff --git a/07-bookdown_bis.Rmd b/07-bookdown_bis.Rmd new file mode 100644 index 0000000..af89f35 --- /dev/null +++ b/07-bookdown_bis.Rmd @@ -0,0 +1,62 @@ +# A ne pas oublier + + +Utilisation backticks +Latex pour l'écriture mathématique +## Bookdown + +La principale différence entre la complilation en HTML d'un document bookdown et celle d'un document RMarkdown est que le premier comprend plusieurs pages HTML par défault - typiquement une par chapitre. La séparation d'un document en plusieurs pages a pour avantages d'autoriser l'envoi de liens vers des chacun des chapitres et de réduire le temps d'affichage car chaque page est moins lourde prise séparément. + +Les "plus" de bookdown (numérotation et référencement des équations, théorèmes, titres particuliers, bibliographie) ; cf bouquin bookdown pp 15-23 : + + +Balises +Table des matières +css +liens +images +versioning +mise en page +Flexdashboard +nommer les chunks +code hors chunks +Les thèmes ggplot pour assurer la présentation homogène des graphiques + les fonctions custom +Table des matières +Homogénéiser la présentation : fonctions graphiques + +# Rappels du jour 1 + +# Exercice + +## Cadrage + +J'ai mis ici le code d'une appli shiny que j'ai commencé à coder. L'objectif de l'appli est d'avoir une interface de géolocalisation pour les adresses RPLS dans un premier temps mais on peut élargir ça à toutes les tables qui contiennent le type d'informations requises (Type de voie, numéro de voie, nom de voie, code postal et code insee) par l'API d'Etalab. Le géocodage se fait a raison de 1000 lignes toutes les 2 minutes environ. J'ai jamais réussi à utiliser le géocodage csv fourni par Etalab (https://adresse.data.gouv.fr/csv#preview) c'est pourquoi je me suis lancé dans une appli qui requête leur API avec curl . + +Ca peut être utile pour l'exo car : +1 - on télécharge les données RPLS 2018 (eh oui, c'est celles que je connais bien) +2 - On récupère et nettoie un peu les adresses +3 - On les géolocalise grâce à l'API d'Etalab +4 - On affiche la carte sur leaflet +5 - C'est pas encore fini du tout +--- + # TODO : Les codes fonctionnent en .R si on lance tous les chunks dans un scrip. Mais je n'ai pas réussi à faire tourner les chunks dans un markdown +--- + +### Problématique +### Rendu +Pour ce rendu, quelles données ? Quels packages ? + ### Données dispo + + ## Mise en page + ### Quel type ? Barre de navigation ou onglets ? + ### Un petit CSS + ### Logo + ### Métadoonnées + ### Dashboard + + +Pour ce rendu, quelles données ? Quels packages ? + + ## Importation des données + + diff --git a/09_aller_plus_moin_bis.Rmd b/09_aller_plus_moin_bis.Rmd new file mode 100644 index 0000000..415410d --- /dev/null +++ b/09_aller_plus_moin_bis.Rmd @@ -0,0 +1,477 @@ + + + + + Formation publications reproductibles avec RMarkdown + + 2 - Les principaux templates pour créer des publications + + + + Maël THEULIERE - Marouane ZELLOU + + +Derrière Rmarkdown aujourd'hui existe tout un ecosystème permettant de mixer des traitements réalisés en R et du texte dans des formats très différents, que ce soit en matière de technologie (html, pdf, ...) ou de type de rendu (diaporama, rapport, livre, note, cv, ...). + +# Déroulé + + +## Bookdown + + +```{r, echo=FALSE, out.width='50%'} +knitr::include_graphics("https://bookdown.org/yihui/bookdown/images/logo.png") +``` + + + +## Pagedown + +```{r, echo=FALSE, out.width='50%'} +knitr::include_graphics("https://user-images.githubusercontent.com/163582/51942716-66be4180-23dd-11e9-8dbc-fdb4f465d1c2.png") +``` + + + +## Officer +```{r, echo=FALSE, out.width='50%'} +knitr::include_graphics("https://raw.githubusercontent.com/davidgohel/officer/master/inst/medias/officerlogo.svg") +``` + + + + + + +Le format Bookdown permet de gérer des projets Rmarkdown plus large qu'un simple document de quelques pages. + +Par ailleurs, le format bookdown apporte plusieurs améliorations : + +- Les livres et les rapports peuvent être créés à partir de plusieurs fichiers R Markdown. + +- Des fonctionnalités de mise en forme supplémentaires sont ajoutées, telles que les références croisées et la numérotation des figures, des équations et des tableaux. + +- Les documents peuvent être facilement exportés dans une gamme de formats adaptés à la publication (PDF, epub, HTML). + + +```{r, echo=FALSE, out.width='50%'} +knitr::include_graphics("https://bookdown.org/yihui/bookdown/images/logo.png") +``` + + + +Installer bookdown depuis le CRAN + +```{r, eval = FALSE} +install.packages('bookdown') +``` + +- Depuis Rstudio, cela vous apporte un nouveau type de projet, accessible depuis `File -> New Project -> New Directory -> Book Project using bookdown`. + +- Une fois celui ci créé, vous pouvez cliquer sur `Build book` dans l'onglet `Build` de Rstudio. Cela vous compilera le document en html, qui sera accessible dans le répertoire du projet et visible par défaut dans le viewer. + + + +```{r, echo=FALSE} +knitr::include_graphics("assets/img/templatespublications/bookdown.gif") +``` + + +Quand vous créé un projet bookdown, vous avez dans votre projet automatiquement les fichiers suivants : + + +- `index.Rmd`, le seul fichier Rmarkdown qui contient comme usuellement un yaml en entête. C'est le premier chapitre de votre livre. + +- `01-intro.Rmd` à `06-references.Rmd` des fichiers rmarkdown correspondant aux chapitres de vos livres. La structure classique d'un rmarkdown est un document Rmd par chapitre, qui seront ensuite pour la version html votre premier niveau de navigation. Chaque fichier comment par le titre du chapitre. + +- `_bookdown.yml` Un fichier de configuration de votre document bookdown. + +- `_output.yml` Un fichier de configuration des formats de sortie de votre document (pdf, html...). + +- `book.bib` un fichier de bibliographie au format [BibTeX](https://fr.wikipedia.org/wiki/BibTeX). + +- `preamble.tex` et `style.css` des fichiers de configuration de l'apparence de votre document pour sa version pdf (réalisé en LaTeX) et sa version html (réalisé en css). + + + +```md +directory/ +├── index.Rmd +├── 01-intro.Rmd +├── 02-literature.Rmd +├── 03-method.Rmd +├── 04-application.Rmd +├── 05-summary.Rmd +├── 06-references.Rmd +├── _bookdown.yml +├── _output.yml +├── book.bib +├── preamble.tex +├── README.md +└── style.css +``` + + +La balise yaml du fichier `index.Rmd` contient des options spécifiques au format bookdown sur la gestion de la bibliographie. + +```yaml +title: "A Minimal Book Example" +author: "Yihui Xie" +date: "`r Sys.Date()`" +site: bookdown::bookdown_site +documentclass: book +bibliography: [book.bib, packages.bib] +biblio-style: apalike +link-citations: yes +description: "This is a minimal example of using the bookdown package to write a book. The output format for this example is bookdown::gitbook." +``` +## La structure du projet - _bookdown.yml + + + +Le fichier `_bookdown.yml` permet de spécifier des options de configuration supplémentaires pour construire le livre. + +Par exemple : + +- changer le nom du fichier (`book_filename`) +- franciser le préfixe devant le numéro du chapitre (`chapter_name`) ou le préfixe des tableau et des graphiques (`fig` et `tab`) +- changer l'ordre de fusion des fichiers (`rmd_files`) + + + +```yaml +book_filename: "mon_premier_bookdown" +delete_merged_file: true +language: + ui: + chapter_name: "Chaptitre " + label: + fig: "Graphique " + tab: "Tableau " +rmd_files: ["index.Rmd", "01-intro.Rmd", "05-summary.Rmd"] +``` + + + + + +Le fichier `_output.yml` est utilisé pour spécifier les type de format de sortie (pdf, html...) et les options relatives à ces formats. + + +Pour le format html, c'est là par exemple que vous pouvez spécifier entre autre : + +- la feuille de style css à utiliser +- les textes inscrit en haut et en bas du menu de navigation +- les options de partage sur les réseaux sociaux que vous voulez (si vous en voulez, vous pouvez aussi tous les désactiver avec l'option `sharing` ci contre) + + + +```yaml +bookdown::gitbook: + css: style.css + config: + toc: + before: | +
  • Mon premier bookdown
    • + after: | +
  • Mon premier bookdown
    • + download: ["pdf", "epub"] + sharing: no + info: no +``` + + + +- Vous pouvez exclure un chapitre de la numérotation, en rajoutant `{-}` devant son nom dans le fichier Rmd. + +- Vous pouvez structurer vos chapitres en partie. +Pour commencer une partie rajouter `# ( PART) Nom de votre partie {-}` devant un chapitre. + + +# Pagedown +## Pagedown + + + + +Pagedown est une implémentation pour Rmarkdown de [paged.js](https://www.pagedjs.org/), qui permet de réaliser des documents html paginés. + + + + + +```{r, echo=FALSE} +knitr::include_graphics("https://user-images.githubusercontent.com/163582/51942716-66be4180-23dd-11e9-8dbc-fdb4f465d1c2.png") +``` + + + +## Paged.js + + + +[paged.js](https://www.pagedjs.org/) 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. +] + + + + +```{r, echo=FALSE} +knitr::include_graphics("https://www.pagedmedia.org/wp-content/uploads/2018/12/pagedjs-logo.png") +``` + + + + +Pour installer pagedown depuis le CRAN : + +```{r, eval = FALSE} +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. + + +```{r, echo=FALSE} +knitr::include_graphics("assets/img/templatespublications/pagedown.gif") +``` + + + + + +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. + + + + + +```yaml +title: "A Multi-page HTML Document" +author: "Yihui Xie and Romain Lesur" +date: "`r Sys.Date()`" +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 +``` + + +# Configurer votre yaml + +Voici quelques options du yaml intéressantes à connaître : + + + +```md +toc-title: sommaire +``` + + + +Pour modifier le nom du sommaire du document. + + + + +```md +lot: true +lot-title: "Tableaux" +lof: true +lof-title: "Graphiques" +``` + + + +Pour ajouter et configurer une liste de tableau et de graphique dans le sommaire. Si vous ne voulez pas que les graphiques et tableaux apparaissent dans le sommaire, vous pouvez utiliser `lot-unlisted: true`. + + + + +```md +chapter_name: "Chapitre\\ " +``` + + +Pour modifier le préfixe du titre du chapitre. Vous pouvez ensuite insérer un chapitre en utilisant `# Ceci est un titre de chapitre {.chapter}` + + +# Configurer votre yaml + +Voici quelques options du yaml intéressantes à connaître. + + + +```md +links-to-footnotes: true +``` + + + +Cette option transforme automatiquement un lien url dans votre document en note de bas de page. Ainsi `[CRAN](https://cran.r-project.org/)` sera traduit comme `[CRAN^(https://cran.r-project.org/)`. + +] + + + +```md + pagedown::html_paged: + front_cover: !expr system.file("help","figures","lter_penguins.png",package = "palmerpenguins") + back_cover: https://www.r-project.org/Rlogo.png + + +Pour rajouter une image pour la première de couverture et la 4ème de couverture. On peut utiliser le prefix !expr pour insérer du code R créant en sortie une image. + + + + +# Quelques balises importantes à connaître + + + +`.page-break-before` et `.page-break-after` vous permettent d'insérer un saut de page. + + +```md +### Nouveau chapitre après un saut de page {.page-break-before} +``` + + + +`[Chapitre 1]` vous permet de rajouter un lien vers la section `Chapitre 1`. + +# Modifier le CSS + +Apprendre à customiser un document pagedown va vous demander d'investir sur l'apprentissage du CSS en général et de pagedjs en particulier pour construire un template ad hoc. + +C'est un investissement en soit, qui pourra vous être utile de la même façon que la gestion de la mise en page d'un document bureautique. + +Vous pouvez aussi centraliser cet investissement pour votre équipe sur une ou deux personnes, ou travailler avec votre service web sur vos projets. + +Quelques ressources pour apprendre le CSS : + +- [Le site de la fondation Mozilla](https://developer.mozilla.org/fr/docs/Learn/Getting_started_with_the_web/CSS_basics) + +- [Le site du W3C](https://www.w3.org/Style/Examples/011/firstcss.fr.html) + +# Modifier le CSS + +Voici déjà quelques recettes de base pour commencer à modifier votre document. + +Première étape : importer les css par défaut de pagedown dans votre document. + +```{r, eval = FALSE} + +files <- c("default-fonts", "default-page", "default") +from <- pagedown:::pkg_resource(paste0("css/", files, ".css")) +to <- c("custom-fonts.css", "custom-page.css", "custom.css") +file.copy(from = from, to = to) +``` + +Ajouter une référence à ces fichiers dans le yaml : + +```yaml +output: + pagedown::html_paged: + css: + - custom-fonts.css + - custom-page.css + - custom.css + toc: true + self_contained: false +``` +# Modifier le CSS + +- Lancer dans la console `xaringan::inf_mr()`, qui permet de compiler un document Rmarkdown en ayant un aperçu live du rendu. + + + +- Appuyer ensuite sur `Show in new window` pour consulter le document sur votre navigateur par défaut. + + + +```{r, echo=FALSE} +knitr::include_graphics("assets/img/templatespublications/show_new_window.png") +``` + + + + +- Puis sur `Clear all viewer item`, pour que vos modifications puisse s'afficher en live. + + + +```{r, echo=FALSE} +knitr::include_graphics("assets/img/templatespublications/clear_all_viewer_item.png") +``` + + +#### Configurer votre document pagedown +# Modifier le CSS + +Vous pouvez commencer à modifier vos fichiers css et voir le résultats immédiatement. + +Les 3 fichiers correspondent aux éléments suivants : + +- `custom-fonts.css` correspond aux polices de caractères +- `custom-page.css` correspond aux paramètres de la page (format de la page, orientation,...) +- `custom.css` intègre entre autre la façon dont les pages sont affichées à l'écran (couleur de fond, espacement entre les pages...) + + + +[`{pagedreport}`](https://pagedreport.rfortherestofus.com/) est un package permettant de simplifier l'appropriation de pagedown, et notamment évite de devoir rentrer tout de suite dans une modification du css. + +Il n'est pas encore sur le cran, pour l'installer : + +```{r, eval = FALSE} +remotes::install_github("rfortherestofus/pagedreport) +``` + + + +```{r, echo = FALSE} +knitr::include_graphics("https://mk0rfortheresto0o08q.kinstacdn.com/wp-content/uploads/2021/01/windmill.gif") +``` + + +`{pagedreport}` vous simplifie l'utilisation de pagedown en proposant trois templates avancés paramétrables via de nouvelles options à intégrer dans le yaml : + + +- `paged_grid::logo` vous permet d'ajouter le logo de votre institution à votre rapport +- `paged_grid::logo` vous permet d'ajouter le logo de votre institution à votre rapport +- `paged_grid::front_img` et `paged_grid::back_img` vous permettent de choisir deux images pour la première et la quatrième de couverture. +- `main-color` et `secondary-color` vous permette de choisir les couleurs principales et secondaires de votre document. +- `main-font` et `header-font` vous permettent de choisir une police de caractère pour le texte et vos titres. Si `google-font` est à TRUE, vous pouvez sélectionner toute police disponible sur google font. + + + + +```{yaml} +subtitle: "Au 1er juin 2021" +author: "Guillaume RRRRRozier" +date: "11 juin 2021" +output: + pagedreport::paged_grid: + logo: "https://upload.wikimedia.org/wikipedia/fr/7/72/Logo_du_Gouvernement_de_la_R%C3%A9publique_fran%C3%A7aise_%282020%29.svg" +knit: pagedown::chrome_print +toc-title: "Sommaire" +main-color: "#000091" +secondary-color: "#000091" +google-font: TRUE +main-font: "Open Sans" +header-font: "Open Sans" +``` +