Pour afficher des citations dans un texte, on a besoin de compiler plusieurs fichiers : - le fichier texte (document en LaTeX ou en markdown) - le fichier qui contient des références (document en json ou en bibtex, dans ce guide on utilisera plutôt le format bibtex) - le fichier qui contient le style bibliographique et qu’on peut récupérer depuis le site de Zotero

Le résultat de cette compilation avec sa bibliographie bien ordonnée dans le style choisi apparaîtra dans un quatrième document.

ce fichier de sortie pourra être en format opendocument, word, html, pdf, etc.

L’outil qui va nous servir à compiler ces trois documents pour obtenir le quatrième peut être téléchargé en ligne et installé sur un ordinateur. Il s’agit de Pandoc. Pandoc est également intégré à de nombreux éditeurs utilisables en ligne (comme Stylo, un éditeur en markdonw ou Overleaf, un éditeur en ) ou localement (comme R avec Rstudio)

Pour insérer une citation dans le texte, nous avons besoin de deux choses : le signe @ et une clé de citation unique pour chaque item présent dans le fichier bibtex

Par exemple, si nous reprenons une phrase présente ci-dessus :

il ne balise pas assez le texte (titre, sous-titre, notes, citation, références), il ne balise pas non plus assez les références. Dans un monde où les publications sont lues et connectées les uns aux autres par des ordinateurs, ce défaut de balisage est un problème (@vitali-rosatiChercheursSHSSaventils2018).

La clé de citation unique ici est "vitali-rosatiChercheursSHSSaventils2018", une sorte de condensé entre le nom de l’auteur, le nom du titre et l’année de publication.

Le plugin BetterBibTex une fois installé dans Zotero a pour rôle d’ajouter à toutes les références déjà présentes dans les collections et celles à venir ce type d’identifiant unique. BetterBibTex permet d’ailleurs d’en changer la composition, s’il y a besoin de le faire, ce qui n’est généralement pas le cas. Mais n’anticipons pas, nous verrons comment cela se passe du côté de Zotero plus tard, pour l’instant, contentons-nous de parler de la conversion des documents en markdown qui comportent des références bibliographiques.

Le convertisseur universel Pandoc va nous permettre de convertir un fichier de markdown vers un autre format de sorte que le format de destination comporte une bibliographie en bonne et due forme.

Pandoc : convertisseur universel de fichiers développé par John MacFarlane en Haskell et distribué sous une licence GPL universel mais avec une limite importante : on ne peut pas convertir un pdf en document inscriptible.
Pas d’interface graphique, cet outil s’utilise en lignes de commande depuis un terminal ou bien peut être intégré à des applications (fichiers d’intégration continue, version pour Python : pypandoc, intégré à R, à Stylo, etc.)