Configurer les styles de citation CSL de Pandoc dans le navigateur : APA, Chicago, Vancouver
Pandoc peut transformer un document rempli de clés de citation nues en un texte abouti avec des citations formatées dans le corps et une bibliographie. Le mécanisme, c'est citeproc, désormais intégré à pandoc lui-même, et les styles qu'il applique sont écrits en CSL, le Citation Style Language. Les deux se comportent à l'identique, que pandoc s'exécute en ligne de commande ou compilé en WebAssembly dans un onglet du navigateur.
Ce guide explique ce qu'est CSL et où trouver les fichiers de style, comment préparer une bibliographie BibTeX à laquelle citeproc peut se fier, ce qui change réellement entre les sorties APA, Chicago et Vancouver pour une même entrée, et quelles erreurs laissent des clés de citation littérales dans le texte final.
Qu'est-ce que CSL
CSL signifie Citation Style Language, un format XML qui décrit exactement l'aspect d'une citation et d'une entrée bibliographique : où placer l'année, si les titres sont en italique, comment les plages de pages se contractent. Tous les grands styles existent sous forme de fichier CSL, et le Zotero Style Repository en héberge à lui seul des milliers, d'APA et Chicago aux styles maison de revues individuelles.
Parce que le style vit dans un fichier et non dans le code, changer de convention revient à changer de fichier, pas à modifier le document. Les revues qui imposent un format précis le désignent généralement par son nom, et le fichier CSL correspondant se télécharge depuis le dépôt sans aucune configuration de votre côté.
Comment citeproc résout une citation
Dans le document source, les citations s'écrivent en ligne avec l'arobase. Une clé entre crochets devient une citation entre parenthèses, tandis qu'une clé employée directement dans la phrase devient une citation narrative où le nom de l'auteur fait partie du texte. Les localisateurs voyagent avec la clé : les références aux pages et chapitres se logent à l'intérieur des crochets.
À la conversion, citeproc lit chaque clé, la recherche dans le fichier bibliographique et transmet l'entrée résolue au style CSL pour la mise en forme. Le même passage collecte toutes les entrées citées et ajoute une liste de références à la fin du document, ou à l'endroit marqué par un bloc portant l'id refs. Les clés sont des étiquettes que vous choisissez et n'apparaissent jamais dans la sortie, sauf si quelque chose a mal tourné.
Obtenir le fichier de style
Le Zotero Style Repository permet de rechercher par éditeur ou par mot-clé et de télécharger un fichier .csl en un clic. Lisez attentivement les noms de styles : Chicago existe en variante note-bibliography, qui produit des notes de bas de page, et en variante author-date, qui produit des citations entre parenthèses, et ce sont deux fichiers différents.
Quand une revue publie des consignes de mise en forme plutôt qu'un fichier, cherchez d'abord son nom dans le dépôt. Celui-ci suit des milliers de revues, et un fichier maintenu vaut mieux qu'un fichier retouché à la main. Si rien ne correspond, le style parent le plus proche convient généralement pour les brouillons.
Préparer le fichier .bib
Le fichier bibliographique fait correspondre des clés à des métadonnées. Au format BibTeX, chaque entrée commence par un type comme article, book ou inproceedings, suivi d'une clé que vous inventez, puis de champs comme author, title, year, journal et DOI. La clé est ce que vous tapez dans le texte : court et mémorable l'emporte sur long et précis, et un schéma stable du type auteur, année et un mot garde vos brouillons lisibles des années plus tard.
La complétude des champs se voit directement dans la sortie. Une année manquante laisse un emplacement vide dans une citation APA, et un DOI manquant supprime le lien que les lecteurs suivraient. Entourer les noms propres de doubles accolades dans le champ title protège leur capitalisation, car BibTeX peut sinon mettre les titres en minuscules pour satisfaire les règles du style.
Une entrée, trois sorties
Prenons une seule ligne avec une clé entre crochets et une clé narrative. Sous APA, un style author-date, la citation entre crochets devient un nom et une année entre parenthèses, la citation narrative devient l'auteur suivi de l'année entre parenthèses, et la bibliographie est triée alphabétiquement avec des retraits suspendus. Sous Chicago note-bibliography, les mêmes citations deviennent des notes de bas de page numérotées, complètes à la première mention et abrégées ensuite.
Sous Vancouver, courant en médecine, les citations deviennent des numéros séquentiels entre crochets, ordonnés par première apparition plutôt qu'alphabétiquement. Dans les trois cas, rien ne change dans votre texte : les clés, le fichier et le document restent identiques tandis que seul le fichier CSL est remplacé, ce qui est toute la raison d'être du format et la raison de le mettre en place tôt.
Exécuter les citations dans le navigateur
Sur ce site, les options de citation Pro acceptent deux téléversements : un fichier .bib avec les références et un fichier .csl avec le style choisi. Tout s'exécute dans le worker du navigateur, où citeproc fait partie du même moteur Pandoc que celui qui effectue la conversion, de sorte que les clés se résolvent exactement comme en ligne de commande.
Le flux de travail est court : écrivez le document avec les clés à arobase comme d'habitude, gardez un fichier .bib par projet, déposez le fichier de style exigé par la revue cible et convertissez. Changer de revue plus tard signifie alors téléverser un autre fichier .csl, et non réécrire la moindre citation.
Erreurs fréquentes et solutions
L'échec le plus fréquent est une clé qui ne correspond pas : le texte cite une clé que le fichier .bib ne définit pas, et pandoc laisse le texte brut entre crochets dans la sortie tout en consignant un avertissement sur la référence manquante. Vérifiez l'orthographe de la clé et confirmez que le fichier prévu a bien été téléversé.
Les problèmes de casse remontent au champ title, où les sigles et noms propres arrivent en minuscules quand le style l'exige ; la protection par doubles accolades dans le fichier .bib existe pour l'éviter. Les champs manquants apparaissent comme des vides ou des citations incomplètes, donc une vérification ponctuelle d'une entrée bibliographique rendue repère la plupart des problèmes avant la soumission.
Sortie du navigateur face à la ligne de commande
Parce que la version navigateur exécute la même implémentation de citeproc dans le même moteur Pandoc, les citations formatées et la bibliographie sont identiques à ce que la ligne de commande produirait avec les mêmes entrées et versions. Il n'y a aucun formateur simplifié entre les deux.
Cette équivalence fait du navigateur un endroit légitime pour préparer un brouillon de soumission : appliquez le style, vérifiez les références rendues et remettez aux relecteurs un document dont les citations correspondent déjà à la revue cible. Le convertisseur de ce site garde le traitement des .bib et .csl dans votre navigateur, de sorte que les manuscrits inédits restent eux aussi sur votre machine.