Citations et notes de bas de page

Introduction

Ce guide donne un aperçu de la manière d’inclure des citations et des notes de bas de page dans vos documents Quarto. Il aborde les sujets suivants:

  • Les bases du formatage en utilisant BibLaTeX, BibTeX et CSL pour des styles de citation précis.
  • Génération automatique de bibliographie et personnalisation.
  • Fonctionnalités avancées incluant le formatage des notes de bas de page et l’inclusion d’éléments non cités.


Citations

Vous aurez besoin de:

  • Un document Quarto avec des citations.
  • Un fichier source de bibliographie, comme BibLaTeX (.bib) ou BibTeX (.bibtex).
  • Optionnellement, un fichier CSL pour un formatage spécifique (si vous n’utilisez pas natbib ou biblatex).

Fiches bibliographiques

Spécifier un champ de fichier bibliographique dans les métadonnées YAML.:

---
title: "Mon document"
bibliography: references.bib
---

Syntaxee de la citation

  • Les citations sont entre crochets, séparées par des points-virgules: [@citation] or [@citation1; @citation2].
  • Chaque citation a une clé commençant par @ plus un identifiant de la base de données.
  • Les clés doivent commencer par une lettre, un chiffre ou _, et peuvent inclure des caractères alphanumériques, _, et certaines ponctuations (:.#$%&-+?<>~/).

Voici des exemples de citations dans un document markdown:

Format Markdown:

  1. Blah Blah (see Knuth 1984, pp. 33-35; également Wickham 2015, chap. 1)
  2. Blah Blah (Knuth 1984, pp. 33-35, 38-39 et passim)
  3. Blah Blah (Wickham 2015; Knuth 1984)
  4. Wickham dit blah (2015)

Sortie (par défaut):

  1. Blah Blah (see Knuth 1984, pp. 33-35; également Wickham 2015, chap. 1)
  2. Blah Blah (Knuth 1984, pp. 33-35, 38-39 et passim)
  3. Blah Blah (Wickham 2015; Knuth 1984)
  4. Wickham dit blah (2015)

Sortie (csl):

  1. Blah Blah voir [1], pp. 33-35 ; également [1], chap. 1
  2. Blah Blah [1], pp. 33-35, 38-39 et passim
  3. Blah Blah [1, 2]
  4. Wickham dit blah [1]

csl : diabetologia.csl, voir Section 2.3

Style de la citation

  • Style par défaut : [Chicago Manual of Style] (https://chicagomanualofstyle.org/) (format auteur-date)
  • Ajoutez un format de citation personnalisé en spécifiant un chemin d’accès au fichier CSL (Style de la citation Language) dans le champ de métadonnées de votre document:
---
title: "Mon document"
bibliography: references.bib
csl: nature.csl
---

Génération de bibliographies

  • Générés automatiquement
  • Placées à la fin du document par défaut (ou dans une div avec l’identifiant refs s’il y en a une):
### Références

::: {#refs}
:::
Astuce

Vous pouvez supprimer la génération d’une bibliographie en incluant l’option suppress-bibliography : true dans les métadonnées de votre document

Exemple de bibliographie générée:

Knuth, Donald E. 1984. « Literate programming ». The Computer Journal 27 (2): 97‑111.
Wickham, Hadley. 2015. R Packages. 1st éd. O’Reilly Media, Inc.

Incluant les éléments non cités

Pour ajouter des éléments de bibliographie non cités dans le texte, utilisez un champ de métadonnées nocite pour les citations.

---
nocite: |
  @item1, @item2
---

@item3

Dans cet exemple, le document contiendra une citation pour item3 only, but the bibliography will contain entries for item1, item2, and item3.

Notes de bas de page

Syntaxe:

Voici une note de bas de page,[^1] et une autre.[^longnote]

[^1]: Voici la note de bas de page.

[^longnote] : En voici une avec plusieurs blocs.

    Les paragraphes suivants sont indentés pour montrer qu'ils appartiennent à la note de bas de page précédente.

        { some.code }

    Le paragraphe entier peut être indenté, ou seulement la première ligne. 
    De cette manière, les notes de bas de page à plusieurs paragraphes fonctionnent comme des éléments de liste à plusieurs paragraphes.

Ce paragraphe ne fera pas partie de la note, car il n'est pas indenté.

Sortie

Voici une référence de note de bas de page,1 et une autre.2

Ce paragraphe ne fera pas partie de la note, car il n’est pas indenté.

En outre, vous pouvez également rédiger des notes de bas de page en ligne pour un seul paragraphe en utilisant la syntaxe suivante:

Les notes en ligne sont plus faciles à écrire, car il n'est pas nécessaire de choisir un identifiant et de baisser le curseur pour taper la note.]

Sortie

Voici une note en ligne.3

Note

Les notes de bas de page générées à partir des exemples ci-dessus sont incluses dans la section suivante. Voir Pandoc notes de bas de page pour plus d’informations.

Notes de bas de page

  1. Voici la note de bas de page.↩︎

  2. En voici une avec plusieurs blocs.

    Les paragraphes suivants sont indentés pour montrer qu’ils appartiennent à la note de bas de page précédente.

    { some.code }

    Le paragraphe entier peut être indenté, ou seulement la première ligne. De cette manière, les notes de bas de page à plusieurs paragraphes fonctionnent comme des éléments de liste à plusieurs paragraphes.↩︎

  3. Les notes en ligne sont plus faciles à rédiger, car il n’est pas nécessaire de choisir un identifiant et de baisser le curseur pour taper la note.↩︎