Prévisualise le document `.qmd` actif dans RStudio
preview_qmd.RdRécupère le chemin du document actif dans l'éditeur RStudio, vérifie qu'il s'agit d'un fichier `.qmd`, le rend via [quarto::quarto_render()] puis lance un serveur HTTP local avec [servr::httd()] positionné directement sur le fichier HTML produit.
Arguments
- profile
`[character(1)]` ou `NULL`.
Profil Quarto à utiliser pour le rendu (ex. `"staging"`, `"publish"`). Passé à [quarto::quarto_render()] et utilisé pour lire le bon `_quarto-profile.yml`. `NULL` (défaut) = rendu sans profil.- daemon
Logique. Si `TRUE` (défaut), le serveur HTTP tourne en arrière-plan sans bloquer la console.
- use_freezer
Logique (défaut `FALSE`). Passé à [quarto::quarto_render()] pour activer/désactiver l'usage du cache de type freezer lors du rendu.
- as_job
Logique (défaut `FALSE`). Passé à [quarto::quarto_render()] pour exécuter le rendu dans un RStudio Job plutôt que dans la console.
- ...
Arguments supplémentaires passés à [quarto::quarto_render()].
Details
Le répertoire servi et le chemin initial sont déduits automatiquement via [quarto::quarto_inspect()] :
`quarto inspect` est appelé sur le fichier avec le `profile` actif ; il retourne la racine du projet (`$project$dir`) et le `output-dir` résolu (`$project$config$project[["output-dir"]]`).
Si `quarto inspect` échoue (ex. type de projet non reconnu par l'installation locale), on bascule sur la lecture manuelle de `_quarto.yml` et `_quarto-profile.yml`.
Sans projet détecté ou sans `output-dir` configuré, le serveur pointe sur le dossier du `.qmd` lui-même.
Si aucun `_quarto.yml` n'existe dans l'arborescence au-dessus du fichier, un `_quarto.yml` minimal est créé temporairement dans le dossier du fichier (frontière de projet pour le CLI `quarto`, qui sinon peut remonter jusqu'à des dossiers sans rapport comme `$HOME`). Il est supprimé automatiquement à la fin de l'appel, que le rendu réussisse ou échoue.