Le texte et le code dans le meme fichier

Un document technique avec des donnees se fabrique souvent ainsi : une figure nait dans un carnet, sort en image, se glisse dans un traitement de texte pour la mise en page, et tout repart des que les donnees changent. Quarto veut supprimer ce va et vient. Maintenu par Posit et pose sur Pandoc, il se presente comme un systeme libre d edition scientifique et technique. L auteur entretient un seul fichier texte en clair suffixe qmd, le recit et les blocs de code executables vivent dans ce fichier, et au rendu le code passe d abord, figures et valeurs se remplissent a leur place, puis Pandoc produit le document fini.

L interet n est pas d epargner quelques clics, mais que l origine de chaque resultat reste tracable. Chaque nombre et chaque figure du document correspond a un morceau de code du fichier, une mise a jour des donnees veut donc dire un nouveau rendu, et la situation ou le texte annonce une conclusion de mars pendant que la figure date de fevrier ne peut pas se produire. Pour des rapports et des documents techniques entretenus pendant des annees, cela compte plus qu une belle mise en page.

Une source, plusieurs produits finis

Les formats de sortie vont loin : pages HTML, PDF, fichiers de traitement de texte, livres ePub et diaporamas revealjs, avec en plus la possibilite d organiser plusieurs documents en site web, en blog ou en livre. Un fichier source peut nommer plusieurs formats cibles a la fois, donc la version pour l ecran et la version pour l impression ne demandent plus deux jeux d epreuves. On ecrit dans le dialecte Markdown de Pandoc, ou formules, citations, renvois, panneaux de figures, encadres et mises en page avancees sont pris en charge au niveau de la syntaxe, et la numerotation des figures suit les ajouts et retraits, ce qui supprime la numerotation manuelle qui se trompe le plus souvent dans les longs documents.

L execution du code ne tient a aucune langue. Python, R, Julia et Observable JavaScript s ecrivent directement dans les blocs, le moteur est choisi au rendu, et un carnet Jupyter se rend tel quel. L editeur non plus n est pas impose : VS Code, Positron, RStudio et JupyterLab fonctionnent, un editeur Markdown visuel est propose, et qui aime le texte brut s en sort aussi bien avec un editeur quelconque et une ligne de commande.

La version 1.11 repare les fondations

Quarto 1.11 est sorti le 2 novembre 2026, plus tot que le rythme habituel, et la raison est une mise a jour de securite. Le moteur Deno embarque passe de 2.7.14 a 2.9.8, et la nouvelle version refuse les certificats qui portent les chaines deja cassees d eMudhra et d emSign. L effet se situe a la publication et a la recuperation : quarto publish, quarto add et quarto use template, ainsi que les scripts TypeScript que Quarto execute, passent tous par des requetes HTTPS, et une version ancienne qui faisait confiance a ces certificats laissait a un attaquant du meme reseau l occasion d imiter un site. Le projet indique clairement que la correction ne sera pas reportee sur la serie 1.10, donc la 1.11 est le seul chemin vers elle.

Le prix est un plancher un peu plus haut pour la machine. Le Deno 2.9.8 embarque exige macOS 12 ou plus recent, donc un systeme plus ancien doit d abord etre mis a niveau, faute de quoi le moteur de rendu et les formats qui en dependent risquent de ne pas demarrer.

L accessibilite a recu du vrai travail

L autre moitie de la 1.11 porte sur l accessibilite, et les changements se trouvent la ou ils servent vraiment. Les documents HTML a theme Bootstrap, avec les sites, les livres et les tableaux de bord, gagnent un lien qui saute au contenu principal, si bien qu au clavier on ne traverse plus toute la navigation a la tabulation. Les sections de la barre laterale d un site deviennent des boutons maniables au clavier. Les blocs de code et les zones de sortie defilants prennent le focus et defilent dans Safari. Les fenetres superposees des citations, notes de bas de page, renvois et annotations de code se ferment avec Esc. A l oeil, un anneau de focus bicolore fait son apparition et reste visible meme en mode de contraste force.

Les figures et les diaporamas sont aussi traites. Les diagrammes produits par Mermaid et Graphviz prennent desormais le texte de remplacement donne par fig-alt, et cela vaut pour les sorties HTML, revealjs, Word et Typst, le texte de remplacement restant separe de la legende visible pour que les deux ne se chassent plus. En vue de lecture ordinaire, un diaporama garde le focus clavier sur la page courante, un lecteur d ecran n annonce pas a l avance les etapes pas encore affichees, et le focus survit a un passage par un autre onglet du navigateur.

Des ajouts le long de Typst et de Julia

Pour qui compose avec Typst, deux options nommees lof et lot produisent maintenant des listes de figures et de tableaux, le titre de la liste suit la langue du document et se regle par crossref. Les blocs proof, remark et solution passent du texte brut a une allure de theoreme, et les blocs etiquetes acceptent les renvois. La facon d ecrire les listes de definitions est fixee elle aussi, avec un conteneur definition-list qui porte une liste a puces imbriquee, et c est la syntaxe que la prochaine grande version conservera.

Le moteur Julia gagne une option keep-ipynb, si bien qu un carnet execute peut etre enregistre a cote du fichier source, et il corrige aussi une execution de carnet qui se bloquait ainsi qu un cas ou un changement de metadonnees n invalidait pas les resultats de cellules en cache. Les metadonnees partagees arrivent maintenant aux gabarits Pandoc et aux filtres Lua sous forme de valeur fusionnee, donc une liste heritee comme keywords se fond avec les valeurs propres du document au lieu d etre remplacee en bloc par la liste du document.

Pour qui cela colle, et pour qui non

La zone confortable est nette : ceux qui doivent ecrire ensemble le code, les resultats et l explication. Rapports d analyse de donnees, carnets d experience, supports de cours, manuels techniques et livres vivant des annees ont tous l exigence dure qu un resultat remonte au calcul qui le produit, et le modele a source unique y repond droit. La ou une equipe travaille deja dans RStudio ou Jupyter, le cout de migration se depense surtout a apprendre les options YAML, la syntaxe elle meme n est pas difficile.

Si l on veut seulement un site de documentation propre, sans aucun code a executer dans la page, la charge de configuration apportee par Quarto paraitra superflue et une solution statique plus legere suffit. La voie PDF depend encore d une installation LaTeX, et ses messages d erreur ne sont pas aimables pour un debutant ; passer au format Typst contourne cette couche, au prix d un ecosysteme plus jeune. Le temps de rendu merite aussi reflexion, car un projet au calcul lourd demande gel et cache, sans quoi chaque reconstruction refait le travail.

Lu a la lumiere de la 1.11, le centre de gravite est passe de l accumulation de fonctions au polissage de la fiabilite : chaines de certificats, accessibilite, invalidation de cache d un moteur a l autre sont autant de douleurs que seuls les utilisateurs de longue date rencontrent. Pour ceux qui l emploient deja, la raison de mettre a jour est la correction de securite. Pour ceux qui regardent encore, le premier pas raisonnable est de rendre un rapport que l on ecrit deja et de voir si un seul fichier source peut remplacer l assemblage en place aujourd hui.