L'élément citation
permet de paramétrer les appels de citation pour les styles in-text, et les notes (de bas de page ou de fin) pour les styles note. Il comporte deux éléments :
sort
: définit les critères de tri des références multiples,layout
: spécifie les informations à inclure (et leur formatage s'il n'a pas été défini dans des macro
).Auteur : Daniel Kulinski - CC-BY-NC-SA - Source Flickr
<citation nom_attribut="valeur_à_appliquer"/>
Les attributs et les possibilités de mise en forme diffèrent en fonction du type de style : note, numérique ou auteur-date (pour auteur-date, notamment désambiguïsation et nombre d’auteurs pour l’affichage de « et al. »)
<sort>
<key variable="variable_critère_de_tri_pour_les_références_multiples"/>
<key macro="résultat_de_la_macro_critère_de_tri_pour_les_références_multiples" sort="ascending" ou "descending"/>
</sort>
<layout >
<text variable="variable_à_afficher" préfixe, suffixe, etc./>
<text macro="résultat_de_la_macro_à_afficher"/>
</layout>
</citation>
Grouper par nom d’auteur : cite-group-delimiter
Compacter : collapse
- valeurs :
"year"
: compacte les références d’un même auteur aux dates, par ex. : (Doe 2000, Doe 2001) devient (Doe 2000, 2001)."year-suffix"
: idem que le précédent, mais compacte aussi des années identiques, par ex. : (Doe 2000a, Doe 2000b) devient (Doe 2000a, b)."year-suffix-ranged"
: idem que le précédent, mais compacte aussi les suffixes, par ex. : (Doe 2000a, b, c, e) devient (Doe 2000a-c, e).et-al-min
: nbre d’auteurs minimum pour afficher la mention "et. al"et-al-use-first
: nbre d’auteurs à inclure avant "et. al"et-al-subsequent-min
et et-al-subsequent-use-first
: idem supra, pour les références déjà citéeset-al-use-last
: remplace "et. al" par « … » et le nom du dernier auteurdelimiter-precedes-et-al
: caractère précédant "et. al"L’attribut position
d’un élément if
ou else-if
détermine le contenu à afficher en fonction de la position de la citation par rapport à des occurrences précédentes.
Il peut avoir différentes valeurs.
first
: première occurrence de la référence citée,ibid
, ibid-with-locator
, subsequent
: une référence citée précédemment a la position subsequent
. Elle peut aussi avoir la position ibid
ou ibid-with-locator
si les deux occurrences sont contiguës. C'est le cas si l'une des deux conditions suivantes est satisfaite.C'est alors la présence de locator
qui détermine la position attribuée.
locator
.Si la citation comporte un locator
, la position est ibid-with-locator
.
Si elle n'en comporte pas, la position est ibid
.
locator
.Si la citation comporte le même locator
, la position est ibid
.
Si la citation comporte un locator
différent, la position est ibid-with-locator
.
Si elle ne comporte pas de locator
, la position est seulement subsequent
.
near-note
: position d'une citation subsequent
distante d'un nombre n de notes de la première occurrence de la référence citée. L’attribut near-note-distance
permet en effet de paramétrer la distance maximale entre les 2 notes. Ainsi, une citation très éloignée de la première occurrence de la référence citée pourra comporter une version plus détaillée de la référence. Exemples de style utilisant l'attribut position
: Presses Universitaires de Rennes (French) et Le tapuscrit (École des hautes études en sciences sociales) (note, French).
L'attribut collapse
permet de compacter des références adjacentes d ans un même appel de citation. A insi, avec la valeur "citation-number"
: [1, 2, 3] devient [1-3].
L'élément citation
est plus complexe dans les styles auteur-date, car il doit comporter des règle de désambiguïsation des appels de citation (documents distincts ayant le même premier auteur et la même date de publication). CSL envisage cette désambiguïsation selon 3 étapes.
disambiguate-add-names
: par l’ajout d’un nom, sans tenir compte du paramétrage du "et. al"
disambiguate-add-givenname
: par l’ajout d’un prénom, par ex. J. Doe, 2005 et M. Doe, 2005.
givenname-disambiguate-rule
: traitement des prénoms (tous les prénoms, initiales, etc.)
disambiguate-add-year-suffix
: par l’ajout d’un suffixe à l’année, par ex. : 2007a, 2007b etc.