Rendre un document en un clic (rendu flash)
flash-render.Rmdrender_flash() rend un seul document —
celui actif dans l’éditeur RStudio — comme un mini-site Quarto autonome,
sans toucher au reste du dépôt. Ce vignette se concentre sur son usage
normal : l’addin RStudio Rendre (flash).
Pourquoi c’est utile
Beaucoup de documents ne font pas partie d’un site Quarto structuré :
des slides ponctuelles, une note de travail, un .qmd isolé
dans un dossier de recherche (PolMo/Presentation/, par
exemple). Pour ces cas-là, pas besoin de setup_site() ni de
_quarto.yml : l’addin prend le document ouvert, l’isole
dans un dossier temporaire, le rend seul (même si d’autres
.qmd/.md traînent dans le même dossier), et
ouvre un aperçu local immédiatement.
C’est la première étape du trio d’addins Rendre → Publier /
Déployer (flash) : une fois le rendu validé dans l’aperçu, le
même document peut être mis en ligne sur staging.ofce.fr en
un clic supplémentaire (voir publish_flash_addin() /
deploy_flash_addin()). C’est une mise en ligne protégée par
un mot de passe qui n’a pas vocation à être publique. Les mises en ligne
publiques doivent être validées.
Comment l’utiliser
- Ouvrir le
.qmdà rendre dans l’éditeur RStudio, pour qu’il soit le document actif dans la partie éditeur de texte (généralement à gauche). - Menu Addins → Rendre (flash) (ou taper “Rendre (flash)” dans la palette de commandes, Ctrl/Cmd+Shift+P). Pour publier plutôt que seulement faire le rendu Menu Addins → Rendre (flash). Pour déployer sans refaire le rendu Menu Addins → Déployer (flash).
- Le rendu se déroule dans la console ; un aperçu s’ouvre automatiquement dans l’onglet Viewer à la fin.
Le résultat est écrit dans _site/ à côté du document —
pas ailleurs dans le dépôt.
Choix du document rendu
Le document actif est explicitement passé à
render_flash() par l’addin, donc aucune ambiguïté ne se
pose en usage normal. En dehors de l’addin (par exemple via la console),
si aucun index n’est fourni, render_flash()
cherche index.qmd/index.md dans le dossier,
sinon retient le .qmd/.md le plus récemment
modifié — un message signale son choix.
Utilisation programmatique (secondaire)
L’addin appelle simplement render_flash(). Il est
possible de l’invoquer directement depuis la console — utile pour
automatiser un lot de rendus, ou dans un script :
library(ofceweb)
render_flash(
path = "PolMo/Presentation",
index = "Presentation_Polmo.qmd", # optionnel si sans ambiguïté
preview = TRUE,
as_job = FALSE
)Pré-requis
render_flash() ne nécessite ni PAT GitHub ni
gh — ces identifiants ne servent qu’à la
publication/déploiement (publish_flash() /
deploy_flash()), pas au rendu seul. Il suffit :
- d’être dans un dossier situé à l’intérieur d’un dépôt
git (utilisé pour calculer le
sluget localiser d’éventuels_extensions/partagés) ; - que le dossier soit raisonnablement autonome : les
chemins relatifs qui remontent en dehors (
../figures/x.png,../../biblio.bib) ne se résoudront pas, puisque seul ce dossier (et les_extensions/trouvées) est copié dans le répertoire temporaire de rendu. Si ce n’est pas le cas, le rendu échouera.
Si un _quarto.yml existe déjà dans le dossier, il est
ignoré volontairement : le rendu flash cible un seul
document, pas un projet multi-pages — pour ça, voir
setup_site() / setup_wp().
Pour aller jusqu’à la mise en ligne
(publish_flash_addin() /
deploy_flash_addin()), un PAT GitHub et gh
authentifié sont nécessaires — voir Pré-requis : PAT GitHub, gh CLI, variables
d’environnement.