6 Commentaires et annotations en phase de relecture
6.1 Commentaires collaboratifs
6.1.1 Configuration dans _quarto.yml
L’extension quarto-proofread-comments (dossier _extensions/proofread-comments/) se configure dans _quarto.yml, via la clé quarto-proofread-comments: placée sous le bloc extensions: . Documentation complète de l’extension : zinc75.github.io/quarto-proofread-comments
6.1.2 La syntaxe des annotations
L’extension utilise la syntaxe des spans Pandoc entre crochets. Un span vide [] crée un commentaire inséré (sans texte surligné) ; un span non-vide surligne le texte et y attache la note.
[]{.comment by="ag" remark="Reformuler cette phrase, elle est trop longue."}
[]{.comment by="eb" type="todo" remark="Ajouter une figure illustrant ce point."}
[]{.comment by="ag" type="note" remark="Voir aussi Bringhurst 2004, §2.4."}
[]{.comment by="ag" type="question" remark="Ce résultat est-il reproductible sur un autre jeu de données ?"}
[texte surligné]{.comment by="ag" remark="Ce passage mérite une reformulation."}
[]{.comment by="eb" inline="true" remark="Un commentaire inline, inséré dans le flux du texte."}Les quatre types disponibles sont comment (défaut), todo, note et question.
Rendu en situation :
Voici une phrase avec un commentaire du directeur de thèse (qui a ajouté directement celui-ci dans le fichier .qmd parce qu’il n’est pas frileux !).
Ceci est un commentaire pour montrer que moi aussi, Abbé Grégoire, suis capable d’éditer facilement un Markdown Quarto !
Ces commentaires ne sont visibles que si l’option quarto-proofread-comments est à enabled: true dans le fichier yaml, ce qui est le cas pour cette documentation.
Penser à passer l’option à false avant soumission du manuscrit finalisé à l’école doctorale et au jury !
Il est aussi possible de surligner un passage et d’y attacher une note dans la marge — le texte surligné devient le lien visuel entre le passage et l’annotation.
Voir Knuth 1984, chapitre 12, ce serait vraiment bien de rajouter une discussion sur cet ouvrage ici pour montrer tout votre savoir sur la littérature existante, jeune apprenti.
inline="true" : remarque insérée dans le flux du texte
Avec inline="true", la remarque s’insère directement dans le texte courant — en HTML comme en PDF — sous la forme d’un badge coloré compact, sans notion de bloc ni de saut de ligne. C’est le mode inline_style: "flow" (défaut) de l’extension. Utile pour des apartés courts glissés au milieu d’une phrase sans perturber la mise en page du paragraphe.
wide_margins: true est activé par défaut
Pour les notes en marge, extensions.quarto-proofread-comments.wide_margins: true est la valeur par défaut. Le papier est alors élargi vers l’extérieur d’une bande dédiée (largeur réglable via extra_margin) où les annotations s’affichent confortablement, avec un fond grisé qui alterne selon la parité des pages (côté extérieur, reliure préservée).
Élargissement ciblé par chapitre. L’élargissement et la bande grise n’apparaissent que dans les chapitres contenant réellement des commentaires : un chapitre sans annotation reste en A4 standard, sans bande grise. Le template repère automatiquement les chapitres concernés (en scrutant les fichiers source du livre), de sorte que les zones commentées sautent aux yeux dans un PDF de relecture, sans élargir inutilement tout le document. Conséquence cosmétique acceptable : à la jonction entre un chapitre large et un chapitre A4, une éventuelle page blanche d’aération (\cleardoublepage) peut hériter de la largeur précédente — sans incidence sur le dépôt final, où les commentaires sont désactivés et toutes les pages reviennent en A4.
Passez wide_margins: false pour conserver le format A4 standard : les notes se placent alors dans la marge extérieure de 2 cm. La mise en page du contenu (bloc de texte) est rigoureusement identique quelle que soit la valeur de wide_margins, et que les commentaires soient activés ou non — seule la zone d’annotation en marge change.
Avant de soumettre la thèse à l’école doctorale et de la déposer sur theses.fr, passez extensions.quarto-proofread-comments.enabled: false dans _quarto.yml. Les annotations ne doivent pas figurer dans la version officielle archivée.
6.2 Annotations web avec Hypothesis (opt-in)
Pour une relecture à distance, la version HTML peut être enrichie d’annotations web via Hypothesis. Le directeur ou les relecteurs sélectionnent du texte dans le navigateur et ajoutent des commentaires sans toucher aux fichiers source. Les annotations sont stockées sur les serveurs Hypothesis et liées à l’URL de la page — elles persistent d’un rendu à l’autre tant que l’URL reste stable (déploiement GitHub Pages).
Pour activer, décommenter le bloc suivant dans _quarto.yml :
Créer ensuite un groupe privé sur hypothes.is et partager le lien d’invitation aux relecteurs. Hypothesis est désactivé par défaut dans tous les profils.
Il sera nécessaire de m’exposer vos différents fichiers yaml au cours de notre prochaine réunion d’avancement.