Tutoriel : personnalisez les rendus Word de R markdown

J’utilise quotidiennement le format R markdown, notamment pour réaliser des comptes rendus d’analyses statistiques.

J’utilise le rendu html pour construire le document – je le knit régulièrement pour vérifier que la sortie est bien conforme à mes attentes, c’est-à-dire que ce qui est affiché correspond bien à ce que je souhaite faire apparaître.

J’utilise ensuite un rendu Word, pour transmettre à mes clients, mes étudiants ou mes collaborateurs, une première version de mon travail.

J’aime bien ce format parce qu’il est facile à commenter et que de nouveaux éléments (images, paragraphe, etc…) peuvent facilement être ajoutés par tout le monde (il suffit simplement de savoir utiliser Word).

Enfin, j’utilise le rendu pdf comme version finale de mon travail.

C’est déjà génial de pouvoir générer un document Word à partir d’un document R markdown ! Mais au fil du temps, j’ai eu envie de l’améliorer pour obtenir un rendu plus personnel.

J’ai alors écrit un court tutoriel pour vous montrer comment le faire, en pas à pas.

1. Pré requis

Pour bien comprendre cet article, dédié à la personnalisation de documents Word générés à partir de R markdown,  il est nécessaire de savoir :

2.Tutoriel : personnalisez vos rendus Word

Le principe de cette amélioration des rendus Word, consiste à :

  1. Créer un document Word avec les styles que vous souhaitez appliquer à vos rendus Word,
  2. Inclure ce document Word dans l’entête du fichier Rmd, dans la partie consacrée au rendu Word.

2.1 Ouvrir un nouveau document.Rmd :

Dans votre projet R : File –> New File –> Rmarkdown

nouveau document r markdown

 

2.2 Enregistrez le dans le projet R

File –> Save as.

Donnez lui n’importe quel nom, “test_word” par exemple.

 

2.3 Knitez “test_word.rmd” en word

knit word

 

Voici le rendu  :

rendu word de R markdown

 

 

2.4. Renommez ce document

Enregistrez le document, dans le même répertoire que votre document .Rmd dont vous voulez améliorer le rendu Word, en le nommant “word_styles_references.docx”, par exemple.

2.5. Modifiez les éléments de style de ce document “word_styles_references.docx”

Par exemple :

  • Sélectionnez le titre
  • Passez le en taille 36, en majuscule, en couleur rouge, et en police Trebuchet MS
  • Ouvrez le menu des Styles

style word

 

  • Repérez le style de l’élément modifié dans la liste (il suffit de faire dérouler).
  • Choisissez Mettre à jour pour correspondre à la sélection.

 

menu style modifier

 

  • Recommencez avec un autre élément

 

Au final vous pourriez obtenir ceci par exemple :

modification des style word pour rmardown

  • Enregistrez le document (sans modifier le nom)

 

2.6 Ajouter ce document Word dans votre Rmd

Il s’agit d’ajouter l’option reference_docx: word_styles_references.docx dans l’en-tête du document rmd que vous souhaitez kniter en Word :

en-tête rmarkdown

 

2.7 Knitez en Word votre document rmd

Les styles du document que vous avez créé seront automatiquement appliqués au rendu word. Voici un exemple :

rendu word personnalisé

 

3. Conclusion

J’espère que ce court tutoriel vous permettra d’améliorer facilement vos rendus Word afin qu’ils correspondent davantage à vos besoins.

Si nécessaire, vous trouverez des informations complémentaires ici, et là.

En attendant, si cet article vous a plus, n’oubliez pas de le partager 😉

 

Crédits photos : Image par SnapwireSnaps de Pixabay
 

 

Prolongez votre lecture avec d’autres articles “astuces” : 

Calculer et rapporter les odds ratio sans se fatiguer !

Faites de belles tables descriptives avec summarytools !

Nombre de décimales, notation scientifique et arrondis avec R

Partager l'article
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  
  •  

4 commentaires

  1. GISELE MBUYI Répondre

    Merci du tutoriel.
    Mais je n’arrive pas à obtenir le fichier word avec les rendus que je souhaite, j’ai pourtant scrupuleusement suivis les étapes. Voici le message sur la console (plus bas)

    |……… | 14%
    ordinary text without R code

    |………………. | 29%
    label: setup (with options)
    List of 1
    $ include:

    processing file: test_word.Rmd
    logi FALSE

    |………………………. | 43%
    ordinary text without R code

    |………………………………. | 57%
    label: cars
    |………………………………………. | 71%
    ordinary text without R code

    |……………………………………………….. | 86%
    label: pressure (with options)
    List of 1
    $ echo: logi FALSE

    |………………………………………………………..| 100%
    ordinary text without R code

    “C:/Program Files/RStudio/bin/pandoc/pandoc” +RTS -K512m -RTS test_word.utf8.md –to docx –from markdown+autolink_bare_uris+tex_math_single_backslash+smart –output test_word.docx –highlight-style tango –lua-filter “C:/Users/HP/Documents/R/win-library/3.6/rmarkdown/rmd/lua/pagebreak.lua”
    output file: test_word.knit.md

    Output created: test_word.docx

    • Claire Della Vedova Auteur de l’articleRépondre

      Bonjour,

      je ne vois pas de message d’erreur dans le code !

  2. Dany OTRON Répondre

    Bonsoir Claire,
    Merci encore pour cet article qui viennent renforcer nos connaissances

Laisser un commentaire

Votre adresse de messagerie ne sera pas publiée. Les champs obligatoires sont indiqués avec *