docquarto.qmd

---
title: "Produire des documents avec Quarto"
author: "Xavier Timbeau"
format: 
  revealjs:
    theme: simple
    logo: ofce.png
    footer: "quarto"
editor: visual
---

## Produire des graphiques

En utilisant `{ggplot2}`, on a vu comment produire des graphiques

le package `{ofce}` permet de les mettre en forme

::: columns
::: {.column width="70%"}
```{r}
library(tidyverse)
library(ofce)
data <- ofce::sna_get("prc_hicp_midx") |> 
  filter(unit=="I15", coicop=="CP00", geo=="FR")
gg <- (ggplot(data)+geom_line(aes(x=time, y=values))+
  xlab(NULL)+ylab(NULL)+
  labs(title="FRANCE, Indice des prix à la consommation")+
  theme_ofce(base_family = "sans") )
gg |> 
  add_label_unit("en 2015") |> 
  add_logo_ofce()
```
:::

::: {.column width="30%"}
![](images/paste-5C081886.png){width="370"}
:::
:::

## avec des graphiques interactifs {transition="fade" transition-speed="slow"}

```{r}
plotly::ggplotly(gg)
```

## le package `{ofce}` {.smaller}

::: incremental
-   des palettes de couleur

    -   *designed by Paul Malliet*

-   fonctions pour enregistrer les graphiques au format svg ou png

    -   en résolvant la taille des polices de caractère,

-   des fonctions pour accéder à eurostat facilement,

    -   demain aux données de l'OCDE ou d'eikon

-   pour l'installer `devtools::install_github("ofce/ofce")`(penser à le faire souvent pour les MAJ)

-   maintenu par XT, PM, MD, AS
:::

## Quarto

Quarto est un ensemble de fonctions qui permettent:

-   éditer un document en markdown (HTML simplifié)

-   avec des équations (latex)

-   ajouter du code (R, phython, Julia) dans des `code chunks`

-   intégrer des graphiques ou des tableaux

-   intégrer des éléments plus complexes

-   et des documents structurés (livre avec chapitres)

## Des éléments complexes

-   une table des matières, des figures, des tableaux

-   des références bibliographiques

-   des références croisées (lien vers une section, un autre document)

-   des morceaux de document avec\
    `{{< include xxx.qmd >}}`

## Des `render` vers de nombreux formats

-   HTML ; pdf (latex) ; latex ; word ; powerpoint (non pas Excel)

-   revealjs (pour une présentation, comme ici), beamer, pptx

-   un blog (ou un site web complet)

-   Le même document `.qmd` génère les différents formats

    Le `yaml` du document en précise les options:

    ![](images/paste-BD12C090.png){width="519"}

## Le `.qmd` est un fichier texte

-   Il peut être édité par différents programmes dont RStudio

    -   mode `visual`, où l'on prévisualise l'aspect, les équations et où on peut coller des images provenant de n'importe où. (des copies d'écran comme ici, mais aussi des graphiques excel).

## Le `.qmd` est un fichier texte

-   Il peut être mis sur github pour travailler à plusieurs sur un même fichier

    -   avec la gestion des conflits, le retour en arrière et le versionning

        ![](images/paste-DC991B9B.png){width="474"}

    -   les images sont dans un dossier à part

## Les sorties peuvent être préformatées

-   pdf/Latex

    -   modèle de document ou préambule latex, assurant une mise en page automatique

    -   on peut ajouter des balises latex pour des détails

-   HTML

    -   thème

-   Word

    -   feuilles de style

## Quelques exemples de workflow : SIWU {.smaller}

-   Du code R avec des données téléchargées, traitées

-   Des graphiques produits avec `ggplot2`, des tableaux avec `gt`

-   un travail collaboratif avec François G. et Guillaume A. avec `github`

-   différentes sorties :

    -   un post en html

    -   un document en pdf, mis à jour chaque mois

    -   un site intégrant du shiny (en construction)

-   Une seule source pour les graphiques et le texte

## Ce qui donne

[lien vers le pdf de](SIWU_brief.pdf) [SIWU](SIWU_brief.pdf)

ou

[lien vers SIWU en HTML](SIWU_brief.html)

## Quelques exemples de workflow : MEAPS {.smaller}

-   Du code R avec des calculs

    -   plusieurs collaborateurs (dont Maxime P.)

-   Un document complexe avec équations, ref croisées, biblio

-   Différentes sorties :

    -   Des graphiques

    -   Des données

    -   un pdf/word à la demande

    -   des présentations

## Le futur workflow de l'OFCE

![](images/paste-B179573D.png)

## Quarto et Posit {.smaller}

-   RStudio devient Posit, pour marquer que ce n'est pas spécialisé à R

-   Quarto va pouvoir s'utiliser dans une grande variété d'éditeurs/environnement

-   il reste quelques bugs dans RStudio, mais c'est utilisable

-   Anissa S. et quelques autres développent en ce moment même des templates

-   [La documentation complète de Quarto](https://quarto.org/docs/guide/)

![quarto est le format d'impression d'un petit livre au début de l'imprimerie](http://j387mediahistory.weebly.com/uploads/6/4/2/2/6422481/quarto2.jpg){fig-align="center" width="210"}