Chapitre 4 Blogdown pour créer un site

Le test de blogdown n’a pas été concluant car nous avons constaté de nombreuses instabilités dès que l’on sort de l’exemple proposé (Xie 2017a).

4.1 Principes de blogdown

Blogdown permet de gérer un site web à partir de pages statiques en markdown ou Rmarkdown. Le package R utilise le générateur de site Hugo.

Les fichiers du site sont écrits dans le répertoire content et copiés pour devenir visible dans le répertoire public en passant par le répertoire static.

4.2 Mise en oeuvre

4.2.1 Préliminaires

4.2.1.1 Remarque MacOSX

Commencer par installer homebrew https://brew.sh

4.2.1.2 Outils de base

  • Installer une version supérieure à 1.1.350
  • Installer le package blogdown et Hugo
install.packages('blogdown')
library('blogdown')
install_hugo()

4.2.2 Créer le projet par RStudio

  • New project > New Directory > Website using blogdown
  • Ne pas décocher “install hugo automatically”

4.2.3 Créer le post _index.md

  • Le post doit être dans le répertoire principal (dégager “post”). Ce post sera la page d’accueil qui deviendra index.html dans le répertoire public

4.2.4 Visualisation du site web

  • pour visualiser le site web, nous avons utilisé la commande Server Site du menu Addins proposé par `blogdown

4.2.5 Créer des pages additionnelles

  • créer un post dans le répertoire principal
  • le nom du fichier ne doit pas comporter de majuscule
  • choisir l’extension
  • Les hyperliens classiques markdown entre fichiers fonctionnent

4.2.5.1 Exemple

Création d’un lien vers le fichier blogdown-pour-creer-un-site.Rmarkdown

[Notre expérience blogdown](blogdown-pour-creer-un-site)

4.2.6 Gestion des images

4.2.6.1 Inclusion d’une images à la taille voulue

  • les images sont stockées dans un sous répertoire du répertoire static. Dans l’exemple qui suit le répertoire des images est /static/images-markdown/
  • pour éviter les messages d’erreurs liés à l’édition du markdown, nous avons ajouté un champ resource-filesdans le YAML

4.2.6.2 Exemple

---
title: Introduction à Rmarkdown
author: ''
date: '2017-08-29'
resource_files:
  - ../static/
slug: introduction-a-rmarkdown
categories: []
tags: []
---

Les images sont alors incluses comme suit:

```{r,  out.width="50px", echo=TRUE, fig.show='hide'}
knitr::include_graphics("/images-markdown/ExempleMdFile.png", 
                          auto_pdf = TRUE, dpi = NA)
```

4.2.7 Reste à faire

  • publication en ligne
  • changement de thème ou personnalisation du thème par défaut

References

Xie, Yihui. 2017a. Blogdown: Create Blogs and Websites with R Markdown. https://github.com/rstudio/blogdown.