Skip to content

DRY output format

Lino Galiana requested to merge dry-output-format into master

En commençant à travailler sur le support pour les packages, j'ai trouvé que la gestion de l'output format des documents n'était pas très DRY:

  • il faut faire attention de bien réutiliser les mêmes options dans l'entête YAML, ce qui n'est pas très pratique si on veut les modifier ultérieurement (tous les fichiers Rmd seraient à modifier).

  • quand j'ai commencé à utiliser le script de source/output folding, j'ai trouvé que c'était galère de mettre les balises ouvrantes et fermantes pour les divs.

  • enfin, j'ai noté que la gestion de la feuille de style CSS et du fichier JS ne permettait pas de travailler avec self_contained = FALSE.

Au travers de cette PR, je te propose de gérer tout ça en utilisant un output format unique pour tous les fichiers Rmd. Comme ça, si tu veux modifier une option ultérieurement, il n'y aura qu'un endroit à modifier. Tout est dans le .Rprofile.

Pour la fonctionnalité de source/output folding, j'ai créé une option fold pour les chunks. Il suffit d'écrire fold="s" ou fold="s o", plus besoin de mettre des divs, ils sont insérés automatiquement.

Le seul point un peu embêtant est lié à la structure du repo. Comme les fichiers Rmd sont dans des répertoires différents, il y a une petite option à modifier lorsqu'on travaille dans RStudio sur un fichier Rmd. J'ai expliqué cela dans le README. Cette manipulation n'est qu'à faire une fois.

Merge request reports