Geekographie Maïeulesque

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.

Index et table des matières dans la table des matières

Maïeul — 2011-09-09T16:38:16Z

Comment permettre à l'index produit avec \printindex d'apparaître dans la table des matières ? Comment permettre à la table des matières d'apparaître dans la table des matières ? Voici la solution que j'ai adoptée, pour la classe book.

Principe

La commande \printindex fait appel à l'environnement theindex, que l'on trouve défini dans le fichier book.cls.

\newenvironment{theindex} {\if@twocolumn \@restonecolfalse \else \@restonecoltrue \fi \twocolumn[\@makeschapterhead{\indexname}]% \@mkboth{\MakeUppercase\indexname}% {\MakeUppercase\indexname}% \thispagestyle{plain}\parindent\z@ \parskip\z@ \@plus .3\p@\relax \columnseprule \z@ \columnsep 35\p@ \let\item\@idxitem} {\if@restonecol\onecolumn\else\clearpage\fi}

C'est la ligne 7 qui nous intéresse. Elle contient l'appel à la commande \@makeschapterhead, qui se charge d'afficher le titre de l'index.

La commande \tableofcontents est définie directement dans le fichier book.cls

\newcommand\tableofcontents{% \if@twocolumn \@restonecoltrue\onecolumn \else \@restonecolfalse \fi \chapter*{\contentsname \@mkboth{% \MakeUppercase\contentsname}{\MakeUppercase\contentsname}}% \@starttoc{toc}% \if@restonecol\twocolumn\fi }

Ici c'est la ligne 7 qui nous intéresse, puisqu'elle appelle la commande \chapter*.

Il va s'agir de modifier ces lignes. Pour cela, nous allons utiliser la commande \patchcmd{commande}{recherche}{remplace}{succes}{echec} package etoolbox, qui est chargé par polyglossia.

Cette commande remplace dans la commande commande la valeur recherche par remplace. Si ce remplacement fonctionne, elle retourne succes, sinon echec.

Application pour l'index

\makeatletter \patchcmd{\theindex}{\@makeschapterhead{\indexname}}{\phantomsection\addcontentsline{toc}{chapter}{\indexname}\@makeschapterhead{\indexname}}{}{} \makeatother

Nos caractères à chercher dans le code de la commande contenant des @, nous entourons de \makeatletter et \makeatother.

Nous remplaçons dans la commande \theindex, qui correspond à ce qui est exécuté en début d'environnement theindex,

\@makeschapterhead{\indexname}

par

\phantomsection\addcontentsline{toc}{chapter}{\indexname}\@makeschapterhead{\indexname}

La commande addcontentsline ajoute l'entrée dans la table des matières. La commande \phantomsection sert au package hyperref à avoir ses signets de navigation correctement placés.

Nous n'exécutons rien de particulier ni en cas de succès ni en cas d'échec.

Application à la table des matières

\patchcmd{\tableofcontents}{\chapter*}{\phantomsection\addcontentsline{toc}{chapter}{\contentsname}\chapter*}{}{}

Nous remplaçons dans la commande \tableofcontents,

\chapter*

par

\phantomsection\addcontentsline{toc}{chapter}{\contentsname}\chapter*

Nous n'exécutons rien de particulier ni en cas de succès ni en cas d'échec.

Si vous n'utilisez pas le package hyperref, ne mettez pas \phantomsection.

L'environnement overprint

Maïeul — 2011-04-09T09:59:29Z

Je présentais l'autre jour une solution pour gérer les couches successives d'une diapositive d'un diaporama Beamer, lorsqu'on affiche un graphisme TikZ en plusieurs étapes.

Le problème était simple : le graphisme s'affichant en plusieurs étapes, il n'avait pas toujours la même taille, et je devais gérer cette différence en affichant des éléments en blanc.

J'ai trouvé depuis une meilleur méthode.

Il s'agit d'utiliser l'environnement overprint et dedans la commande onslide pour gérer les différentes couches d'une même diapositive.

En effet, l'environnement overprint occupera, sur toutes les couches, la hauteur et la largeur de la couche qui nécessite le plus d'espace.

Exemple :

\begin{overprint} \begin{tikzpicture} \node (M) at (0,0) {\textcolor{red}{Apo} - \textcolor{blue}{cryphe}}; \onslide<2->{\node(A) at (-3,-3) {\textcolor{red}{Ἀπο} : \emph{loin}};} \onslide<3->{\node (K) at (3,-3) {\textcolor{blue}{Κρύτω} : \emph{cacher}};} \draw<2->[->,color=red] (M.south west) -- (A); \draw<3->[->,color=blue] (M.south east) -- (K); \end{tikzpicture} \end{overprint}

On constate que le diagramme TikZ nécessite le plus de place sur la couche 3 et les suivantes. Ce sera donc la taille de la couche 3 qui déterminera sa taille.

Du latin avec une typographie française (2)

Maïeul — 2011-03-22T21:04:18Z

J'avais publié il y a peu une manière d'utiliser l'environnement latin en conservant une typographie française.

J'ai reçu depuis une réponse de l'auteur, pour une technique plus propre.

\newenvironment{flatin}{\begin{hyphenrules}{latin}}{\end{hyphenrules}}

pour avoir l'environnement flatin.

Et si on veut un environnement latin avec une typographie française :

\newenvironment{latin}{\begin{hyphenrules}{latin}}{\end{hyphenrules}}

Ici ne sont appliquées que les règles de césures latines, pas le reste.

Du latin avec une typographie française

Maïeul — 2011-02-24T22:27:52Z

Le package Polyglossia sert pour XeLaTeX à la place du vénérable package Babel.

Il propose des environnements pour signaler les changements de langue. Seul hic : la typographie appliquée est alors anglaise, et non française.

Pourquoi mentionner les changements de langue ?

Il est important de mentionner les changements de langues :

pour pouvoir appliquer des traitements automatiques le cas échéant, par exemple définir une police spéciale.
pour signaler ces changement dans le PDF produit, et donc aider éventuellement les interprétateurs vocaux [1].
gérer les coupures de mots à la fin des lignes, les césures.

Comment le faire

Je déclare mes langues dans le préambule :

 \usepackage{polyglossia}
\setmainlanguage{french}
\setotherlanguage{latin}

Et quand je passe au latin je fais :

\begin{latex}
Textum in lingua latina
\end{latex}

Seul problème : le texte se voit alors appliquée une typographie anglaise et non pas française. Ainsi, il n'y a pas d'espace fine insécable devant les caractères doubles, mais une espace normale sécable.

~~Pour corriger cela, une seule solution à ma portée : modifier le fichier de de description de la langue latine, le fichier gloss-latin.ldf.~~

~~Je propose ci joint ce fichier modifié. Il faut l'installer :~~

~~soit à côté du fichier qu'on compile~~

~~soit dans le dossier de personnalisation de LaTeX : voir ici : http://fr.wikibooks.org/wiki/LaTeX/Installer_LaTeX#Installer_des_extensions_supplémentaires.~~

L'auteur m'a apporté une meilleure solution : voir mon nouvel article.

[1] A vrai dire je ne sais pas si Polyglossia propose cela dans les PDF produit, mais sait-on jamais.