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 pasnatbib
oubiblatex
).
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:
- Blah Blah (see Knuth 1984, pp. 33-35; également Wickham 2015, chap. 1)
- Blah Blah (Knuth 1984, pp. 33-35, 38-39 et passim)
- Blah Blah (Wickham 2015; Knuth 1984)
- Wickham dit blah (2015)
Sortie (par défaut):
- Blah Blah (see Knuth 1984, pp. 33-35; également Wickham 2015, chap. 1)
- Blah Blah (Knuth 1984, pp. 33-35, 38-39 et passim)
- Blah Blah (Wickham 2015; Knuth 1984)
- Wickham dit blah (2015)
Sortie (csl
):
- Blah Blah voir [1], pp. 33-35 ; également [1], chap. 1
- Blah Blah [1], pp. 33-35, 38-39 et passim
- Blah Blah [1, 2]
- 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
---
- Ressources pour les fichiers 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} :::
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:
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:
[^1] et une autre.[^longnote]
Voici une note de bas de page,
[^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
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
Voici la note de bas de page.↩︎
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.↩︎
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.↩︎