Commit 10f8418f authored by David Carayon's avatar David Carayon
Browse files

new powerpoint and latex templates

parent c5be031d
......@@ -10,7 +10,12 @@ Authors@R:
person(given = "Sébastien",
family = "Boutry",
role = c("aut"),
email = "sebastien.boutry@inrae.fr"))
email = "sebastien.boutry@inrae.fr"),
person(given = "Eric",
family = "Quinton",
role = c("ctb"),
email = "eric.quinton@inrae.fr")
)
Description: Ce package met à disposition des modèles de document ainsi que des thèmes ggplot suivant la charte graphique INRAE.
License: GPL-3
Encoding: UTF-8
......
# Generated by roxygen2: do not edit by hand
export(bookdown_inrae)
export(inrae_report)
export(latex_presentation)
export(latex_report)
export(new_analysis)
export(palette_inrae)
export(scale_color_inrae)
......
#' Create analysis directory template
#'
#' @param dir the directory where the analysis template will be created
#'
#' @return
#' @export
#'
#' @examples
#' library(InraeThemes)
#' \dontrun{new_analysis()}
inrae_report <- function(dir = "MyProject"){
}
#' Copy a LaTeX template for reports
#'
#' Template proposed by E. Quinton (INRAE/EABX)
#'
#' @param dir the directory where the template will be copied to
#'
#' @return a full latex template
#' @export
latex_report <- function(dir = "MyProject"){
if (!dir.exists(dir)) {dir.create(dir)}
# Creating folders --------------------------------------------------------
path <- system.file("Latex_templates/latex_report", package = "InraeThemes")
file.copy(path, dir, recursive = TRUE)
setwd(file.path(dir,"latex_report"))
cli::cli_alert_warning(paste0("Working directory changed to '", paste0(dir,"/latex_report","'")))
cli::cli_alert_info(paste0("Now opening '", "document_inrae.tex","'"))
rstudioapi::navigateToFile("document_inrae.tex")
}
#' Copy a LaTeX template for presentations
#'
#' Template proposed by E. Quinton (INRAE/EABX)
#'
#' @param dir the directory where the template will be copied to
#'
#' @return a full latex presentation template
#' @export
latex_presentation <- function(dir = "MyProject"){
if (!dir.exists(dir)) {dir.create(dir)}
# Creating folders --------------------------------------------------------
path <- system.file("Latex_templates/latex_presentation", package = "InraeThemes")
file.copy(path, dir, recursive = TRUE)
setwd(file.path(dir,"latex_presentation"))
cli::cli_alert_warning(paste0("Working directory changed to '", paste0(dir,"/latex_presentation","'")))
cli::cli_alert_info(paste0("Now opening '", "modele_beamer_inrae.tex","'"))
rstudioapi::navigateToFile("modele_beamer_inrae.tex")
}
......@@ -15,13 +15,15 @@ knitr::opts_chunk$set(
library(magrittr)
```
# InraeThemes <img src='man/figures/logo_hex.png' align="right" height="139" />
# InraeThemes <img src="man/figures/logo_hex.png" align="right" height="139"/>
<!-- badges: start -->
[![Lifecycle: experimental](https://img.shields.io/badge/lifecycle-experimental-orange.svg)](https://www.tidyverse.org/lifecycle/#experimental)
<!-- badges: end -->
InraeThemes est un package proposant une variété de templates (Rmarkdown), de thèmes (ggplot) et de fonctions utilitaires qui respectent la charte graphique INRAE.
InraeThemes est un package proposant une variété de templates (Rmarkdown/LaTeX), de thèmes (ggplot) et de fonctions utilitaires qui respectent la charte graphique INRAE.
**Attention : Ces modèles nécessitent l'installation de 2 polices adoptées dans la charte graphique INRAE : [Raleway](https://fonts.google.com/specimen/Raleway) et [Avenir Next Pro](https://fr.maisfontes.com/avenir-next-lt-pro).**
......@@ -126,47 +128,52 @@ new_analysis(dir = "MyProject")
Ce qui va produire l'output suivant :
```
! Working directory changed to '~/Bureau/MyProject'
✓ A new analysis directory was created with the following directories :
├── MyProject
│ ├── data # Contient les données
│ ├── R # Contient les scripts basiques (.R) ou les notebooks (.Rmd)
│ │ └── 01_notebook.Rmd
│ ├── plots # Contient les graphiques produits
│ ├── raw-data # Contient des jeux de données à exclure du suivi de version
│ ├── README.md # Pour décrire le projet
ℹ Now opening 'R/01_notebook.Rmd'
```
! Working directory changed to '~/Bureau/MyProject'
✓ A new analysis directory was created with the following directories :
├── MyProject
│ ├── data # Contient les données
│ ├── R # Contient les scripts basiques (.R) ou les notebooks (.Rmd)
│ │ └── 01_notebook.Rmd
│ ├── plots # Contient les graphiques produits
│ ├── raw-data # Contient des jeux de données à exclure du suivi de version
│ ├── README.md # Pour décrire le projet
ℹ Now opening 'R/01_notebook.Rmd'
Puis, le répertoire de travail sera automatiquement déplacé vers ce répertoire et le fichier `R/01_notebook.Rmd` sera automatiquement ouvert afin de débuter les analyses. Ce notebook contient lui-même un certain nombre de conseils proposés par les auteurs de ce package.
# Templates de documents/présentations
Ce package permet enfin de rédiger des rapports et/ou présentations pré-formatés selon la charte graphique INRAE via un plugin RStudio. Les modèles sont accessibles via `File > New File > Rmarkdown > From Template`.
Ce package permet enfin de rédiger des rapports et/ou présentations pré-formatés selon la charte graphique INRAE.
> **Attention, ces fonctions ne visent qu'à fournir des templates (css, LaTeX, docx, logos) correspondants à la charte INRAE, associés à des fichiers Rmarkdown avec un YAML correctement configuré. Nous invitons les utilisateurs à se renseigner par la suite sur chacune des technologies utilisées (rmarkdown, LaTeX, pagedown, officedown, revaljs, remarkjs, etc.) pour aller plus loin dans la personnalisation des documents.**
**Attention, ces fonctions ne visent qu'à fournir des templates (css, LaTeX, docx, logos) correspondants à la charte INRAE, associés à des fichiers Rmarkdown avec un YAML correctement configuré. Nous invitons les utilisateurs à se renseigner par la suite sur chacune des technologies utilisées (rmarkdown, LaTeX, pagedown, officedown, revaljs, remarkjs, etc.) pour aller plus loin dans la personnalisation des documents.**
## Rapports
## Rapport (court) INRAE Pagedown
Différents templates sont proposés en fonction de la longueur du rapport et du format de sortie désiré (pdf, docx, html).
### Rapport paginé (Pagedown)
Ce premier template permet de produire un rapport HTML et/ou PDF (au choix) en utilisant le package {pagedown}. Ce format est dédié à la rédaction de rapports relativement courts car la rédaction se concentre dans un seul fichier .Rmd. Lorsque la rédaction devient plus lourde avec séparation des chapitres et une bibliographie par chapitre par exemple, il convient de passer au modèle suivant (i.e. {bookdown}).
{pagedown} est un package s'appuyant sur [rmarkdown](https://rmarkdown.rstudio.com/) et [pagedjs](https://www.pagedjs.org/) afin de produire des documents HTML dits "paginés". Puisqu'il s'agit de documents HTML, l'affichage est entièrement personnalisable via l'utilisation de code HTML/CSS. Pour plus d'informations : [Visitez le site de {pagedown}](https://pagedown.rbind.io/).
Le template .Rmd est livré avec une feuille de style .css correspondant aux couleurs INRAE ainsi que différents éléments graphiques (logo, première/dernière page, etc.). Un template au format .svg est également livré afin d'éditer les premières/dernières pages, par exemple pour modifier l'image de fond ou pour écrire directement les informations du rapport (dans le cas par exemple d'un titre trop long, d'un sous-titre, etc.).
Ce template est accessible via `File > New File > Rmarkdown > From Template`.
Le template .Rmd est livré avec une feuille de style .css correspondant aux couleurs INRAE ainsi que différents éléments graphiques (logo, première/dernière page, etc.). Un template au format .svg est également livré afin d'éditer les premières/dernières pages, pour modifier par exemple l'image de fond ou pour écrire directement les informations du rapport (ex: titre trop long, ajout d'un sous-titre, de logos, etc.).
L'utilisateur pourra choisir d'utiliser `chrome_print` dans le YAML au moment de la compilation pour obtenir un fichier PDF en plus de la sortie HTML.
L'utilisateur pourra choisir d'utiliser `chrome_print` dans le YAML au moment de la compilation pour obtenir un fichier PDF en plus de la sortie HTML.
Voici un exemple de rapport :
![](man/figures/cap_rapport.png)
## Rapport (long) INRAE
### Rapport fragmenté (Bookdown)
Ce second template permet de produire un rapport HTML et/ou PDF (au choix) en utilisant le package {bookdown}. Ce format est dédié à la rédaction document longs et complexes (i.e livres, thèses, etc.) car il permet une gestion modulaire des chapitres, notamment en ce qui concerne la bibliographie.
Ce second template permet de produire un rapport HTML et/ou PDF (au choix) en utilisant le package {bookdown}. Ce format est dédié à la rédaction document longs et complexes (i.e livres, thèses, etc.) car il permet une gestion modulaire des chapitres en fragmentant le rapport en plusieurs sous-documents.
{bookdown} est un package principalement dédié, tel que son nom l'indique, à la rédaction de livres. Contrairement au format {pagedown}, la version PDF nécessitera ici une installation LaTeX. Pour plus d'informations : [Visitez le site de {bookdown}](https://bookdown.org/).
Comme il s'agit d'un format particulier, constitué d'un grand nombre de fichiers, celui-ci ne peut être proposé comme template Rstudio. Mais son utilisation reste simple, puisqu'il suffit juste de lancer la commande :
Comme il s'agit d'un format particulier, constitué d'un grand nombre de fichiers, celui-ci ne peut être proposé via un addin Rstudio. Mais son utilisation reste simple, puisqu'il suffit juste de lancer la commande :
```{r eval = FALSE}
bookdown_inrae("Mon_Rapport")
......@@ -174,13 +181,17 @@ bookdown_inrae("Mon_Rapport")
Pour que le dossier avec l'ensemble des fichiers soit créé à l'endroit de votre choix. Le répertoire de travail est automatiquement modifié et le fichier "index.Rmd" automatiquement ouvert.
> Note : Pour une manipulation plus simple du document via des fonctionnalités Rstudio (notamment le widget "Build Book" qui s'avère très pratique). Nous vous recommandons de créer un projet bookdown vierge via les templates de projet Rstudio, puis de copier/remplacer les fichiers `bloc_etat.png`, `index.Rmd` et `styles.css` créés par cette fonction, que vous pouvez aller directement récupérer dans les fichiers internes du package à l'adresse renvoyée par `system.file("Bookdown_Inrae", package = "InraeThemes")`.
Voici un exemple de rapport :
![](man/figures/cap_book.png)
## Rapport Word INRAE
### Rapport éditable (Word)
Ce troisième template permet de produire un rapport au format Microsoft Word (.docx).
Ce troisième template permet de produire un rapport au format Microsoft Word (.docx). Il fait appel aux packages [{officer}](https://cran.r-project.org/package=officer) et [{officedown}](https://github.com/davidgohel/officedown).
Ce template est accessible via `File > New File > Rmarkdown > From Template`.
Le template Rmd est livré avec un template au format .docx, à modifier selon les préférences de l'utilisateur, et un logo bloc-état.
......@@ -188,19 +199,84 @@ Voici un exemple de rapport :
![](man/figures/cap_word.png)
## Présentation INRAE RevealJS
### Rapport statique (LaTeX)
Ce quatrième template est une exception puisqu'il s'agit d'un template LaTeX (et non Rmarkdown). Une maîtrise de LaTeX est donc requise pour l'utilisation de ce modèle.
> **Note : Ce modèle a été développé par E. Quinton (INRAE/EABX).**
Puisque ce template nécessite un grand nombre de fichiers pour fonctionner (images, page de garde, etc.) et n'est pas un template Rmarkdown, celui-ci ne peut être proposé via un addin Rstudio. Mais son utilisation reste simple, puisqu'il suffit juste de lancer la commande :
```{r eval = FALSE}
latex_report("Mon_Rapport")
```
Pour créer un répertoire contenant le template prêt à l'emploi. Le fichier principal du template (`document_inrae.tex`) sera automatiquement ouvert sur Rstudio.
Voici un exemple de rapport :
![](man/figures/cap_latex.png)
## Présentations
### Présentation dynamique 2D (RevealJS)
Ce cinquième template permet de produire une présentation HTML utilisant la technologie RevealJS. La présentation est construites en 2 niveaux : les titres de premiers niveau définissent la dimension horizontale tandis que les titres de second niveau (et plus) définissent la dimension verticale. Chaque titre correspond à une diapositive.
Ce template est accessible via `File > New File > Rmarkdown > From Template`.
Ce quatrième template permet de produire une présentation HTML utilisant la technologie RevealJS (présentations web construites en 2 niveaux : les titres de premiers niveau définissent la dimension horizontale tandis que les titres de second niveau (et plus) définissent la dimension verticale. Chaque titre correspond à une diapositive).
Le template Rmd est livré avec une feuille de style CSS correspondant aux couleurs INRAE et un logo bloc-etat.
Le template Rmd est livré avec une feuille de style CSS correspondant aux couleurs INRAE et d'un logo bloc-etat.
L'utilisateur pourra choisir d'utiliser `chrome_print` au moment de la compilation pour obtenir un fichier PDF en plus de la sortie HTML (Mais déconseillé, privilégier RemarkJS pour la sortie PDF).
Voici un exemple de présentation :
![](man/figures/cap_reveal.png)
## Présentation INRAE RemarkJS
### Présentation statique (RemarkJS)
Ce sixième template permet de produire une présentation HTML/PDF utilisant la technologie RemarkJS du package {[xaringan](https://github.com/yihui/xaringan)}.
Ce cinquième template permet de produire une présentation HTML/PDF utilisant la technologie RemarkJS du package {[xaringan](https://github.com/yihui/xaringan)}.
Ce template est accessible via `File > New File > Rmarkdown > From Template`.
Le template Rmd est livré avec une feuille de style CSS correspondant aux couleurs INRAE, un fichier HTML permettant d'insérer le logo bloc-état sur chaque slide via du JavaScript et un logo INRAE blanc (issu de la charte graphique INRAE).
L'utilisateur pourra choisir d'utiliser `chrome_print` au moment de la compilation pour obtenir un fichier PDF en plus de la sortie HTML.
Voici un exemple de présentation :
![](man/figures/cap_remark.png)
### Présentation éditable (Powerpoint)
Ce septième template permet de produire un une présentation au format PowerPoint
Ce template est accessible via `File > New File > Rmarkdown > From Template`.
Le template Rmd est livré avec un template au format .pptx, à modifier selon les préférences de l'utilisateur.
Voici un exemple de présentation :
![](man/figures/cap_pwp.png)
### Présentation beamer (LaTeX)
Ce huitième template est une autre exception puisqu'il s'agit d'un template LaTeX (et non Rmarkdown). Une maîtrise de LaTeX est donc requise pour l'utilisation de ce modèle.
> **Note : Ce modèle a été développé par E. Quinton (INRAE/EABX).**
Puisque ce template nécessite un grand nombre de fichiers pour fonctionner (images, page de garde, etc.) et n'est pas un template Rmarkdown, celui-ci ne peut être proposé via un addin Rstudio. Mais son utilisation reste simple, puisqu'il suffit juste de lancer la commande :
```{r eval = FALSE}
latex_presentation("Ma_Presentation")
```
Pour créer un répertoire contenant le template prêt à l'emploi. Le fichier principal du template (`modele_beamer_inrae.tex`) sera automatiquement ouvert sur Rstudio.
Voici un exemple de rapport :
![](man/figures/cap_beamer.png)
# Autres ressources
- Le package [{pagedreport}](https://github.com/rfortherestofus/pagedreport) propose un ensemble de templates de rapport paginés (pagedown) avec une customisation simple via le YAML. Vous pouvez tout à fait combiner ces templates aux couleurs / images utilisés dans InraeThemes.
<!-- README.md is generated from README.Rmd. Please edit that file -->
# InraeThemes <img src='man/figures/logo_hex.png' align="right" height="139" />
# InraeThemes <img src="man/figures/logo_hex.png" align="right" height="139"/>
<!-- badges: start -->
[![Lifecycle:
experimental](https://img.shields.io/badge/lifecycle-experimental-orange.svg)](https://www.tidyverse.org/lifecycle/#experimental)
<!-- badges: end -->
InraeThemes est un package proposant une variété de templates
(Rmarkdown), de thèmes (ggplot) et de fonctions utilitaires qui
(Rmarkdown/LaTeX), de thèmes (ggplot) et de fonctions utilitaires qui
respectent la charte graphique INRAE.
**Attention : Ces modèles nécessitent l’installation de 2 polices
......@@ -150,19 +151,22 @@ certain nombre de conseils proposés par les auteurs de ce package.
# Templates de documents/présentations
Ce package permet enfin de rédiger des rapports et/ou présentations
pré-formatés selon la charte graphique INRAE via un plugin RStudio. Les
modèles sont accessibles via `File > New File > Rmarkdown > From
Template`.
pré-formatés selon la charte graphique INRAE.
> **Attention, ces fonctions ne visent qu’à fournir des templates (css,
> LaTeX, docx, logos) correspondants à la charte INRAE, associés à des
> fichiers Rmarkdown avec un YAML correctement configuré. Nous invitons
> les utilisateurs à se renseigner par la suite sur chacune des
> technologies utilisées (rmarkdown, LaTeX, pagedown, officedown,
> revaljs, remarkjs, etc.) pour aller plus loin dans la personnalisation
> des documents.**
## Rapports
**Attention, ces fonctions ne visent qu’à fournir des templates (css,
LaTeX, docx, logos) correspondants à la charte INRAE, associés à des
fichiers Rmarkdown avec un YAML correctement configuré. Nous invitons
les utilisateurs à se renseigner par la suite sur chacune des
technologies utilisées (rmarkdown, LaTeX, pagedown, officedown, revaljs,
remarkjs, etc.) pour aller plus loin dans la personnalisation des
documents.**
Différents templates sont proposés en fonction de la longueur du rapport
et du format de sortie désiré (pdf, docx, html).
## Rapport (court) INRAE Pagedown
### Rapport paginé (Pagedown)
Ce premier template permet de produire un rapport HTML et/ou PDF (au
choix) en utilisant le package {pagedown}. Ce format est dédié à la
......@@ -179,13 +183,15 @@ entièrement personnalisable via l’utilisation de code HTML/CSS. Pour
plus d’informations : [Visitez le site de
{pagedown}](https://pagedown.rbind.io/).
Ce template est accessible via `File > New File > Rmarkdown > From
Template`.
Le template .Rmd est livré avec une feuille de style .css correspondant
aux couleurs INRAE ainsi que différents éléments graphiques (logo,
première/dernière page, etc.). Un template au format .svg est également
livré afin d’éditer les premières/dernières pages, par exemple pour
modifier l’image de fond ou pour écrire directement les informations du
rapport (dans le cas par exemple d’un titre trop long, d’un sous-titre,
etc.).
livré afin d’éditer les premières/dernières pages, pour modifier par
exemple l’image de fond ou pour écrire directement les informations du
rapport (ex: titre trop long, ajout d’un sous-titre, de logos, etc.).
L’utilisateur pourra choisir d’utiliser `chrome_print` dans le YAML au
moment de la compilation pour obtenir un fichier PDF en plus de la
......@@ -195,13 +201,13 @@ Voici un exemple de rapport :
![](man/figures/cap_rapport.png)
## Rapport (long) INRAE
### Rapport fragmenté (Bookdown)
Ce second template permet de produire un rapport HTML et/ou PDF (au
choix) en utilisant le package {bookdown}. Ce format est dédié à la
rédaction document longs et complexes (i.e livres, thèses, etc.) car il
permet une gestion modulaire des chapitres, notamment en ce qui concerne
la bibliographie.
permet une gestion modulaire des chapitres en fragmentant le rapport en
plusieurs sous-documents.
{bookdown} est un package principalement dédié, tel que son nom
l’indique, à la rédaction de livres. Contrairement au format
......@@ -210,7 +216,7 @@ plus d’informations : [Visitez le site de
{bookdown}](https://bookdown.org/).
Comme il s’agit d’un format particulier, constitué d’un grand nombre de
fichiers, celui-ci ne peut être proposé comme template Rstudio. Mais son
fichiers, celui-ci ne peut être proposé via un addin Rstudio. Mais son
utilisation reste simple, puisqu’il suffit juste de lancer la commande :
``` r
......@@ -221,14 +227,28 @@ Pour que le dossier avec l’ensemble des fichiers soit créé à l’endroit
de votre choix. Le répertoire de travail est automatiquement modifié et
le fichier “index.Rmd” automatiquement ouvert.
> Note : Pour une manipulation plus simple du document via des
> fonctionnalités Rstudio (notamment le widget “Build Book” qui s’avère
> très pratique). Nous vous recommandons de créer un projet bookdown
> vierge via les templates de projet Rstudio, puis de copier/remplacer
> les fichiers `bloc_etat.png`, `index.Rmd` et `styles.css` créés par
> cette fonction, que vous pouvez aller directement récupérer dans les
> fichiers internes du package à l’adresse renvoyée par
> `system.file("Bookdown_Inrae", package = "InraeThemes")`.
Voici un exemple de rapport :
![](man/figures/cap_book.png)
## Rapport Word INRAE
### Rapport éditable (Word)
Ce troisième template permet de produire un rapport au format Microsoft
Word (.docx).
Word (.docx). Il fait appel aux packages
[{officer}](https://cran.r-project.org/package=officer) et
[{officedown}](https://github.com/davidgohel/officedown).
Ce template est accessible via `File > New File > Rmarkdown > From
Template`.
Le template Rmd est livré avec un template au format .docx, à modifier
selon les préférences de l’utilisateur, et un logo bloc-état.
......@@ -237,30 +257,121 @@ Voici un exemple de rapport :
![](man/figures/cap_word.png)
## Présentation INRAE RevealJS
### Rapport statique (LaTeX)
Ce quatrième template est une exception puisqu’il s’agit d’un template
LaTeX (et non Rmarkdown). Une maîtrise de LaTeX est donc requise pour
l’utilisation de ce modèle.
> **Note : Ce modèle a été développé par E. Quinton (INRAE/EABX).**
Puisque ce template nécessite un grand nombre de fichiers pour
fonctionner (images, page de garde, etc.) et n’est pas un template
Rmarkdown, celui-ci ne peut être proposé via un addin Rstudio. Mais son
utilisation reste simple, puisqu’il suffit juste de lancer la commande :
``` r
latex_report("Mon_Rapport")
```
Pour créer un répertoire contenant le template prêt à l’emploi. Le
fichier principal du template (`document_inrae.tex`) sera
automatiquement ouvert sur Rstudio.
Voici un exemple de rapport :
![](man/figures/cap_latex.png)
Ce quatrième template permet de produire une présentation HTML utilisant
la technologie RevealJS (présentations web construites en 2 niveaux :
## Présentations
### Présentation dynamique 2D (RevealJS)
Ce cinquième template permet de produire une présentation HTML utilisant
la technologie RevealJS. La présentation est construites en 2 niveaux :
les titres de premiers niveau définissent la dimension horizontale
tandis que les titres de second niveau (et plus) définissent la
dimension verticale. Chaque titre correspond à une diapositive).
dimension verticale. Chaque titre correspond à une diapositive.
Ce template est accessible via `File > New File > Rmarkdown > From
Template`.
Le template Rmd est livré avec une feuille de style CSS correspondant
aux couleurs INRAE et d’un logo bloc-etat.
aux couleurs INRAE et un logo bloc-etat.
L’utilisateur pourra choisir d’utiliser `chrome_print` au moment de la
compilation pour obtenir un fichier PDF en plus de la sortie HTML (Mais
déconseillé, privilégier RemarkJS pour la sortie PDF).
Voici un exemple de présentation :
![](man/figures/cap_reveal.png)
## Présentation INRAE RemarkJS
### Présentation statique (RemarkJS)
Ce cinquième template permet de produire une présentation HTML/PDF
Ce sixième template permet de produire une présentation HTML/PDF
utilisant la technologie RemarkJS du package
{[xaringan](https://github.com/yihui/xaringan)}.
Ce template est accessible via `File > New File > Rmarkdown > From
Template`.
Le template Rmd est livré avec une feuille de style CSS correspondant
aux couleurs INRAE, un fichier HTML permettant d’insérer le logo
bloc-état sur chaque slide via du JavaScript et un logo INRAE blanc
(issu de la charte graphique INRAE). L’utilisateur pourra choisir
d’utiliser `chrome_print` au moment de la compilation pour obtenir un
fichier PDF en plus de la sortie HTML.
(issu de la charte graphique INRAE).
L’utilisateur pourra choisir d’utiliser `chrome_print` au moment de la
compilation pour obtenir un fichier PDF en plus de la sortie HTML.
Voici un exemple de présentation :
![](man/figures/cap_remark.png)
### Présentation éditable (Powerpoint)
Ce septième template permet de produire un une présentation au format
PowerPoint
Ce template est accessible via `File > New File > Rmarkdown > From
Template`.
Le template Rmd est livré avec un template au format .pptx, à modifier
selon les préférences de l’utilisateur.
Voici un exemple de présentation :
![](man/figures/cap_pwp.png)
### Présentation beamer (LaTeX)
Ce huitième template est une autre exception puisqu’il s’agit d’un
template LaTeX (et non Rmarkdown). Une maîtrise de LaTeX est donc
requise pour l’utilisation de ce modèle.
> **Note : Ce modèle a été développé par E. Quinton (INRAE/EABX).**
Puisque ce template nécessite un grand nombre de fichiers pour
fonctionner (images, page de garde, etc.) et n’est pas un template
Rmarkdown, celui-ci ne peut être proposé via un addin Rstudio. Mais son
utilisation reste simple, puisqu’il suffit juste de lancer la commande :
``` r
latex_presentation("Ma_Presentation")
```
Pour créer un répertoire contenant le template prêt à l’emploi. Le
fichier principal du template (`modele_beamer_inrae.tex`) sera
automatiquement ouvert sur Rstudio.
Voici un exemple de rapport :
![](man/figures/cap_beamer.png)
# Autres ressources
- Le package
[{pagedreport}](https://github.com/rfortherestofus/pagedreport)
propose un ensemble de templates de rapport paginés (pagedown) avec
une customisation simple via le YAML. Vous pouvez tout à fait
combiner ces templates aux couleurs / images utilisés dans
InraeThemes.
---
title: |
![](styles/bloc_etat.png){width=2in}
Titre de la présentation
date: "`r Sys.Date()` | Unité de recherche"
author: "Auteur"
output:
officedown::rdocx_document:
reference_docx: styles/template.docx
---
```{r setup, include=FALSE}
knitr::opts_chunk$set(
echo = FALSE,
fig.cap = TRUE,
message = FALSE,
warning = FALSE,
dpi = 300,
out.width = 2100
)
library(officedown)
library(officer)
```
![]()
\newpage
## Sommaire
<!---BLOCK_TOC--->
## Liste des Figures
<!---BLOCK_TOC{seq_id: 'fig'}--->
## Liste des Tables
<!---BLOCK_TOC{seq_id: 'tab'}--->
```{r packages}
library(InraeThemes)
library(dplyr)
library(ggplot2)
library(gridExtra)
```
# A Propos
Ce document est un rapport au format {officedown} généré par le package {InraeThemes}.
Il consiste en un fichier Rmarkdown (.Rmd) associé à un template au format .docx
Vous êtes libres de personnaliser le template de ce modèle à vos goûts (cf. documentation [officedown](https://github.com/davidgohel/officedown) & [officer](https://davidgohel.github.io/officer/)) et vos suggestions sont les bienvenues sur le [Github InraeThemes](https://github.com/davidcarayon/InraeThemes/issues) !
# Tableaux {-}
`Vestibulum` imperdiet, ex vel sodales facilisis, nibh tellus imperdiet massa, sit amet scelerisque orci velit vel tellus. Ut consequat justo tincidunt porttitor varius. Suspendisse erat ipsum, feugiat vitae rhoncus non, molestie ac purus. Morbi aliquet, elit eget blandit suscipit, est lacus facilisis turpis, nec fermentum nunc felis et lorem.
::: {#Table1}
Exemple de tableau :
:::
```{r}
pt <- prop_table(
style = "Plain Table 1",
layout = table_layout(type = "fixed"),
colwidths = table_colwidths(widths = rep(0.9, ncol(iris))),
tcf = table_conditional_formatting(first_row = TRUE, no_vband = TRUE),
align = "center"
)
block_table(head(iris), header = TRUE, properties = pt)
```
## Equations {-}
> Bloc de citation
Les formules LaTeX peuvent être utilisés au sein d'un paragraphe : $E=mc^2$ ou en tant qu'équation sur une ligne seule :
::: {#eq1}
:::
$$f=\frac{a}{b+c}$$
Ligne verticale :
----
Cras pulvinar ligula ac nisi porttitor, volutpat congue orci tincidunt. Pellentesque non mi congue, porta enim eget, venenatis sem. Integer suscipit vulputate tellus, eget commodo dolor gravida vel. Suspendisse gravida gravida ligula, in interdum sapien molestie ut.
### Graphiques {-}
Cf. [table](#Table1) ci-dessus.