# Mes extensions Quarto préférées > Mes extensions Quarto préférées - Découvrez les filtres Quarto essentiels pour le templating de contenu partiel, les icônes Font Awesome, l'inclusion de fichiers de code externes et de simples macros de recherche-remplacement pour améliorer votre workflow de documentation. ---  **TL;DR** Cet article partage une liste choisie des extensions Quarto préférées de l'auteur pour améliorer votre workflow de documentation. Découvrez des filtres utiles pour le templating de contenu avec `quarto-partials`, l'intégration d'icônes avec `fontawesome`, l'inclusion de snippets de code externes, la création de simples macros de remplacement de texte avec `search-replace` et l'amélioration de la lisibilité des blocs de code dans les présentations reveal.js avec `code-fullscreen`. J'utilise Quarto depuis 18 mois pour générer ma documentation : j'écris des fichiers Markdown (`.md`) et je les convertis en document Word, en PDF, en site HTML statique ou en [diaporama revealjs](/blog/quarto-revealjs-tips). *Si Quarto est nouveau pour vous, [Running Quarto Markdown in Docker](/blog/docker-quarto) vous donne une installation fonctionnelle en quelques minutes.* Quarto prend en charge des extensions externes (aussi appelées `plugins` ailleurs). Voici une liste de quelques-unes que j'utilise. ## gadenbuie/quarto-partials : du contenu partiel réutilisable {#gadenbuiequarto-partials} Voir Quand j'en suis arrivé à cette extension, mon besoin était le suivant : j'avais codé plus de 60 fonctionnalités et je devais les documenter. Chacune aura le même look\&feel, avec un chapitre *Description*, un *Comment l'exécuter ?*, *Comment la configurer ?*, *Remarques* et ainsi de suite. Parfois le texte sera exactement le même (comme un texte générique) et, dans certains cas, presque le même : le chapitre *Comment la configurer ?* aura les mêmes phrases, sauf que je dois remplacer quelques placeholders (comme le nom de la fonctionnalité, le nom du fichier de configuration, ...) Autrement dit : je dois pouvoir écrire une sorte de *template de page* et y *injecter* du contenu spécifique. Je veux que mes 60 pages de fonctionnalités se ressemblent et, si je dois changer un texte global, le faire à un seul endroit central. [Partial content](https://github.com/gadenbuie/quarto-partials/tree/main) est parfait ici. D'après leur documentation, c'est similaire à [Mustache](https://mustache.github.io/). ### Exemple {#example} Créons un fichier appelé `_hello.md` avec ce contenu : **\_hello.md** ```markdown Hello, {{ name }}! ``` Ensuite, dans n'importe quel fichier, nous pouvons faire : **test.md** ```markdown {{< partial _hello.md name="John" >}} ``` Pensez à ajouter les lignes ci-dessous dans votre front matter YAML : **test.md** ```markdown filters: - quarto-partials ``` Nous pouvons passer des variables comme ci-dessus mais, bien plus puissant, nous pouvons déclarer une clé `partial-data` dans notre frontmatter YAML. Si vous voulez aller beaucoup plus loin avec cette extension (blocs conditionnels, contenu brut, un cas d'usage réel de documentation), j'ai écrit un article dédié : [Using Mustache templating with Quarto](/blog/quarto-mustache). ## quarto-ext/fontawesome : des icônes Font Awesome {#quarto-extfontawesome} Voir Utilisez les icônes Font Awesome dans vos documents HTML et PDF. Par exemple, si vous voulez une icône GitHub, il suffit de mettre le code `{{< fa brands github size=5x >}}` dans votre fichier. Plutôt facile. Pensez à ajouter les lignes ci-dessous dans votre front matter YAML : **test.md** ```markdown filters: - fontawesome ``` ## quarto-ext/include-code-files : inclure des fichiers externes {#quarto-extinclude-code-files} > **Est-ce encore nécessaire ?:** > > Je ne suis pas sûr que cet addon soit encore nécessaire : dans une de mes documentations, je l'ai utilisé comme ceci : > > ````markdown > ```{.yaml include="files/.gitlab-ci.yml"} > ``` > ```` > > Ça fonctionnait comme prévu mais, lors de la génération d'un fichier `.docx` (MS Word), le fichier inclus était absent. > > J'ai alors utilisé le shortcode natif comme ci-dessous et, maintenant, ça marche pour `.html` comme pour `.docx`. > > ````markdown > ```yaml > {{< include files/.gitlab-ci.yml >}} > ``` > ```` Voir L'objectif est de pouvoir inclure un fichier externe en utilisant la syntaxe ci-dessous : ````markdown ```{.bash include="documentation/chapter_1/install.sh"} ``` ```` Pensez à ajouter les lignes ci-dessous dans votre front matter YAML : **test.md** ```markdown filters: - include-code-files ``` ## quarto-ext/search-replace : des macros de remplacement {#quarto-extsearch-replace} Voir Une extension de filtre Quarto pour de simples macros de recherche-remplacement. Cette extension vous permet de rechercher et remplacer lors du rendu des documents. Par exemple, en mettant le code `+quarto` dans le frontmatter de l'article ou, mieux, dans le fichier global `_quarto.yaml`, nous pouvons simplement écrire `+quarto` (une constante) dans notre document et laisser le remplacement se faire pendant le rendu de la documentation. **\_quarto.yaml** ```yaml search-replace: +quarto: "[Quarto](https://quarto.org)" ``` Pensez à ajouter les lignes ci-dessous dans votre front matter YAML : ```yaml filters: - search-replace ``` ### Exemple {#example-1} Voici comment l'utiliser. C'est simple ; écrivez juste le nom de votre constante et, pendant le rendu de votre document, la constante sera remplacée par la valeur prédéfinie. Facile ! ```markdown I'm using +quarto and I love it ``` ## shafayetShafee/code-fullscreen : du code en plein écran {#shafayetshafeecode-fullscreen} Voir Cette extension concerne les diaporamas revealjs. Si vous avez un très long bloc de code, revealjs n'affichera pas toutes les lignes et le code sera donc tronqué (seules les 25 premières lignes seront affichées, par exemple). En ajoutant le filtre ci-dessous à votre frontmatter YAML, un petit bouton *Full screen* sera affiché en haut à droite du bloc de code. **test.md** ```markdown filters: - code-fullscreen ```