Tutoriel : Créer son premier document Quarto en 15 minutes

Créer son premier document Quarto avec RStudio en 15 minutes

Vous souhaitez créer votre premier document Quarto avec R Studio, mais vous ne savez pas vraiment par où commencer ? Quarto permet de créer des documents qui réunissent au même endroit du texte, du code, les résultats de vos analyses, des tableaux et des graphiques, puis de les générer dans différents formats comme HTML, Word ou PDF.

C’est un outil particulièrement pratique pour créer des rapports d’analyse reproductibles avec R, mais pas seulement. Quarto permet également de réaliser des supports de cours et des TD, en associant dans un même document des explications, des exercices, du code R, des résultats et des graphiques.

Pour vous aider à démarrer avec Quarto, je vous ai préparé un tutoriel vidéo très court et accessible. En une quinzaine de  minutes, nous allons partir de zéro et créer ensemble un premier document Quarto avec RStudio. L’objectif : comprendre les grands principes de fonctionnement de Quarto et avoir toutes les bases nécessaires pour commencer ensuite à créer vos propres documents.

Créer son premier document Quarto avec RStudio

Dans ce tutoriel, nous allons créer ensemble un projet RStudio puis notre premier document Quarto. Nous verrons notamment comment :

  • créer et enregistrer un fichier Quarto .qmd ;
  • utiliser les modes Visual et Source ;
  • comprendre les principaux éléments qui composent un document Quarto ;
  • ajouter du texte et du code R ;
  • générer le document avec Render ;
  • ajouter une table des matières et numéroter automatiquement les sections ;
  • produire un document aux formats HTML, Word et PDF ;
  • installer TinyTeX pour générer des PDF. L’objectif n’est pas de découvrir toutes les possibilités de Quarto en 15 minutes, mais de comprendre son fonctionnement et de disposer des bases nécessaires pour commencer à créer vos propres documents.

Où trouver de l’aide avec Quarto ?

Quarto offre énormément de possibilités et, heureusement, il n’est pas nécessaire de connaître toutes les options ou toute la syntaxe par cœur.

La documentation officielle de Quarto  est une excellente ressource pour découvrir les différentes fonctionnalités et retrouver les options dont vous avez besoin.

Je vous conseille également de garder sous la main les aide-mémoire proposés par Posit. Deux sont particulièrement utiles :

  • RMarkdown , pour retrouver rapidement les balises permettant de créer des titres, des listes, des liens, de mettre du texte en gras ou en italique, etc. ;
  • Quarto  pour retrouver les principales fonctionnalités et options permettant de construire vos documents.

Pour aller plus loin avec Quarto

Si vous souhaitez maintenant approfondir certaines fonctionnalités, vous trouverez également plusieurs tutoriels sur le blog de DellaDATA.

Si vous utilisiez auparavant R Markdown, vous pouvez commencer par Transiter de R Markdown à Quarto, pour comprendre les principales différences entre les deux outils. Vous pouvez ensuite découvrir comment gérer les citations et les références bibliographiques avec Quarto, comment numéroter automatiquement les figures, tableaux et équations et créer des renvois, ou encore comment afficher des énoncés et leurs solutions pour créer des TD et des supports pédagogiques.

Vous souhaitez vous former à Quarto ?

Si vous souhaitez utiliser Quarto dans un cadre professionnel et apprendre à créer et personnaliser vos propres documents, je propose également une formation Quarto en classe virtuelle. La prochaine session aura lieu le 29 octobre. → Découvrir le programme de la formation Quarto DellaDATA

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *

Fonctions statistiques R

Aide mémoire off'R ;)

Enregistrez vous pour recevoir gratuitement mes fiches « aide mémoire » (ou cheat sheets) qui vous permettront de réaliser facilement les principales analyses biostatistiques avec le logiciel R et pour être informés des mises à jour du site.