Les projets Quarto pour des contenus élaborés

De R Markdown à Quarto pour aller plus loin avec ses publications

Christophe Dervieux

Posit

21 juin 2023

Projet Quarto ?

Les projets Quarto sont des répertoires qui fournissent :

• un moyen de render tout ou partie des fichiers d’un répertoire à l’aide d’une seule commande (par exemple, quarto render myproject).
• Un moyen de partager la configuration YAML entre plusieurs documents.
• La possibilité de rediriger les artefacts de sortie vers un autre répertoire.
• La possibilité de geler le rendu (c’est-à-dire de ne pas réexécuter les documents à moins qu’ils n’aient changé).

Nous avons déjà créés un projet…

Un projet, c’est un répertoire avec un _quarto.yml aussi simple soit t’il.

_quarto.yml

project:
  title: "Quarto-101"

Mais, les projets peuvent avoir des “types” spéciaux qui introduisent un comportement supplémentaire (par exemple, les sites web ou les livres).

Quarto Website

• Profondeur et organisation arbitraires du contenu
• Navigation à plusieurs niveaux (barre de navigation / barre latérale / hybride)
• Recherche en texte intégral (côté client ou Algolia)
• Gel des résultats de calcul (configuration freeze)

Quarto Website

_quarto.yml

project:
  type: website

website:
  title: "today"
  navbar:
    left:
      - href: index.qmd
        text: Home
      - about.qmd

format:
  html:
    theme: cosmo
    toc: true

Example: https://quarto.org and davantage dans la Gallerie

Quarto Blogs

• Hérite des fonctionnalités des sites Quarto (navigation, recherche, etc.)

• Liste et flux RSS générés automatiquement

• Page d’accueil personnalisable (inspiré du paquet R postcards)

index.qmd (website with posts/)

---
title: "myblog"
listing:
  contents: posts
  sort: "date desc"
  type: default
  categories: true
---

posts/first-post/index.qmd

---
title: "Post With Code"
description: "Post description"
author: "Fizz McPhee"
date: "5/22/2021"
categories:
  - news
  - code
---

Exemples: https://quarto.org/docs/blog/ et
davantage dans la Gallerie

Quarto Books

• Hérite des fonctionnalités des sites Quarto (navigation, recherche, etc.)
• Supporte les références croisées entre les chapitres
• Les formats de sortie possible sont HTML, PDF, MS Word et ePub.

Exemples: https://quarto.org/docs/gallery/#books

Quarto Books

_quarto.yml

project:
  type: book

book:
  title: "mybook"
  author: "Jane Doe"
  date: "8/18/2021"
  chapters:
    - index.qmd
    - intro.qmd
    - summary.qmd
    - references.qmd

bibliography: references.bib

format:
  html:
    theme: cosmo
  pdf:
    documentclass: scrreport
  epub:
    cover-image: cover.png

Et bien plus de nouveautés…

• Métadonnées partagées par sous dossier avec _metadata.yml
• Exécuter des scripts avant et après quarto render (Project Scripts)
• Création de listes d’articles personnalisées
• …

À vous!

10:00

Transformez votre projet en site web

1. Ajoutez un index.qmd dans votre projet existant Quarto-101
2. Modifiez le _quarto.yml pour faire un site web
3. quarto preview pour voir votre site web évoluer
4. Ajoutez la navigation pour afficher votre rapport nouveau-manchots.qmd dans un sous-menu de la navbar
5. Personnalisez votre site web!

Apprendre à naviguer dans la doc !

Aidez-vous de la documentation Quarto sur le type website pour jouer avec les options: https://quarto.org/docs/websites/

Questions ?

Passons au récap…

Next