Le short code includes de Quarto

Avec le short code includes de Quarto, l'écriture d'un long document peut facilement être découpée en plusieurs documents plus petits.

includes découpe un document en morceaux fixes. Quand la partie répétée est la même structure remplie avec des valeurs différentes, Utiliser le templating Mustache avec Quarto et Utiliser des variables depuis un fichier externe dans votre projet Quarto sont les bons outils.

Imaginez le fichier main.qmd suivant :

# My thesis in Latin

{{< include chapter1.md >}}?

{{< include chapter2.md >}}?

Quarto va alors fusionner les trois fichiers quand vous faites le rendu de main.qmd.

Le tag includes​

Le tag est simple, il suffit d'indiquer le chemin relatif du fichier à inclure. Pour la syntaxe détaillée, voyez la documentation officielle.

Résultat​

Lancer quarto render main.qmd --to html sur le fichier main.qmd montré ci-dessus fusionne les fichiers inclus en un seul document :

Voici ce que contient réellement chaque fichier inclus.

Voici un contenu bidon pour chapter1.md :

## Chapter 1

Voluptatem minus labore architecto sed voluptas molestiae perferendis. Sed voluptatem ut amet at blanditiis sunt et exercitationem quidem. Vel id impedit dicta omnis repudiandae iure.

Expedita magni facere. Ullam non non sint qui provident. Ea beatae voluptatem pariatur. Et beatae error ea aut neque omnis pariatur rerum ut.

Ad aut nobis magni aut est dicta adipisci est. Quo reiciendis eum aut rem. Dolores sit magni non.

Et pour chapter2.md :

## Chapter 2

Iure repudiandae perferendis maiores dolorem consequuntur exercitationem suscipit.

Animi voluptatem est quia. Quia id optio. Architecto ut ipsa voluptas minima voluptate accusamus architecto.

Consequatur debitis et sunt eos quod qui unde aut.

Maintenant, en lançant par exemple quarto render main.qmd --to html, Quarto va fusionner ces deux fichiers (et main.qmd) dans la page rendue montrée ci-dessus.