Geekographie Maïeulesque

Comment ma bibliographie a saturé la mémoire de (Xe)LaTeX

Maïeul — 2016-10-23T20:03:40Z

Cette semaine, compilant ma thèse pour une nouvelle relecture de la bibliographie, j'ai eu la désagréable surprise d'obtenir un message d'erreur libellé ainsi « TeX capacity exceeded, sorry [main memory size=5000000 ». J'ai passé un certain à trouver la source du bug. Je vous livre ici l'explication, d'une part parce que dans certaines circonstances d'autres que moi pourraient être amenés à obtenir le même bug, et d'autre part parce que l'explication de celui-ci s'avère intéressante pour comprendre les mécanismes sous-jacents à biblatex, à biber et à XeLaTeX.

Résumé du bug

Lançant ma série de compilations avec latexmk, j'obtiens, à la deuxième compilation XeLaTeX, le message suivant :

TeX capacity exceeded, sorry [main memory size=5000000]

D'habitude, ce type de message est provoqué par une boucle infinie, généralement liée à une faute de code. J'étais relativement sceptique sur l'existence d'une telle boucle, puisque je n'avais pas apporté beaucoup de changement de code depuis la dernière compilation complète effectuée un mois en amont.

Recherche de l'origine [1]

J'ai toutefois procédé à une méthode simple, mais généralement efficace pour trouver la source de ce type de bug : commenter la moitié du contenu LaTeX, compiler, voir si le bug se reproduit, si oui commenter la moitié du code restant, sinon inverser et faire un test sur la moitié qu'on n'avait pas testé, et recommencer, et ainsi de suite, jusqu'à cerner la ligne ou le bloc de code qui pose problème. Il s'agit d'une résolution classique par dichotomie, pas nécessairement la plus rapide, mais la plus simple à mettre en œuvre avec LaTeX.

Néanmoins, dans le cas qui m'occupait, une telle recherche s'est révélée infructueuse : le bug ne se produisait que si je compilais l'ensemble de ma thèse, et non pas l'une ou l'autre des moitiés.

Fort heureusement, je savais que j'avais réussi à compiler il y a quelques semaines, et qu'à l'époque j'avais posé un tag git. Grâce à la géniale fonction git bisect, j'ai pu trouver le commit ayant entraîné le bug, en testant par dichotomie l'ensemble de mes commits entre ma dernière compilation réussie et mon tout dernier commit.

Fort heureusement également, ce commit était relativement petit. J'avais remplacé :

\printbibliography[title={Manuscrits},subtype=ms,check=ms_principaux]

par

\begin{refcontext}[sorting=manuscripts]{} \printbibliography[title={Manuscrits},subtype=ms,check=ms_principaux] \end{refcontext}

Ceci permet que ma bibliographie consacrée aux manuscrits soit triée selon un ordre spécifique, d'abord par ville, puis par bibliothèque, par collection et par cote.

Recherche de la cause

La modification effectuée est donc la source du problème, mais pourquoi pose-t-elle problème ?

Fonctionnement interne de la bibliographie avec LaTeX + Biber

Un élément a éveillé ma curiosité : le bug se produisait AVANT même que la compilation n'ait eu le temps d'arriver à la ligne sur la bibliographie, comme je pouvais le constater à travers les messages défilant à l'écran.

Cependant, je touchais à un élément concernant la bibliographie. Or, voici comment fonctionne la bibliographie avec LaTeX + biblatex + Biber :

Lors de la première compilation, LaTeX lit le fichier .tex, repère les citations à l'intérieur, et écrit dans un fichier .bcf les clefs de citations utilisées ainsi que certaines informations relatives au style bibliographique, dont les informations sur le tri de la bibliographie.
Lors de la compilation Biber, ce dernier lit le fichier .bcf et le mettant en relation avec le fichier .bib, il trie et formate la bibliographie sous la forme d'une suite de commande LaTeX, qu'il écrit dans un fichier .bbl
Lors de la seconde compilation, LaTeX lit non seulement le fichier .tex, mais aussi le fichier .bbl, ce qui lui permet d'ajouter les références bibliographiques et de composer la ou les bibliographies finales.

Ceci est résumé dans le schéma ci-dessous.

Comment fonctionne la compilation de bibliographie dans LaTeX

Puisque le bug n'arrive qu'à la seconde compilation LaTeX, et qu'il est lié à la bibliographie, le problème se situe probablement dans ma bibliographie. Problème : le commit qui introduit le bug n'a rien changé au fichier .bib. Le problème se situe donc plus vraisemblablement au moment de la production du fichier .bbl.

Analyse du fichier `.bbl`

J'ai alors constaté que la taille du fichier .bbl doublait approximativement entre la compilation avant mon commit et celle après mon commit, passant à 4 Mo dans le second cas. Grâce à un logiciel d'affichage de différence entre fichiers, je constate aisément l'origine de la modification : après mon commit, les entrées bibliographiques sont présentes deux fois dans mon fichier .bbl : une fois triées selon mon classement par défaut, anonymous+realauthor, l'autre fois triées selon le classement introduit par mon commit : manuscripts.

Ceci est du reste parfaitement logique, le tri bibliographique étant effectué par Biber et non par LaTeX, il est normal de trouver pour deux demandes de tri,deux listes bibliographiques dans le fichier .bbl, chaque liste commençant par \sortlist et finissant par \endsortlist. Le problème est qu'avec 1253 entrées bibliographiques, cela produit un fichier très lourd, qui, par conséquent, remplit considérablement la mémoire de LaTeX, et aboutit donc à mon TeX capacity exceeded, sorry [main memory size=5000000]

Résolution du problème

Une fois la cause trouvée, il reste à voir comment se sortir de la situation. Trois solutions s'offrent à nous.

Première solution : utiliser LuaLaTeX

TeX, et XeTeX, les moteurs derrière LaTeX et XeLaTeX fonctionnent selon un modèle à quantité de mémoire disponible fixe : lorsque la compilation est lancée, une certaine quantité de mémoire seulement est utilisable.

En revanche, LuaTeX, derrière LuaLaTeX, fonctionne selon un modèle, plus récent, d'allocation dynamique de la mémoire : la mémoire vive utilisée est étendue au fur et à mesure des besoins, le système d'exploitation veillant simplement à ce que LuaLaTeX n'empiète pas sur les autres programme en activité [2]. Conséquence : la quantité de mémoire utilisable par LuaLaTeX ne dépend que de mon ordinateur, et on peut espérer que ma bibliographie doublée n'en vienne quand même pas à saturer toute la mémoire vive et virtuelle [3] de mon ordinateur.

Problème : LuaTeX est un moteur différent de XeTeX, avec ses spécificités, et, étant dans la phase terminale de ma thèse, je ne préfère pas effectuer une migration avec toutes les vérifications, parfois tenues, que cela implique.

Deuxième solution : augmenter la mémoire de XeLaTeX

Puisque je souhaite continuer à utiliser XeLaTeX, deux solutions s'offrent à moi : résoudre mon problème de double tri ou augmenter la mémoire de XeLaTeX. La seconde solution, moins écologique, est plus rapide à mettre en œuvre et consiste à augmenter la mémoire utilisable par XeLaTeX [4].

Une simple recherche sur le web m'indique la démarche à suivre, pour une installation TeXLive [5] :

trouver le fichier de configuration de texlive texmf.cnf en saisissant kpsewhich texmf.cnf dans mon terminal ;
dans mon cas, le fichier est /usr/local/texlive/2016/texmf.cnf ;
ouvrant le fichier je lis les lignes suivantes :
```
% This texmf.cnf file should contain only your personal changes from the % original texmf.cnf (for example, as chosen in the installer).
```
Ceci signifie que je peux y mettre tous mes réglages personnels sans risque de perdre les réglages par défaut que je n'aurais pas explicitement modifiés.
j'ajoute donc le réglage sur de mémoire suivant main_memory = 7999999, ayant lu que cela correspond à la quantité maximum gérable par (X^e)TeX.
puis dans mon terminal, saisir sudo fmtutil-sys --all pour relancer la création des scripts XeLaTeX, LaTeX et co, à partir de mes nouveaux réglages.

Pour m'assurer que mes réglages aient bien été pris en compte, je lance la compilation avec XeLaTeX d'un fichier minimum :

\documentclass{article} \begin{document} \end{document}

J'ouvre le fichier .log généré, et je lis peu avant la fin :

Here is how much of TeX's memory you used: 196 strings out of 493589 2014 string characters out of 6143511 53785 words of memory out of 7999999 3697 multiletter control sequences out of 15000+600000 3640 words of font info for 14 fonts, out of 8000000 for 9000 1347 hyphenation exceptions out of 8191 23i,1n,17p,127b,36s stack positions out of 5000i,500n,10000p,200000b,80000s

La ligne « 53785 words of memory out of 7999999 » m'indique donc que ma quantité de « words of memory [6] » est passée à 7999999, ce qui correspond à mon nouveau réglage. Ouf !

En relance ma compilation de thèse, tout se passe bien [7].

Troisième solution : éviter d'avoir deux bibliographies triées

Cependant, dans le cas où ma bibliographie grossirait encore sensiblement (ce que je n'espère pas), et pour le principe, il paraîtrait plus utile d'avoir la bibliographie triée une seule fois dans le fichier .bbl, que ce soit pour les manuscrits ou pour les autres types d'entrées. De toute façon, je filtre les types d'entrées lors de l'affichage final, pour séparer les manuscrits des autres types.

C'est pourquoi, la version 2.7.0 de biblatex-realauthor, que je viens d'envoyer sur le CTAN propose un nouveau schéma de tri, anonymous+realauthor+manuscripts, que je peux passer comme option global de biblatex, ce qui me permet de supprimer l'environnement refcontext que mon commit problématique avait introduit.

En guise de conclusion

Versionner son travail est très utile. Apprenez à le faire si ce n'est pas déjà fait.
Si vous avez des problèmes de TeX capacity exceeded, sorry [main memory size=5000000] après une compilation biber, et qu'une recherche par dichotomie ne donne rien, regardez la taille du fichier .bbl.

[1] En réalité, je suis arrivé moins directement au but, mais je donne ici la méthode que j'aurais du suivre…

[2] Je schématise, très grossièrement, d'autant plus que je ne suis pas du tout spécialiste de ces questions d'allocation de la mémoire

[3] Pour rappel : la mémoire vive, dont le contenu se vide à l'extinction de l'ordinateur, est plus rapide d'accès, mais plus coûteuse que la mémoire morte (disque dur, SSD), qui ne se vide pas à l'extinction de l'ordinateur. Pour faire leur calcul, les logiciels utilisent de la mémoire vive. Cependant, le système d'exploitation leur alloue également une part de mémoire morte pour simuler la mémoire vive, cette part est appelée « mémoire virtuelle ». Cette mémoire virtuelle, bien qu'utilisant un support à long terme, est destinée à n'être utilisée qu'à court terme.

[4] Sur ce point, XeTeX reste calé TeX, lequel a été inventé en 1977, à une époque où la mémoire informatique était une ressource rare.

[5] Pour MikTeX, j'ignore la démarche

[6] Si j'ai bien compris, un »Word of memory« est l'unité minimale de donnée que traite un processeur. Aujourd'hui, la plupart des ordinateurs neufs ont des »words of memory« de 64 bit, mais il y encore quelques années, la norme était de 32 bit. Avec 7 999 999 »words of memory« , je dispose donc de 511 999 936 bits de mémoire, soit environ 511 Mo. Cela étant, comme j'ignore comme XeTeX structure ses données en interne, je n'ai aucune idée de combien d'éléments bibliographiques je pourrai encore ajouter.

[7] J'ai simplement utilisé 4010951 words of memory sur 7999999, soit un peu plus de la moitié

biblatex-bookinarticle devient biblatex-bookinother

Maïeul — 2016-04-12T06:30:00Z

Le package biblatex-bookinarticle était la mise en package d'une précédent contribution proposant un nouveau type d'entrée @bookinarticle. J'ai petit à petit ajouté des nouveaux types permettant de gérer plusieurs cas de livres anciens édités dans d'autres types (par exemple dans un @inproceedings). Récemment j'ai également ajouté la possibilité de préciser l'éditeur.rice du livre ancien lorsqu'il ne s'agit pas de l'auteur.e de l'ouvrage incluant, par exemple si un livre est édité par un.e chercheur.se dans un article d'un.e autre chercheur.se.

Ceci impliquant un changement de mode de chargement du package, j'ai changé, après consultation des utilisateurs, le nom de package. Il devient biblatex-bookinother.

Ce que propose le package

Au moment de sa sortie, le package biblatex-bookinother propose plusieurs nouveaux types :

@bookinarticle
@bookincollection
@bookinincollection
@bookininproceedings
@bookinproceedings
@bookthesis

La meilleure manière de gérer ces entrées et de les présenter comme sous-entrées bibliographiques d'une entrée plus globale, grâce au méchanisme d'héritage via le champ crossref.

Il propose également un champ bookineditor pour préciser l'éditeur du livre ancien lorsqu'il ne s'agit pas de l'auteur de l'entrée englobante.

Chargement

Le fait que le package propose un nouveau champ implique qu'il ne puisse pas être chargé comme un package LaTeX, via \usepackage mais comme un style bibliographique biblatex, c'est-à-dire à travers l'option bibstyle.

Par conséquent à la place de mettre :

\usepackage{biblatex-bookinarticle}

utiliser :

\usepackage[citestyle=citationstyle,bibstyle=bookinother]{biblatex}

Le package charge automatiquement le style bibliographique verbose.bbx, (bibstyle), ce qui implique que si vous utilisez les styles bibliographiques verbose-xxx ou authortitle-xxx vous n'avez pas de souci à vous faire.

Si vous utilisez un autre style bibliographique, utilisez biblatex-multiple-dm. Cependant, n'oubliez pas que les styles des nouvelles entrées sont calqués sur les styles des entrées standards de biblatex. Il vous faudra sans doute adapter les « drivers » bibliographiques des nouvelles entrées.

Il vous faudra également utiliser biblatex-multiple-dm si vous souhaitez utiliser d'autres packages définissant des nouveaux champs, tel que biblatex-manuscripts-philology.

Plus d'éditeur.rice.s avec biblatex-morenames

Maïeul — 2016-04-11T06:30:00Z

Biblatex propose en standard un champ editor permettant de préciser l'éditeur.rice d'un ouvrage (qu'il s'agisse d'un livre ancien ou d'un collectif). Il propose également un champ editortype permettant de préciser la fonction éditorial de l'editor. Cependant le lien de l'editor avec l'entrée est fixée à l'avance. Ainsi, pour une entrée @collection, editor désigne la personne qui a supervisé la construction du volume. Cependant si ce volume s'inscrit dans un projet plus global, un @mvcollection il n'est pas possible d'indiquer qui a supervisé le projet global.

D'autres cas peuvent se produire. Le package biblatex-morenames propose donc de nouveaux champs dérivés du champs editor.

Le champ `maineditor`

Signification

Pour une entrée @collection ou @incollection, le champs editor désigne l'éditeur du volume, alors que le champs maineditor désigne l'éditeur / superviseur pour l'entrée @mvcollection ;
de même pour une entrée @inproceedings ou @proceedings vis-à-vis d'une entrée @mvproceedings ;
de même pour une entrée @inreference ou @reference vis-à-vis d'une entrée @mvreference.

Héritage

Il est conseillé d'utiliser le mécanisme d'héritage de biber. Le champ maineditor d'une entrée collection étant hérité du champ editor de l'entrée @mvcollection.

Le schéma ci-dessus résume l'héritage.

Héritage lié à maineditor

Exemple

Soit les entrées bibliographiques suivantes :

@mvcollection{HistoireduChristianisme, Address = {Paris}, Editor = {Pietri, Charles and Pietri, Luce and Vauchez, André and Venard, Marc and Mayeur Jean-Marie}, Publisher = {Desclée}, Subtitle = {des origines à nos jours}, Title = {Histoire du christianisme}, Year = {1992/2001}, Volumes = {20}} @collection{Pietri1998, Crossref = {HistoireduChristianisme}, Date-Added = {2014-11-05 12:44:24 +0000}, Date-Modified = {2014-11-13 20:10:06 +0000}, Editor = {Luce Pietri}, Title = {Les Églises d'Orient et d'Occident}, Volume = {3}, Year = {1998}} @incollection{Maraval1998, Author = {Pierre Maraval}, Crossref = {Pietri1998}, Pages = {107-145}, Title = {La réception de Chalcédoine dans l'empire d'Orient}}

Donne le résultat suivant pour l'entrée Maraval1998 :

Pierre MARAVAL, « La réception de Chalcédoine dans l'empire d'Orient », in : Histoire du christianisme : des origines à nos jours, sous la dir. de Charles PIETRI et al., t. 3 : Les Églises d'Orient et d'Occident, sous la dir. de Luce PIETRI, 20 t., Paris : Desclée, 1998, p. 107–145

Les champs `ineditor` et `bookineditor`

Signification

Pour une entrée @article, ou une entrée @inbook entrée, le champ ineditor signifie l'éditeur d'une contribution individuelle, tandis que le champ editor signifie l'éditeur du volume global.

Pour une entrée @bookinbook, bookineditor signifie l'éditeur du livre (ancien) édité, tandis que editor signifie l'éditeur du volume global.

Exemple

Le volume Hagiographica Cypria du Corpus Christianorum Series Graeca contient trois textes :

deux édités par Peter Van Deun (Laudatio Barnabae et Περίοδοι καὶ μαρτύριον τῶν ἁγίων ἀποστόλων Βαρθολομαίου καὶ Βαρνάβα) ;
un édité par Jacques Noret (Vita Auxibii).

On peut donc considérer que Jacques Noret et Peter Van Deun sont les éditeurs du volume. On va les mettre tous les deux dans le champs editor, tandis que chacun d'entre eux sera mis dans le champ bookineditor de leur entrées respectives.

On peut donc proposer pour la Laudatio Barnabae les entrées suivantes :

@bookinbook{BHG226, Author = {{Alexandre de Chypre}}, Crossref = {CCSG26}, Bookineditor = {Van Deun, Peter}, Pages = {83-122}, Title = {Laudatio Barnabae}
}
@book{CCSG26, Editor = {Peter Van Deun and Jacques Noret}, Number = {26}, Series = {Corpus Christianorum Series Graeca}, Title = {Hagiographica Cypria}}

Pour l'entrée BHG226 on obtient le résultat suivant :

ALEXANDRE DE CHYPRE, Laudatio Barnabae, sous la dir. de Peter VAN DEUN, in : Hagiographica Cypria, sous la dir. de Peter VAN DEUN et Jacques NORET, Corpus Christianorum Series Graeca 26, p. 83–122

Héritage

L'héritage est relativement classique, les champs étant simplement transmis de l'entrée principale à l'entrée secondaire.

Héritage lié au champ bookineditor

Chargement du package

Le package ajoutant de nouveau champs, il doit se charger comme un style bibliographique (bibstyle) :

\usepackage[citestyle=citationstyle,bibstyle=morenames]{biblatex}

Si vous utilisez un autre style bibliographique, utilisez biblatex-multiple-dm. Il vous faudra sans doute adapter les « drivers » bibliographiques pour ajouter les nouveaux champs.

Il vous faudra également utiliser biblatex-multiple-dm si vous souhaitez utiliser d'autres packages définissant des nouveaux champs, tel que biblatex-manuscripts-philology.

Installer et utiliser BibLaTeX et Biber sous Windows avec MiKTeX

Maïeul — 2015-03-10T22:21:23Z

Dans mon livre, je propose d'utiliser Biber plutôt que BibTeX, en combinaison avec BibLaTeX. Malheureusement, Biber n'est pas installé par défaut avec les versions simplifiées de MiKTeX, la distribution la plus répandue de LaTeX sous Windows, et surtout n'est pas accessible par défaut dans TeXworks. Voici donc un petit tutoriel sur la manière d'utiliser Biber sous Windows avec MiKTeX.

Préalable

MikTeX est disponible en deux versions : une version « basic » et une version « complète ». Dans mon livre, la personne qui avait rédigé le tutoriel d'installation proposait d'utiliser la version basic. C'était malheureusement un mauvais choix, car cette version est trop basique, et ne contient pas certains outils indispensables [1].

En théorie MikTeX propose un outils pour installer à la volet les packages, au moment de la compilation. Cependant cela pose deux soucis :

bien souvent l'installation à la volée est bloquée par l'antivirus. Parfois on voit la fenêtre demandant l'autorisation d'installation, mais cela ne fonctionne pas systématiquement.

Message d'antivirus
de tout façon Biber n'est pas un package, mais un logiciel. Par conséquent son installation à la volée ne peut pas se faire.

La meilleure solution est donc d'utiliser le MiKTeX Package Manager, que vous trouverez normalement dans le dossier « MiKTeX » du menu « Démarrer ».

Installation d'un package / logiciel avec MiKTeX Package Manager

La fenêtre du logiciel propose un liste des modules (Packages, classes, logiciels) disponibles, qu'ils soient déjà installés ou non. La fenêtre permet de rechercher par nom.

Ainsi, nous pouvons rechercher le package BibLaTeX.

Recherche d'un package dans le gestionnaire de Package MiKTeX

Un clique droit sur le package permet de procéder à l'installation.

Accès à l'installation d'un package

Un fois l'option choisi, il reste à valider l'installation dans la fenêtre qui s'ouvre, et à attendre la fin du processus d'installation avant de clore la fenêtre.

Installation d'un module

Il faut procéder de la même façon pour Biber [2].

Configuration de TeXWorks

Une fois Biber installé, il faut pouvoir l'utiliser.

Biber est un logiciel (comme XeLaTeX ou pdfLaTeX). Il peut être exécuté directement depuis TeXworks, mais pour cela il faut configurer ce dernier.

Il faut se rendre dans le menu édition pour accéder aux préférences de TeXworks.

Accéder à la configuration de TeXWorks

On se rendra ensuite dans l'onglet « Composition », et on ajoutera un nouveau outil de composition en cliquant sur le + de la sous-fenêtre « Outils de Traitement »

Panneau de préférence de TeXworks

On va donc ajouter l'accès rapide à Biber. Dans la fenêtre qui apparaît, mettre :

biber comme nom de l'outil (c'est donc le nom qui apparaîtra dans TeXworks)
biber comme nom de programme (c'est donc le programme que Texworks appellera)
$basename parmi les arguments (cela signifiera que TeXworks indiquera à biber de travailler sur le fichier courant, en supprimant l'extension).

Ajout de Biber dans TeXworks

Appel à biber dans TeXworks

Après avoir fermé toute les fenêtres de configuration, vous verrez que le menu de composition propose désormais un accès à biber.

Accès à biber depuis TeXworks

Il vous suffira donc de l'appeler après l'exécution de (X^e)LaTeX, puis de rappeler (X^e)LaTeX. Évidemment à terme on préféra apprendre à utiliser la ligne de commande pour utiliser LaTeXmk (voir Annexe de mon livre).

[1] La prochaine version du livre ne devrait plus proposer cette installation.

[2] J'imagine qu'il doit être possible d'installer plusieurs modules à la fois en sélectionnant dans la fenêtre de listage, mais je n'ai pas essayé.

Gestions des œuvres anonymes : méthode encore plus simple

Maïeul — 2014-10-27T14:55:57Z

J'avais proposé dans un article comment gérer des œuvres anonymes. J'avais également indiqué dans un autre article comment procéder à un tri des œuvres anonymes. Les deux contributions avaient été fusionnées en un package.

En voulant améliorer ce package, je me suis aperçu qu'il y avait une méthode beaucoup plus simple. Explication.

Préambule : à quoi répond cet article

Cet article est une documentation technique du package biblatex-anonymous. Il permet de montrer comment il fonctionne. Il peut vous être utile pour créer vos propre personnalisation. Cependant si vous souhaitez simplement gérer les œuvres anonymes, utilisez plutôt le package, directement.

Nos besoins

Nous voulons que pour certains types d'entrées seul le champ author soit utilisé :

Comme référent pour le classement bibliographique.
Comment auteur dans la version longue de la référence bibliographique.
Comme label pour les versions courtes de la référence bibliographique.

Autrement dit, nous ne voulons pas que dans les trois cas sus-mentionné, l'éditeur ou le traducteur soit utilisé si l'auteur est absent.

Des options bien utiles

Mes précédents contributions consistaient à modifier chacun de ces points. Or il se trouve que BibLaTeX, que je ne connaît décidément pas assez, propose nativement un outil pour gérer ces cas.

Il s'agit des options :

useeditor
usetranslator

Ces options peuvent être définie :

Au niveau du chargement de biblatex, comme options de package.
Au niveau de chaque entrée, via le champ spécifique options.
Par type d'entrée, via \ExecuteBibliographyOptions.

Les types d'entrées susceptibles de nous intéressées sont celles qui se référent à des œuvres anciennes, autrement où l'editor est un éditeur et pas un directeur de publication.

Il s'agit donc des entrées de type :

book
bookinbook
bookinarticle
bookinincollection
mvbook
inbook

On va donc régler ces options à false pour ces deux entrées :

\ExecuteBibliographyOptions[book, bookinbook, bookinarticle, bookinincollection, mvbook,inbook]{useeditor=false,usetranslator=false}

Un tri simplifié

Cette contribution ne rend pas obsolète la nécessité de définir un schéma de tri spécifique pour classer les sources anonymes avant les sources non anonymes. Cependant cela simplifie le problème, en évitant de s'éloigner trop du modèle classique nty.

Rappelons que ce schéma de tri est ainsi défini dans le fichier biblatex.def :

\DeclareSortingScheme{nty}{ \sort{ \field{presort} } \sort[final]{ \field{sortkey} } \sort{ \field{sortname} \field{author} \field{editor} \field{translator} \field{sorttitle} \field{title} } \sort{ \field{sorttitle} \field{title} } \sort{ \field{sortyear} \field{year} } \sort{ \field[padside=left,padwidth=4,padchar=0]{volume} \literal{0000} } }

Cela indique qu'on trie d'abord le champ presort, puis le champ sortkey. Si ce dernier champ est défini, on arrête là le tri.

Puis on tri le champ suivant : sortname, ou à défaut author, ou à défaut editor, ou à défaut translator, ou à défaut sorttitle, ou à défaut title.

Ensuite on tri le champ sorttitle, ou à défaut, title. Vient après le tri de sortyear ou à défaut de year. Finalement on tri le champ volume, completé à gauche par des 0, ou à défaut de ce champ, on prend la valeur 0000. Ce qui signifie qu'un ouvrage avec un volume sera classé après un ouvrage sans volume, toutes choses égales par ailleurs [1]

Dans le cas qui nous intéresse le fait d'avoir désactiver, pour certain types d'entrées, les champs editor et translator amène à ce que pour ces entrées on trie sortname ou à défaut par author ou à défaut sorttitle, ou à défaut title. Autrement dit, pour ces types d'entrées, nous n'avons pas :

\sort{ \field{sortname} \field{author} \field{editor} \field{translator} \field{sorttitle} \field{title} }

mais

\sort{ \field{sortname} \field{author} \field{sorttitle} \field{title} }

Pour notre schéma de tri anonymous, nous souhaitons qu'en l'absence de sortname ou de author ou de editor ou de translator, ce ne soit ni la valeur de sorttitle ni celle de title, mais une valeur égale à 0000, ce qui nous assure d'avoir les œuvres anonymes avant celles ayant un auteur.

Il nous faut donc remplacer

\sort{ \field{sortname} \field{author} \field{editor} \field{translator} \field{sorttitle} \field{title} }

par

\sort{ \field{sortname} \field{author} \field{editor} \field{translator} \literal{0000} }

Ainsi notre tri anonyme se définit ainsi :

\DeclareSortingScheme{anonymous}{ \sort{ \field{presort} } \sort[final]{ \field{sortkey} } \sort{ \field{sortname} \field{author} \field{editor} \field{translator} \literal{0000} } \sort{ \field{sorttitle} \field{title} } \sort{ \field{sortyear} \field{year} } \sort{ \field[padside=left,padwidth=4,padchar=0]{volume} \literal{0000} } }

Il nous reste plus qu'à passer l'option sorting=anonyme lors du chargement de biblatex ou à notre commande \printbibliography, la première option étant recommandée si on ne désire pas avoir des bibliographies triées selon des schémas différents.

Éditeur ou directeur

Bien que cela ne directement lié à notre problème, on peut modifier les chaînes pour indiquer éditeur ou directeur selon le cas. Mais plutôt que d'utiliser des test booléens compliqués, il suffit de faire :

\DefineBibliographyStrings{french}{% byeditor = % {\ifuseeditor{dir\adddotspace}{éd\adddot}}, }

Ces deux morceaux de codes se retrouvent tels quels dans la version 2.0.0 du package biblatex-anonymous.

Des vrais op. cit.

En revanche si j'utilise la contribution pour avoir des vrais op. cit., j'ai un problème : puisqu'il n'y a pas de LabelName aux œuvres anonymes, toutes les œuvres anonymes sont considérées comme du même auteur, et donc la commande \ifsingletitle renvoie invariablement true, ce qui fait que l'on ne peut distinguer les œuvres anonymes, puisqu'elles sont toutes résumées en op. cit. sans que le titre soit affichés.

C'est pourquoi, on lieu de redéfinir la macro cite:title

On va pour cela utiliser le package xpatch

\xpatchbibmacro% {cite:title}% {\printfield[citetitle]{labeltitle}}% {\ifboolexpr{test{\ifsingletitle} and not test {\ifnameundef{labelname}}}{}{\printfield[citetitle]{labeltitle}}}% {}% {}%

D'un point de vue technique, ces réglages influent sur le résultat renvoyé par \ifuseeditor{}{} et \ifusetranslator{}{}.

Les styles standards de BibLaTeX appellent ces commandes dans les macros de type author/editor mais pas dans celles de types byauthor/byeditor.

Ces réglages changent aussi le fonctionnement de biber.

[1] Ce « toutes choses égales par ailleurs » n'arrive en réalité pas dans la pratique.

Entrées @inbook, crossref et formes abrégées

Maïeul — 2014-05-08T13:17:00Z

Loïs a posé une question relative à l'usage des formes abrégées avec les entrées de type @inbook. Il s'agissait, lorsqu'on l'on cite une sous-entrée @inbook d'une entrée @book déjà citée, d'afficher la forme latine abrégée de l'entrée @book.

Le problème se résout accès rapidement, une fois que l'on sait où chercher. Je vous propose donc ici la solution.

Le problème

Soit les entrées suivantes :

@book{Genette1992, Editor = {Gérard Genette}, Location = {Paris}, Pagetotal = {245}, Publisher = {Seuil}, Title = {Esthétique et poétique}, Year = {1992}} @inbook{Dickie1992, Author = {George Dickie}, Crossref = {Genette1992}, Pages = {9-32}, Title = {Définir l'art}, Titleaddon = {1973}}

On suppose que la gestion des crossref se fait avec Biber.

Soit, en utilisant le style de citation verbose-trad2, les appels suivants :

\cite{Genette1992} \cite[24]{Dickie1992}

Avec les styles par défauts on obtient le résultat suivant :

Gérard Genette, ed. Esthétique et poétique. Paris : Seuil, 1992. 245 pp.

George Dickie. “Définir l'art”. 1973. In : Esthétique et poétique. Ed. by Gérard Genette. Paris : Seuil, 1992, pp. 9–32, p. 24

Le souhait de Loïs était d'obtenir :

Gérard Genette, ed. Esthétique et poétique. Paris : Seuil, 1992. 245 pp.

George Dickie. “Définir l'art”. 1973. In : ibid p. 24

Un problème d'analyse

Il faut bien comprendre que lorsque le champ crossref est utilisé, cela ne veut pas dire, par défaut, que lors de l'affichage d'une entrée-fille on renvoie vers l'entrée mère, mais bien que les champs de l'entrée-mère sont recopiés dans l'entrée-fille. C'est ce qui permet notamment de faire passer, avec biber et non pas avec BibTeX, le champ title de l'entrée-mère vers booktitle de l'entrée-fille.

Ce phénomène de transfert peut être visualisé ou bien constaté en ouvrant le fichier .bbl produit par biber. Dans notre cas, on y voit la description de l'entrée Dickie1992 :

\entry{Dickie1992}{inbook}{} \name{labelname}{1}{}{% {{hash=fef82f30fe2bfa35216fc92c560ae872}{Dickie}{D\bibinitperiod}{George}{G\bibinitperiod}{}{}{}{}}% } \name{author}{1}{}{% {{hash=fef82f30fe2bfa35216fc92c560ae872}{Dickie}{D\bibinitperiod}{George}{G\bibinitperiod}{}{}{}{}}% } \name{editor}{1}{}{% {{hash=a7761d3fd65ea36d5c84d114d588896b}{Genette}{G\bibinitperiod}{Gérard}{G\bibinitperiod}{}{}{}{}}% } \list{location}{1}{% {Paris}% } \list{publisher}{1}{% {Seuil}% } \strng{namehash}{fef82f30fe2bfa35216fc92c560ae872} \strng{fullhash}{fef82f30fe2bfa35216fc92c560ae872} \field{sortinit}{D} \field{labeltitle}{Définir l'art} \field{booktitle}{Esthétique et poétique} \strng{crossref}{Genette1992} \field{pagetotal}{245} \field{title}{Définir l'art} \field{titleaddon}{1973} \field{year}{1992} \field{pages}{9\bibrangedash 32} \endentry

Le comportement par défaut ne pouvait donc pas être celui souhaité par Loïs, puisque ce serait aller à l'encontre la logique « de base » des crossref. Cependant on peut ruser.

La solution

Le style par défaut

J'explique dans mon livre que l'affichage final des entrées se fait à l'aide de « drivers » bibliographique, par type d'entrée [1].

On trouve assez facilement le fichier les contenant, en suivant les renvois entre fichiers (voir mon intervention dans les grottes). Dans le cas des styles de la famille verbose, les drivers sont présents dans le fichier standard.bbx. Voici celui pour les entrées de type @inbook :

\DeclareBibliographyDriver{inbook}{% \usebibmacro{bibindex}% \usebibmacro{begentry}% \usebibmacro{author/translator+others}% \setunit{\labelnamepunct}\newblock \usebibmacro{title}% \newunit \printlist{language}% \newunit\newblock \usebibmacro{byauthor}% \newunit\newblock \usebibmacro{in:}% \usebibmacro{bybookauthor}% \newunit\newblock \usebibmacro{maintitle+booktitle}% \newunit\newblock \usebibmacro{byeditor+others}% \newunit\newblock \printfield{edition}% \newunit \iffieldundef{maintitle} {\printfield{volume}% \printfield{part}} {}% \newunit \printfield{volumes}% \newunit\newblock \usebibmacro{series+number}% \newunit\newblock \printfield{note}% \newunit\newblock \usebibmacro{publisher+location+date}% \newunit\newblock \usebibmacro{chapter+pages}% \newunit\newblock \iftoggle{bbx:isbn} {\printfield{isbn}} {}% \newunit\newblock \usebibmacro{doi+eprint+url}% \newunit\newblock \usebibmacro{addendum+pubstate}% \setunit{\bibpagerefpunct}\newblock \usebibmacro{pageref}% \newunit\newblock \iftoggle{bbx:related} {\usebibmacro{related:init}% \usebibmacro{related}} {}% \usebibmacro{finentry}}

Sa redéfinition

C'est ce driver que nous allons redéfinir, dans notre préambule.

Dans notre affichage final, la partie que nous souhaitons modifier est comprise entre le « in » (exclu) et le numéro de page (exclu). Cela correspond, dans le driver à la partie compris entre le \usebibmacro{in:} (l. 12) et le \usebibmacro{chapter+pages} (l. 34).

Par ailleurs, il est possible d'avoir des entrées @inbook sans utilisation du crossref (même si c'est à déconseiller). C'est pourquoi nous allons conserver ce code dans une macro adhoc, que l'on appellera inbookwithoutcrossref :

\newbibmacro{inbookwithoutcrossref}{% \usebibmacro{bybookauthor}% \newunit\newblock \usebibmacro{maintitle+booktitle}% \newunit\newblock \usebibmacro{byeditor+others}% \newunit\newblock \printfield{edition}% \newunit \iffieldundef{maintitle} {\printfield{volume}% \printfield{part}} {}% \newunit \printfield{volumes}% \newunit\newblock \usebibmacro{series+number}% \newunit\newblock \printfield{note}% \newunit\newblock \usebibmacro{publisher+location+date}% }

Pour afficher l'entrée mère sous une forme abrégée, nous utilisons tout simplement une commande \cite, que nous encapsulons dans une macro inbookwithcrossref. Nous passons comme argument à la commande la valeur du champ crossref de l'entrée-fille, qui correspond à la clef bibliographique de l'entrée-mère. Cette valeur est récupérée via \thefield{crossref}. Cela donne donc :

\newbibmacro{inbookwithcrossref}{% \cite{\thefield{crossref}}% }

Il ne nous reste plus qu'à supprimer les lignes 13 à 33 de notre driver, en appelant à la place la macro inbookwithcrossref ou inbookwithoutcrossref, selon que le champ crossref est défini ou non, le test se faisant avec la commande \iffieldundef. Ce qui donne la définition suivante de notre driver :

\DeclareBibliographyDriver{inbook}{% \usebibmacro{bibindex}% \usebibmacro{begentry}% \usebibmacro{author/translator+others}% \setunit{\labelnamepunct}\newblock \usebibmacro{title}% \newunit \printlist{language}% \newunit\newblock \usebibmacro{byauthor}% \newunit\newblock \usebibmacro{in:}% \iffieldundef{crossref}{\usebibmacro{inbookwithoutcrossref}}{\usebibmacro{inbookwithcrossref}}% \newunit\newblock \usebibmacro{chapter+pages}% \newunit\newblock \iftoggle{bbx:isbn} {\printfield{isbn}} {}% \newunit\newblock \usebibmacro{doi+eprint+url}% \newunit\newblock \usebibmacro{addendum+pubstate}% \setunit{\bibpagerefpunct}\newblock \usebibmacro{pageref}% \newunit\newblock \iftoggle{bbx:related} {\usebibmacro{related:init}% \usebibmacro{related}} {}% \usebibmacro{finentry}}

Vous constatez la ligne modifiée : l. 13.

Le résultat à l'affichage est le suivant :

Gérard Genette, ed. Esthétique et poétique. Paris : Seuil, 1992. 245 pp.

George Dickie. “Définir l'art”. 1973. In : ibid., p. 24, pp. 9–32, p. 24

Affinage

La solution est presque parfaite, mais vous pouvez vous rendre compte que le numéro de page est affichée deux fois. La raison est assez subtile : lors de l'utilisation de la commande \cite dans le driver bibliographique, pour appeler l'entrée-mère, le champ postnote est récupéré du contexte, c'est à dire qu'il s'agit du champ postnote de l'entrée-fille. La solution consiste à vider ce champ à l'intérieur de la macro inbookwithcrossref, avec la commande \clearfield. Il faut faire de même pour le champ prenote. Ce qui donne :

\newbibmacro{inbookwithcrossref}{% \clearfield{prenote}% \clearfield{postnote}% \cite{\thefield{crossref}}% }

Notre résultat final est alors correct :

Gérard Genette, ed. Esthétique et poétique. Paris : Seuil, 1992. 245 pp.

George Dickie. “Définir l'art”. 1973. In : ibid., pp. 9–32, p. 24

Vous constaterez aisément, en faisant des tests, que ma solution fonctionne aussi avec des abréviations de type op. cit..

[1] Sauf cas d'alias entre types d'entrée.

Gérer des champs supplémentaires

Maïeul — 2013-03-04T23:16:17Z

Les champs par défaut de BibLaTeX sont en général largement suffisants. Cependant on pourrait avoir envie d'en utiliser d'autres, personnalisés. Voici un petit tutoriel sur le sujet.

Le problème

Il est fréquent dans certain domaines d'avoir des bibliographies de référence, attribuant un code à des textes anciens. Ainsi pour la littérature chrétienne ancienne nous avons :

Bibliotheca hagiographica graeca (BHG)
Bibliotheca hagiographica latina (BHL)
Clavis Patrum Graecorum (CPG)
Clavis Patrum Latinorum (CPL)
Clavis Apocryphorum Novi Testamenti (CANT)

Il est parfois plus simple de retenir un texte par son numéro dans l'une de ces claves plutôt que par son titre complet. On peut donc souhaiter afficher ce numéro dans la bibliographie.

Une solution possible est d'utiliser le champ addendum. Cependant, on ne garanti pas ainsi une présentation uniforme, notamment lorsqu'un texte se voit attribuer plusieurs de ces numéros.

Une autre solution est de créer des champs spéciaux, puis de les utiliser. C'est ce que je vais faire ici [1].

Notre exemple

Il s'agit des Actes de Barnabé qui portent le numéro CANT 285 et le numéro BHG 225. En base de donnée, nous le stockons ainsi :

@bookinbook{BHG225, Bhg = {225}, Cant = {285}, Editor = {Maximilien Bonnet}, Booktitle={Acta Apostolorum Apocrypha}, Year={1903}, Volume={2.2}, Publisher={Hermann Mendelssohn}, Location={Leipzig}, Pages = {292-302}, Title = {Acta Barnabae}}

En l'absence de tout réglage pour les champs bhg et cant, nous obtenons l'affichage suivant :

Acta Barnabae, in Acta Apostolorum Apocrypha, éd. Maximilien Bonnet, t. 2.2, Leipzig : Hermann Mendelssohn, 1903, p. 292–302

Nous souhaiterions obtenir quelque chose de la forme :

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

Transférer les champs

Il faut savoir que s'il est possible de déclarer des champs non standards dans biblatex, il n'est pas possible de les utiliser tels quels. Ainsi, il est pour le moment impossible d'avoir une commande de type \printfield{bhg}.

Dès lors la solution pour se servir des champs non standards est de « transférer » leurs valeurs vers un champ standard. Ce champ pourrait être par exemple un des champs libre de type userb. Pour ma part, j'ai choisi de les transférer mes champs vers le champs addendum.

Pour comprendre le principe du transfert, il faut se rappeler que biblatex ne lit pas le fichier .bib directement, mais qu'il lit le fichier .bbl produit par Biber à partir du fichier .bib. Par exemple, dans le cas présent, notre fichier .bbl contient l'entrée :

\entry{BHG220}{bookinbook}{} \name{labelname}{1}{}{% {{hash=7cbcda25a11c69ef442ceab55eea1d41}{Bonnet}{B\bibinitperiod}{Maximilien}{M\bibinitperiod}{}{}{}{}}% } \name{editor}{1}{}{% {{hash=7cbcda25a11c69ef442ceab55eea1d41}{Bonnet}{B\bibinitperiod}{Maximilien}{M\bibinitperiod}{}{}{}{}}% } \list{location}{1}{% {Leipzig}% } \list{publisher}{1}{% {Hermann Mendelssohn}% } \strng{namehash}{7cbcda25a11c69ef442ceab55eea1d41} \strng{fullhash}{7cbcda25a11c69ef442ceab55eea1d41} \field{sortinit}{B} \field{labeltitle}{Acta Barnabae} \field{booktitle}{Acta Apostolorum Apocrypha} \field{pubstate}{submitted} \field{title}{Acta Barnabae} \field{usera}{1} \field{volume}{2.2} \field{year}{1903} \field{pages}{292\bibrangedash 302}

Comme vous pouvez le voir, les entrées sont formatées selon une norme propre à Biber, que Biblatex va pouvoir lire. L'enjeu pour nous est de rajouter une ligne \field{addendum}{BHG 225 ; CANT 285}.

Pour cela nous allons déclarer un mappage [2] bibliographique, c'est à dire une manière de faire correspondre des champs d'une source (par exemple un fichier .bib ou un BDD Zotero) à des champs du fichier .bbl.

Pour ce faire, on utilise la commande \DeclareSourcemap. Celle-ci contient une ou plusieurs commandes \maps, qui indique un mappage. On peut préciser dans les options de la commande \map les conditions d'applications du mappage. Cela peut-être par exemple le type de fichier source (bibtex, zotero etc.) ou bien le type d'entrée bibliographique (@article,@book etc.).

Chaque commande \maps contient une ou plusieurs commandes \map, lues dans l'ordre d'apparition, et qui précisent la manière dont des champs sont transformés. Chaque commande \map contient des commandes \step, qui indiquent les étapes pour procéder à la transformation du champ.

Tout ceci semble bien abscon, un exemple sera plus parlant. Ainsi je vous propose d'analyser le code suivant, que je met dans mon préambule :

\DeclareSourcemap{ \maps[datatype=bibtex]{ \map[overwrite]{ \step[fieldsource=bhg,final] \step[fieldset=addendum,fieldvalue={BHG~},append] \step[fieldset=addendum,origfieldval, append] } \map[overwrite]{ \step[fieldsource=cpg,final] \step[fieldset=addendum,fieldvalue={CPG~},append] \step[fieldset=addendum,origfieldval, append] } \map[overwrite]{ \step[fieldsource=bhl,final] \step[fieldset=addendum,fieldvalue={BHL~},append] \step[fieldset=addendum,origfieldval, append] } \map[overwrite]{ \step[fieldsource=cpl,final] \step[fieldset=addendum,fieldvalue={CPL~},append] \step[fieldset=addendum,origfieldval, append] } \map[overwrite]{ \step[fieldsource=cant,final] \step[fieldset=addendum,fieldvalue={CANT~},append] \step[fieldset=addendum,origfieldval, append] } } }

L. 1 : la commande pour déclarer des mappages [3].
L. 2 : la commande pour déclarer un mappage particulier, ici dans le cas où la source est au format .bib (bibtex).
L. 3, 8, 13, 18, 23 : les règles de mappage, à lire dans l'ordre. L'option overwrite indique que les règles peuvent modifier des valeurs de champ déjà définies. Analysons les lignes 4, 5, 6, le principe est le même pour les lignes 9, 10, 11 ; 14, 15, 16 ; 19, 20, 21 ; 24, 25, 26.
L. 4 On indique via fieldsource=bhg que l'on s'intéresse au champ bhg de la source (c'est à dire dans notre cas, du fichier .bib). Le final indique que si ce champ est absent, on arrête là cette règle de mappage, pour passer à la commande \map suivante.
L. 5 On ajoute BHG~ dans le champ addendum, à la suite du contenu déjà existant (option append).
L. 6 Dans le champ addendum, à la suite du contenu déjà existant, on ajoute le contenu du champ indiqué par le précédent fieldsource, c'est à dire dans notre cas du champ bhg. C'est l'option origfieldval qui nous indique d'aller chercher le contenu dans le précédent champ indiqué par fieldsource.

Si j'ai été clair, vous devriez comprendre qu'au final, notre champ addendum contiendra : BHG~225CANT~285. Si nous avions en outre défini un champ addendum dans notre fichier .bib, son contenu sera mis au début du champ addendum du fichier .bbl.

On souhaiterais maintenant insérer des points-virgules entre chaque entrée. On pourrait être tenter de modifier ainsi les lignes 5, 10, 15, 20, 25 :

\step[fieldset=addendum,fieldvalue={XXX~},append]

Toutefois ceci pose deux problèmes :

L'un assez mineur est qu'on inscrit « en dur » le séparateur de claves.
L'autre majeure est que l'on ajoute systématiquement le point-virgule, y compris s'il n'y a rien auparavant.

Pour résoudre ces deux problèmes, nous allons définir une nouvelle commande, \multiclavesseparator :

\newcommand{\multiclavesseparator}{\addsemicolon\ifpunct{\addspace}{}}

\addsemicolon insère un point-virgule uniquement si nous n'avons pas juste avant un signe de ponctuation. Cela évite d'avoir [4].
\ifpunct{\addspace}{} ajoute l'espace après le point-virgule s'il est affiché, rien sinon.

Il nous faut ajouter la commande dans nos lignes 5, 10, 15, 20, 25, ainsi :

\step[fieldset=addendum,fieldvalue={\noexpand\multiclavesseparator XXX~},append]

Le \noexpand est là pour éviter que le \multiclavesseparator soit interprété au moment de la lecture du fichier .tex. Il peut par conséquent se trouver tel quel dans le fichier .bcf [5] et par conséquent dans le fichier .bbl.

Ceci nous produit donc pour le moment

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

Styler le champ `addendum`

Maintenant que nous avons défini le contenu du champ addendum, il nous faut le modifier sa présentation, pour le mettre automatiquement entre parenthèse. On utilise pour cela la commande \DeclareFieldFormat.

\DeclareFieldFormat{addendum}{\mkbibparens{#1}}

Rien de bien sorcier : on indique simplement, via \mkbibparens de mettre entre parenthèse le contenu (#1) du champ. L'avantage d'utiliser \mkbibparens est double :

Si notre champ est vide, nous n'avons pas de parenthèses vides pour autant.
Si nous nous situons à l'intérieur d'une parenthèse, biblatex nous produira automatiquement des crochets.

Avec ceci, nous obtenons :

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

Cela n'est pas terrible :

Nous avons une virgule suivi d'une parenthèse.
Nous avons une espace après la parenthèse ouvrante, ce qui s'explique par le \ifpunct{\addspace}{}. La précédente ponctuation étant la virgule d'avant la parenthèse.

Que cela ne tienne, nous allons corriger ce qui est affiché avant la parenthèse. Pour cela, nous allons modifier la macro bibliographique addendum+pubstate, qui est actuellement définie ainsi (dans le fichier standard.bbx) :

\newbibmacro*{addendum+pubstate}{% \printfield{addendum}% \newunit\newblock \printfield{pubstate}}

Nous allons la modifier ainsi :

\renewbibmacro*{addendum+pubstate}{% \iffieldundef{addendum}{}{\nopunct}% \printfield{addendum}% \newunit\newblock \printfield{pubstate}}

La première ligne que nous avons ajoutée est assez simple : si nous avons un champ addendum, alors nous supprimons la ponctuation qui précède [6].

Et nous obtenons ainsi notre affichage final :

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

[1] Je conseille d'avoir lu les chapitres de mon livre concernant la personnalisation des styles biblatex pour comprendre certaines notions.

[2] Si quelqu'un trouve une meilleure traduction de « mapping », je suis preneur.

[3] Il existe des commandes spécifiques si vous souhaitez déclarer le mappage dans un fichier de style bibliographique plutôt que dans un fichier .tex.

[4] Voir La notion d'unité dans une référence bibliographique.

[5] Ce fichier, qui est produit lors de la compilation (X^e)LaTeX par le package biblatex, décrit les réglages que Biber devra utiliser.

[6] La documentation indique pour \nopunct : « Ajoute un marqueur interne qui aura pour conséquence que la commande suivante de ponctuation n'imprimera rien. » Il faut bien comprendre que les commandes de ponctuations sont interprétées \emphaprès les autres commandes (pour gérer notamment les unités bibliographiques). Par conséquence la commande suivante de ponctuation correspond à la ponctuation qui précéde.

Collection sous forme abrégée avec shortseries

Maïeul — 2012-08-14T12:17:27Z

BibLaTeX propose un champ shortseries servant à indiquer une version abrégée du champ series, c'est à dire de la collection. Par exemple, mettre « CCSA » pour « Corpus Christianorum Series Apocryphorum ».

Par défaut, BibLaTeX ne se sert pas de champ. Comment en tirer parti, notamment pour afficher un tableau des abréviations ?

Pourquoi utiliser ce champ

Je conseille d'utiliser shortseries en combinaison avec series, plutôt que de mettre directement la version abrégée dans series pour trois raisons :

C'est un champ standard, alors autant s'en servir.
Si on décide finalement afficher la forme longue de la collection, on aura simplement une ligne de code à supprimer.
On peut utiliser ce champ pour construire automatiquement une liste des formes abrégées, moyennant quelques lignes de code que je vais détailler dans cet article.

Les entrées de démonstration

Pour le présent article, nous utilisons les entrées suivantes :

@book{PtJc, Address = {Bruxelles}, Title = {La forme la plus ancienne du Protévangile de Jacques}, Year = {1961}} @book{CCSL149, Number = {140}, Series = {Corpus Christianorum Series Latina}, Shortseries = {CCSL}, Title = {Concilia Africae}} @book{CCSA9, Number = {9}, Series = {Corpus Christianorum Series Apocryphorum}, Shortseries = {CCSA}, Title = {Pseudo-Matthaei Evangelium}} @book{CCSA10, Number = {10}, Series = {Corpus Christianorum Series Apocryphorum}, Shortseries = {CCSA}, Title = {De Nativitate Mariae}}

Nous avons donc trois entrées avec une collection, et une sans collection [1].

Par défaut, la bibliographie affiche ceci :

Concilia Africae, Corpus Christianorum Series Latina 140.
De Nativitate Mariae, Corpus Christianorum Series Apocryphorum 10.
La forme la plus ancienne du Protévangile de Jacques, Bruxelles, 1961.
Pseudo-Matthaei Evangelium, Corpus Christianorum Series Apocryphorum 9.

Afficher la version abrégée de la collection

Nous allons modifier les styles pour afficher la version abrégée de la collection, si elle existe, à la place de la version longue.

Par défaut, le macro qui affiche la collection est la suivante [2] :

\newbibmacro*{series+number}{% \printfield{series}% \setunit*{\addspace}% \printfield{number}% \newunit}

Nous allons la modifier, en la redéfinissant ainsi :

\renewbibmacro*{series+number}{% \iffieldundef{shortseries}{\printfield{series}}{\printfield{shortseries}}% \setunit*{\addspace}% \printfield{number}% \newunit}

La seule modification est ligne 2 : nous testons le champ shortseries. S'il n'existe pas, nous affichons le champ series. Sinon, nous affichons le champ shortseries.

On obtient alors :

Concilia Africae, CCSL 140.
De Nativitate Mariae, CCSA 10.
La forme la plus ancienne du Protévangile de Jacques, Bruxelles, 1961.
Pseudo-Matthaei Evangelium, CCSA 9.

Comment afficher la liste des abréviations ?

Nous allons maintenant afficher la liste des abréviations. Plutôt que de recopier nous même cette liste, avec les risques inhérents d'erreurs , nous allons demander à BibLaTeX de la produire pour nous. Malheureusement il n'existe pas de commande standard sous BibLaTeX pour afficher une telle liste.

C'est pourquoi nous allons :

créer un nouveau type de tri, permettant de trier selon l'ordre du champ shortseries.
appliquer ce tri sur une commande \printbibliography. Attention : il vous faut avoir les versions de Biber et BibLaTeX supérieures à 2 pour pouvoir personnaliser le tri au cas par cas.
créer un « bibcheck » pour tester les entrées selon les conditions suivantes :
1. avoir les champs shortseries et series définis.
2. ne pas avoir un champ series déjà affiché dans la bibliographie.
appliquer ce bibcheck à la bibliographie.
créer un nouveau environnement bibliographique qui :
1. affiche la version abrégée de la série.
2. affiche la version longue de la série.
appliquer cette environnement à la bibliographie.

Trier selon le champ `shortseries`

J'ai expliqué dans un précédent article comment déclarer un nouveau type de tri.

Pour le cas présent, la déclaration à mettre dans le préambule est simple :

\DeclareSortingScheme{shortseries}{ \sort{ \field{shortseries} } \sort{ \field{series} } }

Nous trions d'abord selon le champ shortseries puis selon le champ series.

Il nous faut ensuite appeller ce tri sur la bibliographie :

\printbibliography[title=Liste des abréviations, sorting=shortseries]

Cela nous produit la liste suivante :

La forme la plus ancienne du Protévangile de Jacques, Bruxelles, 1961.
Pseudo-Matthaei Evangelium, CCSA 9.
De Nativitate Mariae, CCSA 10.
Concilia Africae, CCSL 140.

Filtrer les entrées

Nous avons deux problèmes :

Nous avons des entrées qui apparaissent alors qu'elles n'ont pas de champ shortseries
Nous avons plusieurs fois la même valeur pour le champ shortseries.

Nous allons donc utiliser defbibcheck pour déclarer un contrôle des entrées que l'on met dans la bibliographie.

\defbibcheck{shortseries}{% \iffieldundef{shortseries}{\skipentry}{}% \iffieldundef{series}{\skipentry}{% \ifcsdef{\strfield{series}}{\skipentry}{\savefieldcs{series}{\strfield{series}}}% }% Verifier si pas déjà existant } \DeclareSortingScheme{shortseries}{ \sort{ \field{shortseries} } \sort{ \field{series} } }

Nous appellons ce contrôle sur la bibliographie avec :

\printbibliography[title=Liste des abréviations, sorting=shortseries,check=shortseries]

Commentons rapidement :

L. 2 : S'il n'y a pas de champ shortseries, nous excluons l'entrée de la bibliographie (\skipentry).
L. 3 : Nous testons s'il existe un champ series :
1. L. 3 : Si ce champ n'existe pas, nous excluons l'entrée de la bibliographie.
2. L. 6 : Si ce champ existe, nous procédons à un test :
  1. Nous testons, via \ifcsdef l'existence d'une commande. Le nom de cette commande est la valeur du champ series, formaté pour pouvoir servir de nom de commande [3] : \strfield{series}.
    1. Si cette commande existe, nous excluons l'entrée de la bibliographie (\skipentry).
    2. Si elle n'existe pas, nous la créons, en lui donnant comme contenu la valeur du champ series : \savefieldcs{series}{\strfield{series}}.

Nous obtenons alors la bibliographie finale :

Pseudo-Matthaei Evangelium, CCSA 9.
Concilia Africae, CCSL 140.

Imprimer les équivalences

Il nous reste plus qu'à définir un nouvel environnement pour afficher correctement cette « bibliographie », c'est à dire en imprimant uniquement le champ shortseries et le champ series.

C'est là le code le plus complexe, car il nécessite de comprendre non seulement les fonctions de BibLaTeX, mais aussi la création de liste personnalisée.

Le voilà déjà :

\makeatletter \newlength{\shortserieswidth} \setlenght{\shorserieswidth}{4em} \defbibenvironment{shortseries} {\renewcommand{\blx@driver}[1]{\csuse{blx@bbx@series}}\list{\thefield{shortseries}% }{% \labelwidth\shorthserieswidth \labelsep\biblabelsep \leftmargin\bibhang \advance\leftmargin\labelsep \itemsep\bibitemsep \parsep\bibparsep \def\makelabel##1{##1\hss}}} {\endlist} {\item} \DeclareBibliographyDriver{series}{ \printfield{series} } \makeatother

Comme nous utilisons des commandes contenant le caractère @ dans leurs noms, nous devons entourer le code de \makeatletter et de \makeatother.

Le code est largement inspiré de l'environnement bibliographique shorthands de BibLaTeX.

L. 2-3 nous créons une longueur, \shortserieswidth, valant 4 em. Cette longueur sera affectée à l'espace dans lequel s'inscrira la version abrégée de la collection. Cela nous permet d'avoir des abréviations allant jusqu'à 4 caractères [4].

L. 4 Nous commençons à définir un environnement shortseries. Les trois options qui suivent correspondent respectivement :

au code à mettre en début de bibliographie, en excluant le titre (l. 5-13).
au code à mettre en fin de bibliographie (l. 14) .
au code à mettre pour chaque élément de la bibliographie (l. 15).

En début de bibliographie, nous déclarons que, pour cette bibliographie, l'impression d'une entrée se fera à partir du driver series. Nous déclarons cela avec \renewcommand{\blx@driver}[1]{\csuse{blx@bbx@series}}. Ce sont des commandes de bas niveau, que je vous déconseille en général de manipuler. Dans le cas présent, je n'ai pas trouvé de commande de plus haut niveau. Merci de me signaler si vous voyiez mieux.

Nous commençons alors une liste, à l'aide de la commande de bas niveau \list{\thefield{shortseries}} [5]. Le label de chaque entrée de la liste correspondra au champ shortseries. Les paramètres de cette liste sont définis l. 7-13.

Ce sont les paramètres suivants :

\labelwidth : taille consacrée au label, ici égale à \shorthserieswidth.
\labelsep distance entre le label et le contenu de l'entrée, ici égale à la longueur \biblabelsep, qui est définie par BibLaTeX.
\leftmargin la marge gauche de la liste, ici égale à \bibhang, définie par BibLaTeX, auquel on ajoute \labelsep (c'est le code \advance\leftmargin\labelsep).
itemsep : espace entre les éléments de la liste, ici égale à bibitemsep, définie par BibLaTeX.
parsep : espace entre les paragraphes dans la liste, ici égale à bibparsep, définie par BibLaTeX.
quant à \def\makelabel##1{##1\hss} cela indique que les label (donc dans notre cas les collections abrégées) sont alignés sur la gauche [6].

À la fin de l'environnement bibliographique, nous fermons la liste : \endlist.

Enfin pour chaque entrée de la bibliographie, nous insérons un \item (l. 15).

Il ne nous reste plus qu'à définir un « driver » series, qui se contente d'afficher le champ series :

\DeclareBibliographyDriver{series}{ \printfield{series} }

Nous appelons donc notre commande \printbibliography ainsi :

\printbibliography[sorting=shortseries,title=Liste des abréviations,check=shortseries,env=shortseries]

Et nous obtenons alors notre liste d'abréviations :

CCSA Corpus Christianorum Series Apocryphorum
CCSL Corpus Christianorum Series Latina

Il ne nous reste plus qu'à afficher notre bibliographie, avec une bête commande : \printbibliography.

[1] Pour ma part, j'ai opté pour le principe de mettre les noms de collections + numéro pour les « grandes collections » de texte source, et mettre adresse + éditeur + année pour les autres éditions. À vous de voir. Remarquez que vous pourriez remplir aussi les champs adress + publisher + year pour toutes les entrées et faire un test sur la présence du champ series pour ne pas les afficher le cas échéant.

[2] Dans le fichier standard.bbx.

[3] C'est à dire, par exemple, en ayant supprimé les accents et les espaces.

[4] En fait, cela ne limite pas : mais si une abréviation dépasse 4em de longueur, alors notre liste ne sera pas jolie, avec des décalages.

[5] Je n'ai pas encore eu le temps de rédiger un article sur la commande de bas niveau \list. Promis, vous aurez bientôt sur ce site quelque chose à ce propos.

[6] \hss permet d'insérer un espace élastique, prenant la taille maximale disponible. Cela permet d'aligner à gauche des élèments.

Tri des œuvres anonymes

Maïeul — 2012-07-17T08:01:34Z

Lorsqu'une bibliographie contient des œuvres anonymes, on peut souhaiter qu'elles soient toutes regroupées au même endroit. Voici comment faire.

Avant de lire cet article, il vous faut lire l'article sur la gestion des œuvres anonymes, pour avoir un affichage correct.

Soit les entrées suivantes :

@bookinbook{BreveHippone, Crossref = {ConciliaAfricae}, Entrysubtype = {concile}, Pages = {30-46}, Title = {Breviarum Hipponense}} @bookinbook{Ferrand, Author = {{Ferrand de Carthage}}, Crossref = {ConciliaAfricae}, Entrysubtype = {concile}, Pages = {287-306}, Title = {Breviatio Canonum}} @book{ConciliaAfricae, Editor = {Charles Munier}, Number = {149}, Series = {CCSL}, Title = {Concilia Africae}}

Si j'appelle ma bibliographie finale avec :

\printbibliography[subtype=concile]

J'obtiens le tri suivant :

Ferrand de Carthage, Breviatio Canonum, dans Concilia Africae, dir. Charles Munier, CCSL 149, p. 287–306.
Breviarum Hipponense, dans Concilia Africae, dir. Charles Munier, CCSL 149, p. 30–46.

Or j'aimerais que les sources anonymes soient positionnée en tout début. Comment faire ?

La mauvaise méthode

La mauvaise méthode consiste à utiliser le champ sortname, en modifiant ainsi les entrées anonymes :

@bookinbook{BreveHippone, Crossref = {ConciliaAfricae}, Entrysubtype = {concile}, Pages = {30-46}, Title = {Breviarum Hipponense}}

Cette méthode est mauvaise pour (au moins) deux raisons :

Elle suppose de ne pas oublier de renseigner le champ sortname et demande une vérification finale manuelle (ou l'utilisation de tests)
Elle implique qu'on insère dans la base de donnée le tri final. Or il peut arriver de vouloir avoir un autre tri, par exemple en gardant le tri standard.

La bonne méthode

Elle suppose de passer par Biber. Il s'agit de créer un ordre de tri personalisé (le manuel de BibLaTeX explique plus en détails).

Si je fouille le fichier biblatex.def, je trouve la définition du tri nyt, qui est le tri standard, triant par nom, puis par titre, puis par année.

\DeclareSortingScheme{nty}{ \sort{ \field{presort} } \sort[final]{ \field{sortkey} } \sort{ \field{sortname} \field{author} \field{editor} \field{translator} \field{sorttitle} \field{title} } \sort{ \field{sorttitle} \field{title} } \sort{ \field{sortyear} \field{year} } \sort{ \field[padside=left,padwidth=4,padchar=0]{volume} \literal{0000} } }

Je commente rapidement le code :

La première ligne indique que nous déclarons un schéma de tri (\DeclareSortingScheme) intitulé nty. Ce schéma est décrit dans les lignes qui suivent.
Chaque commande \sort indique un ordre de tri, les champs déclarés par \field à l'intérieur de ces commandes étant les champs servant au tri. Le système de tri teste chaque champ :
- Si un champ existe, biber note sa valeur dans sa mémoire pour le tri, sinon, il teste l'existence du champ suivant.
- Une fois que tous les champs d'un \sort ont été analysés et leurs valeurs mises dans la mémoire pour tri, biber procéde au tri.
  - Ainsi, on voit que le tri se fait d'abord suivant le champ presort, puis suivant le champ sortkey.
  - Si le champ sortkey est défini, on arrête là le tri (comme le montre l'option [final]).
  - Dans le cas contraire, on continue le tri on prenant pour clef de tri : le champ sortname, sinon author, sinon editor, sinon translator, sinon sortitle, sinon title.
  - Après avoir fait ce tri, on sous-trie chaque auteur par sorttitle ou par title.
\field[padside=left,padwidth=4,padchar=0]{volume} signifie que pour le tri, le champ volume reçoit des zéros sur sa gauche, de manière à former au plus 4 caractères. Ainsi 1 devient 0001, 10 devient 0010 et 100 devient 100. Ceci permet de procéder à un tri par ordre numérique, et non par ordre alphabétique [1].
La commande \literal signifie que Biber fait « comme si » un champ ayant la valeur passé en argument est pris en compte. Cette commande va nous être très utile.

Nous allons en effet déclarer un nouveau schéma de tri, anonyme.

Nous allons d'abord remplacer :

 \field{author} \field{editor} \field{translator}

Par :

\field{labelname}

Ceci permettra de trier suivant le pseudo-champ labelname. Par défaut ce pseudo champ vaut la valeur du premier champ existant dans l'ordre suivant : shortauthor,author,shorteditor,editor,translator. Cependant, pour les entrées de type @book, @bookinbook et @inbook nous allons le modifier, en faisant qu'il ne puisse être qu'égal à author, via :

\DeclareLabelname[book, inbook,bookinbook]{author}

ou pour les versions plus récentes de BibLaTeX

\DeclareLabelname[book, inbook,bookinbook]{ \field{author} }

Nous allons remplacer le premier :

 \field{sorttitle} \field{title}

par \literal{0000}

Ainsi en l'absence de champ labelname, donc pour les œuvres anonymes, notre entrée sera située en tête de tri.

Au final, cela donne ceci :

\DeclareLabelname[book, inbook,bookinbook]{author} \DeclareSortingScheme{anonyme}{ \sort{ \field{presort} } \sort[final]{ \field{sortkey} } \sort{ \field{sortname} \field{labelname} \literal{0000} } \sort{ \field{sorttitle} \field{title} } \sort{ \field{sortyear} \field{year} } \sort{ \field[padside=left,padwidth=4,padchar=0]{volume} \literal{0000} } }

Lors du chargement de biblatex, nous passons l'option sorting=anonyme pour dire de prendre ce tri.

\usepackage[mincrossrefs=0,bibstyle=verbose,citestyle=verbose-trad2,backend=biber,sorting=anonyme]

Ce qui nous donne correctement au final :

Breviarum Hipponense, dans Concilia Africae, dir. Charles Munier, CCSL 149, p. 30–46.
Ferrand de Carthage, Breviatio Canonum, dans Concilia Africae, dir. Charles Munier, CCSL 149, p. 287–306.

[1] Voir à ce sujet mon article sur les champs de tri, où j'explique le problème des tris numériques.

Vérification des filiations avec biblatex (2) : vérifier visuellement

Maïeul — 2012-01-02T22:57:44Z

Suite et fin de ma série sur la vérification des héritages de champs bibliographiques. Il s'agit cette fois de vérifier les héritages correctes, en produisant une représentation graphique de cet héritage. Pour ce faire il est nécessaire d'avoir Biber 1.1 minimal et le logiciel Graphviz. Il faut également passer par la ligne de commande.

Exemples

Dans cet article, j'utilise les entrées tirées de mon précédent article :

@book{ConciliaAfricae, Title = {Concilia Africae}, Editor = {Charles Munier}, Number = {149}, Series = {Corpus Christianorum Series Latina}} @bookinbook{BreveHippone, Crossref={ConciliaAfricae}, Pages = {30-46}, Title = {Breviarum Hipponense} } @bookinbook{BreveHippone36, Crossref = {BreveHippone}, Pages = {43}, Titleaddon = {36}} @bookinbook{ConcileHippone, Crossref={ConciliaAfricae}, Pages = {20-21}, Title = {Concilium Hipponense}}

Visualisation des héritages de type

Une fois mon fichier .tex compilé, je peux dire à biber de produire un fichier .dot, pour le logiciel Graphviz.

Pour ce faire, j'utilise la commande biber en lui passant l'option --outformat=dot --dot_include=crossref .

Ce qui donne concrètement :

--outformat=dot --dot_include=crossref xxx

où xxx est le nom (sans l'extension) du fichier .tex.

J'obtiens alors un fichier xxx.dot qu'il faut transformer en fichier .pdf grâce à Graphviz. Ce qui en ligne de commande se fait de la manière suivante :

dot -Tpdf xxx.dot -o xxx.pdf

J'obtiens alors le fichier xxx.pdf, qui m'affiche ce schéma :

Visualisation de l'héritage des champs

Avec cela je peux vérifier que j'ai bien entrée les bons types d'entrées.

Visualiser les champ

En revanche, je ne peux pas vérifier que je n'ai pas oublié un champ, ou bien que mes réglages d'héritages sont correctes. Qu'importe ! Biber est capable d'afficher aussi les héritages de champs.

Il suffit de modifier légèrement les options passées à Biber :

--outformat=dot --dot_include=crossref,field xxx

puis de produire le pdf :

dot -Tpdf xxx.dot -o xxx.pdf

J'obtiens alors le schéma suivant :

Visualisation des héritages des champs

Cette visualisation peut servir parfois, mais elle devient vite complexe lorsque le nombre de références se multiplie.

Biber permet de produire d'autres schémas : je renvoie au manuel.

Il est également possible de produire des .svg ou des .png, respectivement avec :

dot -Tsvg xxx.dot -o xxx.svg
dot -Tpng xxx.dot -o xxx.png

Geekographie Maïeulesque

Comment ma bibliographie a saturé la mémoire de (Xe)LaTeX

Résumé du bug

Recherche de l'origine [1]

Recherche de la cause

Fonctionnement interne de la bibliographie avec LaTeX + Biber

Analyse du fichier .bbl

Résolution du problème

Première solution : utiliser LuaLaTeX

Deuxième solution : augmenter la mémoire de XeLaTeX

Troisième solution : éviter d'avoir deux bibliographies triées

En guise de conclusion

biblatex-bookinarticle devient biblatex-bookinother

Ce que propose le package

Chargement

Plus d'éditeur.rice.s avec biblatex-morenames

Le champ maineditor

Signification

Héritage

Exemple

Les champs ineditor et bookineditor

Signification

Exemple

Héritage

Chargement du package

Installer et utiliser BibLaTeX et Biber sous Windows avec MiKTeX

Préalable

Installation d'un package / logiciel avec MiKTeX Package Manager

Configuration de TeXWorks

Appel à biber dans TeXworks

Gestions des œuvres anonymes : méthode encore plus simple

Préambule : à quoi répond cet article

Nos besoins

Des options bien utiles

Un tri simplifié

Éditeur ou directeur

Des vrais op. cit.

Entrées @inbook, crossref et formes abrégées

Le problème

Un problème d'analyse

La solution

Le style par défaut

Sa redéfinition

Affinage

Gérer des champs supplémentaires

Le problème

Notre exemple

Transférer les champs

Styler le champ addendum

Collection sous forme abrégée avec shortseries

Pourquoi utiliser ce champ

Les entrées de démonstration

Afficher la version abrégée de la collection

Comment afficher la liste des abréviations ?

Trier selon le champ shortseries

Filtrer les entrées

Imprimer les équivalences

Tri des œuvres anonymes

La mauvaise méthode

La bonne méthode

Vérification des filiations avec biblatex (2) : vérifier visuellement

Exemples

Visualisation des héritages de type

Visualiser les champ

Analyse du fichier `.bbl`

Le champ `maineditor`

Les champs `ineditor` et `bookineditor`

Styler le champ `addendum`

Trier selon le champ `shortseries`