Gérer les claves avec biblatex

vendredi 16 septembre 2016, mise à jour dimanche 11 septembre 2016, par Maïeul
RSS 2.0 Forum

Lorsqu’on cite des œuvres anciennes, par exemple dans le domaine du christianisme ancien, il peut être utile d’indiquer l’identifiant de celles-ci dans une ou plusieurs claves (singulier clavis), tel que la Bibliotheca hagiographica graeca (BHG) ou la Clavis apocryphorum novi testamenti (CANT), afin d’éviter les confusions entre œuvres homonymes, ou pour clarifier l’identification d’une œuvre publiée sous différents titres.

Le package biblatex-claves, juste publié sur le CTAN et inspiré d’une précédente contribution, facilite l’ajout de telle information de manière cohérente. En voici une brève présentation, la documentation officielle et complète étant sur le CTAN.

Exemple

Avec ce package, nous pouvons préciser les claves dans des champs dédiés.

@bookinbook{BHG225,
	Bhg = {225},
	Cant = {285},
	Crossref = {AAA2.2},
	Editor = {Maximilien Bonnet},
	Pages = {292-302},
	Title = {Acta Barnabae}
}
@book{AAA2.2,
	Address = {Darmstadt},
	Date = {1903},
	Editor = {Maximilien Bonnet},
	Location = {Leipzig},
	Publisher = {Hermann Mendelssohn},
	Title = {Acta Apostolorum Apocrypha},
	Volume = {2.2}}

Ceci sera rendu ainsi :

Acta Barnabae (BHG 225 ; CANT 285), in : Acta Apostolorum Apocrypha, éd. Maximilien Bonnet, Vol. 2.2, Leipzig : Hermann Mendelssohn, 1903, p. 292–302

Chargement du package

Le package, qui nécessite biblatex 3.5 ou plus récent, définit de nouveaux champs directement utilisables par biblatex. C’est pourquoi il doit être chargé en tant que style bibliographique :

\usepackage[bibstyle=claves,citestyle=<un-citestyle>]{biblatex}

Si vous utilisez un autre package qui définit de nouveaux champs, tel que biblatex-bookinother, utilisez le package biblatex-multiple-dm.

Indiquer les claves à utiliser

Dans votre préambule, déclarez les claves que vous souhaitez utiliser, en utilisant la commande \AddBiblatexClavis. Par exemple :

\AddBiblatexClavis{BHG}
\AddBiblatexClavis{CANT}

L’ajout manuel de la commande \AddBiblatexClavis permet de définir au dernier moment les claves à utiliser.

Notez que la casse utilisée dans l’argument de \AddBiblatexClavis sera celle utilisée pour insérer le numéro dans les références bibliographiques.

Lister les claves utilisées

Il peut être utile de fournir en dépit de bibliographie l’explication du code des claves. Pour ce faire, vous pouvez ajouter les claves comme des entrées bibliographiques dans votre fichier .bib :

@book{CANT,
	Address = {Turnhout},
	Author = {Maurice Geerard},
	Date = {1992},
	Publisher = {Brepols},
	Series = {Corpus Christianorum},
	Title = {Clavis Apocryphorum Novi Testamenti}}
@mvbook{BHG_3,
	Address = {Bruxelles},
	Author = {François Halkin},
	Date = {1957},
	Edition = {3},
	Number = {81},
	Publisher = {{Société des Bollandistes}},
	Series = {Subsidia Hagiographica},
	Title = {Bibliotheca hagiographica graeca},
	Volumes = {3}}
@book{BHG_auctarium,
	Address = {Bruxelles},
	Author = {François Halkin},
	Date = {1969},
	Number = {47},
	Publisher = {{Société des Bollandistes}},
	Series = {Subsidia Hagiographica},
	Title = {Auctarium bibliothecae hagiographicae graecae}}
@book{BHG_novum_auctarium,
	Address = {Bruxelles},
	Author = {François Halkin},
	Date = {1984},
	Number = {65},
	Publisher = {{Société des Bollandistes}},
	Series = {Subsidia Hagiographica},
	Title = {Novum auctarium bibliothecae hagiographicae graecae}}

Comme on peut le constater, le numéro dans la Bibliotheca hagiographica graeca peut correspondre aux trois volumes initiales, ou bien aux auctoria. Nous pouvons dès lors définir une entrée de type @set.

Ce type d’entrée est particulière : elle renvoie à d’autres entrées. Lorsqu’une de ces entrées est citée, toutes les entrées du @set sont citées. Comme nous souhaitons pouvoir chacun des volumes de la BHG et de ses auctoria de manière individuelle, nous allons définir notre entrée de type @set de manière locale [1] et la commande \defbibentryset.

Enfin, nous pouvons utiliser l’environnement bibliographique claves, qui permet d’afficher la clef d’une entrée bibliographique en face de sa référence, et qui modifie légèrement l’affichage standard des entrées de type @set. De plus, nous utiliserons un tri bibliographique particulier, nommé claves, qui se contente de trier selon l’ordre des clefs bibliographiques.

Cela donne donc le code suivant :

\begin{refsection}
  \begin{refcontext}[sorting=claves]
    \setlength{\shorthandwidth}{3em}
    \defbibentryset{BHG}{BHG_3,BHG_auctarium,BHG_novum_auctarium}
    \citeallclaves
    \printbibliography[env=claves,title=Liste des \emph{claves}]
  \end{refcontext}
\end{refsection}

Commentaire :

l. 1 et 8 : ouverture et fermeture d’un environnement refsection. Par défaut, toute commande \printbibliography à l’intérieur de cet environnement n’indiquera que les entrées citées dans l’environnement. Réciproquement, les entrées qui ne sont citées que dans l’environnement n’apparaîtront pas dans les \printbibliography.
l. 2 et 7 : ouverture et fermeture d’un environnement refcontext, qui permet, notamment, de définir un tri bibliographique spécifique, ici selon l’ordre alphabétique des clefs de citation (sorting=claves).
l. 3, on modifie l’espace accordée par biblatex au label dans les listes d’abréviations. Purement cosmétique.
l. 4, on dit que l’entrée de type @set dont la clef est BHG renvoie aux entrées BHG_3,BHG_auctarium et BHG_novum_auctarium.
l. 5, la commande \citeallclaves effectue un nocite sur toutes les clefs passées aux commandes \AddBiblatexClavis en préambule.
l. 6, la liste des claves est simplement une bibliographie un peu particulière :
Un titre « Liste des claves »
Un environnement bibliographique claves qui :
- Affiche la clef bibliographique en face de la référence.
- Insère un retour paragraphe entre chaque sous-entrée d’une entrée @set
- Insère un tirer pour indiquer la répétition d’un nom d’auteur pour les sous-entrées d’un @set.

Ce qui donne ceci :

Exemple de liste des claves

Personnalisation

Lire la documentation officielle.

Notes

[1] En attendant une éventuelle amélioration de biblatex], en utilisant la notion de section bibliographique[[Je parle rapidement de la notion de section bibliographique dans mon ouvrage. Une section bibliographique dans un document permet d’établir une bibliographie ne correspondant qu’à une partie du document, par exemple un chapitre.

Vos commentaires

# Le 2 avril 2017 à 09:40, par Wiener En réponse à : Gérer les claves avec biblatex

Bonjour,

J’essaie d’utiliser votre package pour mon usage particulier, à savoir mettre dans la bibliographie principale TDNT à la place de toute la référence du Kittel et avoir dans une liste d’abréviations la référence complète du Kittel. Mais je n’y parviens pas. Donc je me suis dit que j’allais déjà essayer de compiler votre exemple. Je n’y parviens pas non plus. En faisant juste des copier-coller, voici un ecm :
\documentclass[12pt,a4paper,oneside,EU1,no-math]{book} \usepackage[tools={claves,bookinother},bibstyle=verbose]{biblatex-multiple-dm} \usepackage[bibstyle=multiple-dm,citestyle=verbose-ibid]{biblatex} \AddBiblatexClavis{BHG} \AddBiblatexClavis{CANT} \begin{refsection} \begin{refcontext}[sorting=claves] \setlength{\shorthandwidth}{3em} \defbibentryset{BHG}{BHG_3,BHG_auctarium,BHG_novum_auctarium} \citeallclaves \printbibliography[env=claves,title=Liste des \emph{claves}] \end{refcontext} \end{refsection} \bibliography{_claves.bib} \begin{document} \printbibliography \end{document}
et, pour la bibliographie :
@bookinbook{BHG225, Bhg = {225}, Cant = {285}, Crossref = {AAA2.2}, Editor = {Maximilien Bonnet}, Pages = {292-302}, Title = {Acta Barnabae} } @book{AAA2.2, Address = {Darmstadt}, Date = {1903}, Editor = {Maximilien Bonnet}, Location = {Leipzig}, Publisher = {Hermann Mendelssohn}, Title = {Acta Apostolorum Apocrypha}, Volume = {2.2}} @book{CANT, Address = {Turnhout}, Author = {Maurice Geerard}, Date = {1992}, Publisher = {Brepols}, Series = {Corpus Christianorum}, Title = {Clavis Apocryphorum Novi Testamenti}} @mvbook{BHG_3, Address = {Bruxelles}, Author = {François Halkin}, Date = {1957}, Edition = {3}, Number = {81}, Publisher = {{Société des Bollandistes}}, Series = {Subsidia Hagiographica}, Title = {Bibliotheca hagiographica graeca}, Volumes = {3}} @book{BHG_auctarium, Address = {Bruxelles}, Author = {François Halkin}, Date = {1969}, Number = {47}, Publisher = {{Société des Bollandistes}}, Series = {Subsidia Hagiographica}, Title = {Auctarium bibliothecae hagiographicae graecae}} @book{BHG_novum_auctarium, Address = {Bruxelles}, Author = {François Halkin}, Date = {1984}, Number = {65}, Publisher = {{Société des Bollandistes}}, Series = {Subsidia Hagiographica}, Title = {Novum auctarium bibliothecae hagiographicae graecae}}
J’obtiens le message suivant à la compilation :
(/usr/local/texlive/2016/texmf-dist/tex/latex/biblatex/biblatex.cfg)) \abx@aux@refsection{1}{1} </bcf:section>  <bcf:bibdata section="1"> </bcf:bibdata> <bcf:section number="1"> \abx@aux@sortscheme{claves} ! Undefined control sequence. <argument> ...ing /\blx@refcontext@sortingnamekey /\blx@refcontext@labelpref... l.7 ^^I^^I\setlength {\shorthandwidth}{3em} ?
Any idea ?... Je me sens vraiment nulle de ne pas arriver à juste reproduire des copier-coller... Un truc m’échappe, c’est sûr... Merci d’avance... Cordialement,

Hélène Wiener.
# Le 2 avril 2017 à 09:59, par Maïeul En réponse à : Gérer les claves avec biblatex
Bonjour,

tout bêtement en mettant le
\begin{refsection} \begin{refcontext}[sorting=claves] \setlength{\shorthandwidth}{3em} \defbibentryset{BHG}{BHG_3,BHG_auctarium,BHG_novum_auctarium} \citeallclaves \printbibliography[env=claves,title=Liste des \emph{claves}] \end{refcontext} \end{refsection}
dans le corps du document et non pas dans le preambule (ce qui est du reste plus logique, puisque ceci est censée vous permettre d’afficher la liste des abréviations).
# Le 3 avril 2017 à 03:35, par Wiener En réponse à : Gérer les claves avec biblatex

Parfait, effectivement cela fonctionne comme ça ! Merci !

Geekographie Maïeulesque