Rend le blog bilingue
render_blog.RdOrchestre un build complet du blog Quarto en français et en anglais. Reconstruit la base des posts, rend chaque version de langue en parallèle, met à jour l'index de recherche Algolia et le sitemap, patche les hash CSS Bootstrap, commite les changements de cache dans git et, en option, déploie le site ou lance un serveur de prévisualisation local.
Usage
render_blog(
path = ".",
force_freeze = FALSE,
workers = 8L,
check_repo = TRUE,
progress = TRUE,
render_site = TRUE,
check_freeze = FALSE,
site2branch = FALSE,
trigger = site2branch,
freeze = TRUE,
notify = site2branch
)Arguments
- path
Chemin vers le dossier du blog. Défaut `"."`.
- force_freeze
Logique. Si `TRUE` (défaut), les posts sont re-rendus même si une version en cache existe. Mettre `FALSE` pour réutiliser le cache autant que possible.
- workers
Entier. Nombre de workers parallèles transmis à [future.mirai::mirai_multisession()]. Défaut `8L`.
- check_repo
Logique. Si `TRUE` (défaut), appelle [check_repo_status()] avant le rendu pour s'assurer que le dépôt git est dans un état propre.
- progress
Logique. Si `TRUE` (défaut), des barres de progression sont affichées pendant les étapes longues.
- render_site
Logique. Si `TRUE` (défaut), démarre un démon HTTP local via [servr::httw()] pour prévisualiser `_site` une fois le build terminé.
- check_freeze
Logique. Si `TRUE`, la fonction s'arrête dès qu'un post est absent du cache (mode freeze strict). Défaut `FALSE`.
- site2branch
Logique. Paramètre réservé (actuellement inutilisé dans le corps de la fonction ; le déploiement est contrôlé par la variable d'environnement `push_site_deploy`). Défaut `FALSE`.
- trigger
Logique. Transmis à [site2branch()] pour déclencher en option un workflow GitHub Actions après le déploiement. Défaut `FALSE`.
- freeze
Logique. Si `TRUE` (défaut), transmis à [copy_files()] pour activer le mode freeze de Quarto lors de la copie de l'ossature du projet.
- notify
Logique. Si `TRUE`, après le déploiement, envoie un mail pour chaque nouveau billet via [notify_new_posts()] (destinataires dans `_notify.yml`, SMTP dans les variables `OFCE_SMTP_*`). Défaut `site2branch` : les mails ne partent que si le site est publié.
Value
Un data frame des changements git préparés (sortie de [gert::git_status()]), renvoyé invisiblement.
Details
La fonction doit être exécutée depuis un projet RStudio contenant un répertoire `posts/`. Elle s'attend aussi à ce que le projet se trouve dans un répertoire nommé `webblog` et demande confirmation dans le cas contraire.
Deux variables sont lues depuis l'environnement appelant (pas des arguments de la fonction) : - `typst` : transmise à [copy_post()] pour contrôler le rendu PDF Typst. - `push_site_deploy` : si `TRUE`, appelle [site2branch()] pour pousser `_site` vers la branche de déploiement ; sinon affiche les instructions pour le faire manuellement.