Geekographie Maïeulesque

xindy, hyperref et |see

Maïeul — 2015-11-02T21:45:52Z

Une personne m'a demandé comment utiliser xindy avec hyperref et l'option d'indexation |see. Je tire donc un article de la solution proposée.

Fichier d'exemple

Je suppose que vous avez, au préalable, créé votre fichier .xdy contenant les instructions proposées dans l'article xindy et hyperref. Je suppose que vous avez également chargé le package hyperref avec l'option hyperindex=false :

\usepackage[hyperindex=false]{hyperref}

Je prend maintenant le fichier contenant les commandes d'indexation suivantes :

\indexentry{félin}{1} \indexentry{chat|see{félin}}{1}

Je souhaite que la commande |see non seulement renvoie vers la bonne entrée, mais en plus intègre un lien hypertexte.

Analyse du fichier `.idx` et du fichier `.ind`

Le fichier .idx produit est le suivant

\indexentry{félin}{1} \indexentry{chat|see{félin}}{1}

Après un passage par xindy avec mon précédent .xdy, on obtient les lignes suivantes dans le fichier .ind :

(…) \item chat, \see{félin}{} (…) \item félin, \hyperpage{1} (…)

On constate donc que si il existe bien un renvoi depuis « chat » vers « félin » et si félin pointe bien avec un lien hypertexte sur la page 1, le renvoi ne propose pas de lien hypertexte.

Modification du `.xdy`

Nous allons modifier notre fichier .xdy pour ajouter :

une commande pour indiquer que « félin » est un lieu de destination.
une commande pour indiquer que « chat » pointe vers félin, ou plus exactement que le \see{félin}{} point vers félin.

Ajoutons donc les deux lignes suivantes au fichier .xdy :

(markup-keyword-list :open "\targetindexentry{" :close"}") (markup-crossref-list :open "\seelink{" :close "}{}" :class "see")

La première ligne indique d'entourer les mots-c'est à dire les entrées d'indexation, par \targetindexentry{ à gauche et par } à droite.

La seconde ligne indique que le paramètre marqué entre les accolades qui suivant le |see, ici félin doit être entouré à gauche par \seelink{ et à droite par }{}.

Ceci nous produit donc le fichier .ind avec les lignes suivantes :

(…) \item \targetindexentry{chat}, \seelink{félin}{} (…) \item \targetindexentry{félin}, \hyperpage{1}

Définition de `\seelink` et de `\targetindexentry`

Il ne reste plus qu'à définir dans notre fichier .tex les deux commandes \targetindexentry et \seelink qui utilisent des commandes du package hyperref.

\newcommand{\targetindexentry}[1]{\hypertarget{index:#1}{#1}} \newcommand{\seelink}[1]{\hyperlink{index:#1}{\see{#1}}}

Rien de bien méchant : targetindexentry crée une ancre sur son argument. Le nom de l'ancre correspond à son argument précédé par index: ; \seelink point vers une ancre dont le nom correspond à son argument précédé de index:, le texte pointeur étant tout simple la commande \see à laquelle on passe son argument.

Correction de `\hyperlink` et `hypertarget`

Le problème est que les commandes \hyperkink et hypertarget ne fonctionne pas si le premier argument contient des accents. Il nous faut donc corriger ces commandes. Cependant une telle correction ralentissant considérablement le temps de calcul [1], il est recommandé de les faire uniquement avant l'index.

Ajoutez donc ces lignes avant le premier \printindex.

\makeatletter \long\def\hyper@@anchor#1#2{% \pdfstringdef\@temp@anchorpdfstring{#1}% \@hyper@@anchor\@temp@anchorpdfstring\relax#2\relax% } \def\hyperlink#1#2{% \pdfstringdef\@temp@anchorpdfstring{#1}% \hyper@@link{}{\@temp@anchorpdfstring}{#2}% } \makeatother

La différence principale avec les définitions de hyperref est l'emploi de \pdfstringdef qui permet de transformer les accents en caractères acceptables dans le code interner d'un pdf, donc dans les liens hypertextes.

Et maintant, non seulement |see fonctionne, mais en plus il produit des liens hypertextes. Miaou !

[1] D'après l'auteur du package, Otto Oberdierk.

Régler l'apparence des index avec xindy

Maïeul — 2015-04-15T06:30:00Z

Après avoir créé notre premier index avec xindy, nous allons maintenons modifier son apparence. Par « apparence » nous entendons la manière dont sont affichés les entrées et les pages, mais pas l'ordre de tri ou les divisions par initiales.

Exemple adapté à la situation

Nous allons prendre un exemple avec un seul index, mais avec plusieurs niveau d'entrées, et en en prenant des entrées présentent sur plusieurs pages.

\documentclass{article}
\usepackage{fontspec}
\setmainfont{Linux Libertine O}
\usepackage{setspace}
\onehalfspacing
\usepackage[xindy]{indextools}%On précise qu'on veut utiliser xindy
\makeindex[name=animal,title=Animaux]
\begin{document} On va parler de chats sauvages\index[animal]{chat!sauvage} et domestiques\index[animal]{chat!domestique},
de tortues marines\index[animal]{tortue!marine} et terrestres\index[animal]{tortue!terrestre},
d'élèphant d'Asie\index[animal]{élèphant!d'Asie} et d'Afrique\index[animal]{élèphant!d'Afrique},
et soyons fou, d'élans de Sibérie\index[animal]{élan!de Sibérie} et d'Amérique\index[animal]{élan!d'Amérique}. \newpage On va parler sur la page suivante des même animaux. C'est à dire : de chats sauvages\index[animal]{chat!sauvage} et domestiques\index[animal]{chat!domestique},
de tortues marines\index[animal]{tortue!marine} et terrestres\index[animal]{tortue!terrestre},
d'élèphant d'Asie\index[animal]{élèphant!d'Asie} et d'Afrique\index[animal]{élèphant!d'Afrique},
et soyons fou, d'élans de Sibérie\index[animal]{élan!de Sibérie} et d'Amérique\index[animal]{élan!d'Amérique}. \printindex[animal]
\end{document}

Après la série de compilation grâce a latexmk configuré pour xindy, nous obtenons l'index ci-dessous.

Formatage par défaut avec xindy + indextools

Répartition des tâches

Ouvrons le fichier .ind produit par xindy pour observer son contenu :

\begin{theindex} \providecommand*\lettergroupDefault[1]{} \providecommand*\lettergroup[1]{% \par\textbf{#1}\par \nopagebreak } \lettergroup{C} \item chat \subitem domestique, 1, 2 \subitem sauvage, 1, 2 \indexspace \lettergroup{E} \item élan \subitem d'Amérique, 1, 2 \subitem de Sibérie, 1, 2 \item élèphant \subitem d'Afrique, 1, 2 \subitem d'Asie, 1, 2 \indexspace \lettergroup{T} \item tortue \subitem marine, 1, 2 \subitem terrestre, 1, 2 \end{theindex}

On voit qu'il s'agit tout simplement d'un ensemble d'instruction LaTeX. Il y a donc une répartition du travail entre :

le noyau LaTeX, les package et notre propre code LaTeX qui se chargent de définir les commandes.
xindy qui se charge d'insérer les commandes LaTeX dans le fichier .ind à partir du fichier .idxy et de ses propres fichiers de configuration.

Trois exemples de configuration niveau LaTeX

Colonages : les options de `indextools`

L'environnement theindex est défini par chaque classe LaTeX, mais redéfini indextools pour le rendre facilement configurable.

Ainsi, je vous invite à lire la documentation d'indextool et de la commande makeindex qui explique comment facilement personnaliser l'apparence. Je ne vais présenter ici qu'une option : celle qui permet d'avoir un filet de séparation entre les deux colonnes.

À la place de

\makeindex[name=animal,title=Animaux]

mettons

\makeindex[name=animal,title=Animaux,columnseprule]

et nous obtenons alors l'index avec son filet de séparation.

Index avec filet de séparation

Apparence des sectionnement par lettre

En revanche, certaines éléments d'apparence sont à définir via la personnalisation des commandes. C'est par exemple le cas de l'apparence des entêtes de groupe par initiales. Nous voyons en consultant le fichier .ind qu'elle sont formatées via la commande \lettergroup.

Cette commande est définie ainsi au début de l'environnement theindex :

 \providecommand*\lettergroup[1]{% \par\textbf{#1}\par \nopagebreak }

La commande \providecommand est très utile : elle définit une commande sauf si celle-ci est aussi définie via \newcommand. Dans le cas présent, cela permet de proposer un formatage par défaut mais personnalisable.

Ainsi, si nous ne souhaitons pas afficher les lettres de séparation, il suffit de mettre dans son préambule :

 \newcommand{lettergroup}[1]{}

Mais on on peut aussi s'en servir pour personnaliser de manière plus subtile l'apparence. Par exemple avec le code suivant :

\newcommand{\lettergroup}[1]{% {\centering\large---\emph{#1}---\par}%
}

La lettre est centrée dans la colonne, en taille \large, en italique, et entouré de tirets longs.

Exemple de personnalisation de l'entête de groupe de lettre

Une flèche avant les sous-entrée bibliographique

Supposons maintenant que nous souhaitions mettre une petite flèche avant chaque sous-entrée bibliographique. La méthode la plus simple est de modifier la commande \subitem pour ajouter cette flèche à la fin. On peut utiliser pour cela la commande \apptocmd du package etoolbox qui est chargé par indextools :

\apptocmd{\subitem}{$\rightarrow$\,}{}{}

Le \, insère une espace fine insécable après la flèche.

Ceci donne le résultat ci-dessous.

Une flèche avant les sous-entrée d'un index

XXX exemples de configuration niveau au niveau de `xindy`

`xindy`, ou la succession de fichiers de configuration

Lorsque vous lancez texxindy, vous voyez apparaître dans le terminal les lignes suivantes :

Loading module "lang/french/utf8-lang.xdy"...
Loading module "lang/french/utf8.xdy"...
Finished loading module "lang/french/utf8.xdy".
Finished loading module "lang/french/utf8-lang.xdy".
Loading module "texindy.xdy"...
Loading module "numeric-sort.xdy"...
Finished loading module "numeric-sort.xdy".
Loading module "latex.xdy"...
Loading module "tex.xdy"...
Finished loading module "tex.xdy".
Finished loading module "latex.xdy".
Loading module "latex-loc-fmts.xdy"...
Finished loading module "latex-loc-fmts.xdy".
Loading module "makeindex.xdy"...
Finished loading module "makeindex.xdy".
Loading module "latin-lettergroups.xdy"...
Finished loading module "latin-lettergroups.xdy".
Finished loading module "texindy.xdy".
Loading module "page-ranges.xdy"...
Finished loading module "page-ranges.xdy".
Loading module "word-order.xdy"...
Finished loading module "word-order.xdy".

Ces lignes indiquent que xindy chargent des modules de configuration .xdy et y lis les instructions pour savoir comment transformer les fichiers .idx en .ind.

Contrairement à makeindex qui pour cela utilise un fichier .ist, xindy peut utiliser plusieurs fichiers .xdy.

L'intérêt étant évidemment de permettre d'avoir une configuration modulaire. Un fichier .xdy est essentiellement une liste d'instruction.

On trouve dans le manuel de xindy la listes des instructions fournies. Par ailleurs, un certain nombre de fichiers .xdy sont livrés par défaut avec xindy.

Vous les trouverez dans le dossier xindy/modules du dossier texmf-dist de votre distribution tex. Typiquement avec une installation MacTeX2014, dans le dossier /usr/local/texlive/2014/texmf-dist/xindy. Ou plus simplement vous pouvez les consulter sur le CTAN (prendre la version 2.5.0, qui est celle livrée avec TeXLive).

Il suffit donc pour avoir ses propres styles de créer un fichier monstyle.xdy dans le dossier à côté du .tex et d'utiliser l'option -M monstyle lors de l'appel à la commande :

$ texindy -L french -I xelatex -M monstyle animal.idx

Et donc dans le fichier de configuration de latexmk

$makeindex = "texindy -L french -I xelatex -M philologue";

Après ce préalable, il est temps de voir ce qu'on met dans ce fichier.

Séparation l'entrée et ses références par une ligne de point

Par défaut, l'entrée dans l'index est séparé de ses par une virgule. À titre personnel, je trouve plus lisibles les index dont la séparation entre les deux est plus marquée. Par exemple lorsque la séparation est constituée par une ligne de point : \dotfill en LaTeX.

Mettons donc la ligne suivante

;; Pour avoir les numéro de pages avec des -- y compris si on a uniquement deux pages
;; Séparateur entre l'entrée et ses numéros
(markup-locclass-list :open "\dotfill ")

Commentons rapidement ces lignes :

un ; marque un commentaire qui s'étend jusqu'à la fin de la ligne. Il est d'usage de mettre deux ; lorsque nous avons affaire à une ligne de commentaire
chaque instruction est mise entre parenthèse. Une instruction peut courir sur plusieurs lignes (pas le cas ici)
en général une instruction correspond à une propriété, ici markup-locclass-lis à laquelle est passée des paramètres. Souvent les paramètres sont des liste d'option, chaque option étant préfixée par : (deux-points). Ici la valeur de l'option open est une chaîne de caractère (marquée par les guillemets) égalent à \dotfill.

Après avoir executé texindy -L french -I xelatex -M monstyle animal.idx, on constate que le nouveau fichier .ind est devenu

\begin{theindex} \providecommand*\lettergroupDefault[1]{} \providecommand*\lettergroup[1]{% \par\textbf{#1}\par \nopagebreak } \lettergroup{C} \item chat \subitem domestique\dotfill 1, 2 \subitem sauvage\dotfill 1, 2 \indexspace \lettergroup{E} \item élan \subitem d'Amérique\dotfill 1, 2 \subitem de Sibérie\dotfill 1, 2 \item élèphant \subitem d'Afrique\dotfill 1, 2 \subitem d'Asie\dotfill 1, 2 \indexspace \lettergroup{T} \item tortue \subitem marine\dotfill 1, 2 \subitem terrestre\dotfill 1, 2 \end{theindex}

Ce qui nous produit donc l'index ci-dessous.

Index avec ligne de points

Regrouper les pages dans un intervalle

Ajoutons maintenant avant l'index une nouvelle page de telle sorte que certains termes se trouvent sur trois pages d'affilée, d'autre sur deux pages d'affilée, et d'autres sur une seule page.

\newpage
Et pour la bonne cause, on va aussi parler de chats sauvages\index[animal]{chat!sauvage} qui se disputent avec les chiens errants\index[animal]{chien!errant}.

On obtient l'index ci-dessous.

Plusieurs pages d'affilée pour une même entrée d'index : réglage par défaut

On constate que si le nombre de pages consécutives est supérieur à 2, xindy va remplacer par la page de début et la page de fin. On peut cependant vouloir d'autres réglages

Pas de regroupement des pages

On peut tout simplement ne pas vouloir de regroupement des pages. Dans ce cas on peut utiliser :

(define-location-class "arabic-page-numbers" ("arabic-numbers") :min-range-length 9999999999)

Explication :

on définit une manière de référencer des termes. Cette manière est nommée arabic-page-numbers
cette manière consiste à tout simplement utiliser un nombre arabe ("arabic-numbers").
on indique que pour pour fusionner plusieurs références consécutives, il faut que les références consécutives tiennent dans un intervalle de 9999999999 [1], c'est à dire que la différence entre la première et la dernière référence consécutive soit de 9999999999. Cas qui ne risque normalement pas d'arriver [2]. On obtient alors l'index ci-dessous.

Plusieurs pages d'affilée pour une même entrée d'index : pas de fusion

Regroupement dès deux pages

Cependant en général on souhaite plutôt regrouper les numéros de page, y compris s'il n'y a que deux pages consécutives. Dans ce cas on peut utiliser :

(define-location-class "arabic-page-numbers" ("arabic-numbers") :min-range-length 1)

Ce qui signifie que si l'écart entre les références consécutives est d'au moins 1, on fusionne les références. Ce qui permet d'obtenir l'index ci-dessous.

Plusieurs pages d'affilée pour une même entrée d'index : fusion dès deux pages

Note : les numéros sont séparés par des tirets demi-cadratins (--). On peut vouloir utiliser à la place des traits d'unions simples. Dans ce cas il suffit d'utiliser :

(markup-range :sep "-")

`s` et `ss`

On peut aussi vouloir :

que deux pages d'affilée soit rendu par Xs où X est le premier numéro de page.
que plus de deux pages d'affilée soit rendu par Xss.

On va pour cela prendre le modèle livré dans le fichier base/ff-ranges-only.xdy, en nous contenant de remplacer f par s et ff par s.

(define-location-class "arabic-page-numbers" ("arabic-numbers") :min-range-length 1)
(markup-range :sep "s" :length 1 :ignore-end)
(markup-range :sep "ss" :ignore-end)

Commentaire :

l. 1-2 : même chose que précédemment.
l. 3 : balisage des pages consécutives lorsque l'écart entre la première et la dernière référence est de 1 : utiliser s comme séparateur, et ne pas afficher la page de fin.
l. 4 : balisage des références consécutives dans les autres cas : utiliser ss comme séparateur, et ne pas afficher la page de fin.

Ce qui nous donne l'index ci-dessous.

Plusieurs pages d'affilée pour une même entrée d'index : utilisation de s et ss

Cependant, dans un tel cas, lorsqu'on aura plus de trois pages consécutives, par exemple « 1,2,3,4 » on aura aussi ss. Ce qui manque de précision.

Dans ce cas on peut s'inspirer du fichier base/ff-ranges.xdy et remplacer

(markup-range :sep "ss" :ignore-end)

par

(markup-range :sep "ss" :length 2 :ignore-end)

Ce qui signifie que ss ne sera utilisé que si l'écart entre la première et la dernière référence est de 2. Donc pour 1-3 mais pas pour 1-4.

Synthèse

C'est tout pour aujourd'hui

[1] D'après le manuel on peut utilise le mot-clef none mais chez moi cela provoque une erreur de compilation.

[2] Ou alors vous écrivez un très long livre avec un index totalement inutile, puisqu'il indique qu'on parle de votre sujet sur 10 000 000 000 pages d'affilée.

Mixer numérotation continue et discontinue

Maïeul — 2013-05-13T19:45:47Z

Une personne souhaitait mélanger dans un texte deux types de numérotation de lignes, l'une continue, l'autre discontinue. Il n'est pas possible de faire cela directement avec les commandes eledmac, mais avec un peu d'astuce, on peut résoudre le problème.

Description du problème

Alterner numérotation continue et discontinue

Le demandeur travaille sur un texte alternant poésie et vers. Il souhaitait que la numérotation de le prose recommence à 1 en début de chaque passage, mais que la numérotation des vers soit continue, comme dans l'exemple joint.

Chaque bloc de vers / de prose correspond à un \beginumbering...\endnumbering.

On ne peut utiliser \pausenumbering ... \resumenumbering [1] puisque nous alternons numérotation continue et numérotation discontinue.

Solution : principe

Le principe de la solution est assez simple :

à la fin de chaque série de vers, sauvegarder le numéro de la ligne dans un compteur.
en début de chaque série de vers, exceptée la première, changer la numérotation, en utilisant le compteur.

Nous allons donc définir deux commandes dans le préambule : \savestanzaline, que nous placerons entre \& et \endnumbering et \restorestanzalineque nous placerons entre \beginnumbering et \stanza [2], selon l'exemple ci-dessous :

\beginnumbering \restorestanzaline \stanza Questo è il testo in versi & Questo è il testo in versi & Questo è il testo in versi & Questo è il testo in versi & Questo è il testo in versi & Questo è il testo in versi & Questo è il testo in versi & Questo è il testo in versi & Questo è il testo in versi & Questo è il testo in versi & Questo è il testo in versi & Questo è il testo in versi \& \savestanzaline \endnumbering

Reste à définir ces commandes, ce qui n'est pas une mince affaire.

Solution : mise en œuvre

Dans notre préambule, mettre les lignes suivantes :

\makeatletter \newcount\@stanzaline \newcommand{\savestanzaline}[0]{\global\@stanzaline=\line@num} \newcommand{\restorestanzaline}{\setlinenum{\@stanzaline}} \makeatother

Commentaire :

l. 1 et l. 5 : nos commande manipulent des commandes avec des @ dans le nom. On a donc besoin de makeatletter et \makeatother les encadrant.
l. 2 : on déclare un compteur \@stanzaline. C'est un compteur TeX et non LaTeX. Ce choix ce justifie :
- Par économie : on n'a pas besoin de toutes fonctionalités d'un compteur TeX.
- Par simplicité : un compteur LaTeX aurait posé des soucis lors de son appel pour modifier les numéro de lignes.
l. 3 : la commande \savestanzaline assigne à \@stanzaline la valeur du compteur \line@num, que eledmac utilise pour compter les lignes. Le \global permet que l'assignement dépasse le cadre de la section numérotée [3].
l. 4 : la commande \setlinenum est utilisé pour modifier le numéro de la ligne. Elle est appelée avant que la numérotation ne commence. On indique simplement que le numéro de ligne souhaité correspond au compteur \@stanzaline.

Et voici donc comment l'on peut mélanger deux types de numérotation de lignes.

[1] Qui permettent d'arrêter un passage numéroté sans pour autant réinitialiser la numérotation.

[2] Sauf pour le premier bloc de vers.

[3] Celle qui est comprise entre \beginnumbering et \endnumbering.

Commandes à arguments illimités

Maïeul — 2013-04-21T13:16:22Z

J'ai eu récemment besoin de créer une commande dont le nombre d'arguments serait illimité. Il s'agissait de permettre d'indiquer une série de référence biblique associée à un passage. Voici comment, sur conseil du TeXnicien de surface.

Problème

Le texte que j'étudie fait allusion par moment à des passages bibliques. Je souhaite ajouter une note de bas de page indiquant :

Cf. Passage 1 ; Passage 2 ; Passage n. etc

Évidemment, je pourrais le faire à la main, mais utiliser une commande spécifique permet d'uniformiser les styles. C'est pourquoi j'ai voulu créer une commande :

\bibeall{passage1}{passage2}{passagen}

J'avais affaire à deux problèmes :

Techniquement une commande LaTeX ne peut prendre que 9 arguments au maximum.
Pour chaque passage, je devais indiquer le livre séparément du chapitre, afin de pouvoir utiliser les possibilités de bibleref-french. En outre, je souhaitais pouvoir préciser la version entre parenthèse (LXX, Vulgate, BHS etc.). Ce qui faisait que j'étais réduit à au mieux 3 passages.

Solution : principe

La solution consiste alors à proposer une commande à un seul argument, mais qui pourrait se décomposer sous forme de liste. J'ai choisi d'utiliser le + comme séparateur d'élément de liste, car la , a un sens spécifique lorsque l'on utilise bibleref-french [1]

Pour séparer le livre du passage et le passage de la version, j'ai décidé d'utiliser le symbole | (pipe).

Ainsi, si je souhaite faire référence à Isaïe, livre 1 chapitre 1, dans la version LXX et BHS, je met :

\bibleall{Is|1:1|BHS+Is|1:1|LXX}

Et j'obtiens en note de note de bas de page :

Cf. Is 1,1 (BHS) ; Is 1,1 (LXX).

Mise en œuvre

Je crée une commande \bibleall qui se contente pour l'essentiel d'appeler une commande \bibleref.

\newcommand*{\bibleall}[1]{% %#1 : passage \footnote{\emph{Cf}. \bibleref{#1}}% }

Ceci permet d'appeler \bibleref depuis une autre commande \bible :

\newcommand*{\bible}[2]{% %#1 : passage %#2 : texte \emph{#2}\footnote{\bibleref{#1}}% }

La commande \bibleref va se servir des outils du package etoolbox pour parcourir les listes. On se sert également du package xstring, qui nous permet de savoir le nombre de | dans chaque élément de la liste :

1 si on n'indique pas la version.
2 si on indique la version.

\newcommand{\bibleref}[1]{ %Commande pour afficher un passage biblique, c'est elle qui est appellée par tt les autres \def\passage##1|##2|##3|{\bibleverse{##1}(##2)\ifstrempty{##3}{}{ (##3)}}% L'affichage de chaque passage : ##1) livre ##2) passage ##3) version % On commence par faire une liste des passages \def\passages{}% Liste des passages \numdef\nbpassages{0}% Nbr total de passages \DeclareListParser*{\trouvepassages}{+}% Le + est un séparateur \trouvepassages{\numdef\nbpassages{\nbpassages+1}\listadd\passages}{#1}% On remplit la liste des passage % % On la parcourt ensuite \numdef\cptpassage{0}% Le nombre de passage courant \renewcommand{\do}[1]{% Ce qu'on effectue à chaque boucle \numdef\cptpassage{\cptpassage+1}% Incrémenter le compteur du passage courant \IfSubStr[2]{##1}{|}% Tester si on a 2 ou 3 élèments dans le passage {\passage##1|} % Si 3 élèments, donc 2 | {\passage##1||}% Si 2 élèments, donc 1 | \ifnumequal{\nbpassages}{\cptpassage}{.}{ ; }% y a t'il encore des passages ensuite? }% \dolistloop{\passages}% Boucler sur tt les passages % }

J'ai déjà mis des commentaires, qui devraient permettre de comprendre l'essentiel. Mais complétons un peu.

l. 3 : la commande \passage est une commande TeX et non pas LaTeX comme le prouve sa définition par \def et non par \newcommand. Voici quelques précisions sur sa définition :
- ##1|##2|##3| signifie que ces arguments sont passés immédiatement après le nom de la commande, chaque argument étant suivi d'une pipe. Ainsi on appelle la commande de la forme suivante : \passage Is|1:1|LXX.
- Cependant cette commande ne peut être appelée directement dans le corps du fichier. En effet, nous l'avons définie à l'intérieur de la commande \bibleref : sa portée, c'est à dire l'endroit où il est appellable, se limite donc à l'intérieur de \bibleref. Le fait que nous ayons défini \passage dans \bibleref explique que nos arguments aient 2 # et non un seul.
- Nous passons les deux premiers arguments à la commande \bibleverse, selon la syntaxe de celle-ci. Puis si le troisième argument n'est pas vide, nous le mettons entre parenthèse.
l. 5. Nous définissons une commande vide \passages. Cette commande sera remplie par etoolbox pour constituer une liste que nous pourrons manipuler.
l. 6. Nous définissons un nombre \nbpassages qui nous servira à compter le nombre de passages. Un nombre est une sorte de compteur propre au passage etoolbox. L'avantage d'utiliser un nombre plutôt qu'un compteur est double :
- Un nombre peut avoir une portée locale, alors qu'un compteur est global. Autrement dit, à chaque fois que nous appelons \bibleref, nous réinitialisons \nbpassages et il est impossible d'avoir accès à la valeur de \nbpassages en dehors de \bibleref
- Un nombre est plus facile à manipuler avec etoolbox qu'un compteur.
l. 7 : nous indiquons que la commande \trouvepassages va nous permettre de manipuler un liste dont les éléments sont séparés par des +.
l. 8 : nous parcourons le texte passé en argument à \bibleref (#1), pour déterminer les éléments de la liste. Pour chaque élément de la liste : -
- \numdef\nbpassages{\nbpassages+1} indique que nous augmentons d'une unité la valeur de \nbpassages.
- \listadd\passages indique que nous ajoutons l'élément courant à la liste \passages.
Après la l. 10 nous allons désormais travailler non plus sur la liste #1 mais sur la liste \passages.
L. 11 : nous avons besoin d'un autre nombre, \cptpassage pour savoir combien d'éléments nous avons parcourus.
L. 12 à 18, nous définissons ce que nous ferons pour chaque élément de la liste :
- L. 13 : incrémenter \cptpassage d'une unité.
- L. 14 : tester le nombre | présent dans l'élément courant (##1) est au moins égal à 2 :
  - L. 15 : si c'est le cas, nous avons affaire à quelque chose du style Is|1:1|LXX. Dans ce cas, nous appelons \passage en lui passant une chaîne constitué de l'élément courant (##1) suivi de |. Dans notre exemple, c'est comme si nous faisions \passage Is|1:1|LXXL.
  - L. 16 : s'il y a moins de deux |, nous avons affaire à quelque chose du style Is|1:1. Dans ce cas, nous appelons \passage en lui passant une chaîne constitué de l'élément courant (##1) suivi de ||. Dans notre exemple, c'est comme si nous faisions \passage Is|1:1||.
- Grâce au test de la ligne 14, nous pouvons indifféremment préciser ou non la version.
- L. 17 : nous testons si \cptpassage est égal à \nbpassages, c'est à dire si nous avons affaire au dernier élément de la liste. Si tel est le cas, nous mettons un point final, sinon un ;.
- L. 19 : nous exécutons ce que nous avons défini dans \do pour chaque élément de la liste \passages.

Ouf, ça y est. Le commentaire est fini. Il peut paraître un peu « lourd », mais mieux vaut être trop précis que pas assez.

[1] Elle sert à indiquer la sélection de plusieurs versets discontinus.

Langues dans un alphabet non latin et polices de caractère

Maïeul — 2012-10-22T20:14:36Z

En préparant une formation pour un collègue, je me suis rendu compte que mon livre pouvait être un peu elliptique sur certains aspects de la gestion du polylinguisme avec LaTeX, notamment lorsqu'on l'on à affaire à des langues s'écrivant avec des caractères non latins.

Unicode ne suffit pas

La norme Unicode permet de stocker tous les caractères existants sur Terre [1].

Néanmoins Unicode ne définit pas comment s'affichent les caractères : ce travail est confiée aux polices.

Or il n'existe pas de polices contenant l'ensemble des caractères Unicodes. Il est donc parfois utile de définir une police différente pour une langue différente.

Exemple

Soit le code suivant :

Le premier mot du livre de la Genèse est : \texthebrew{בְּרֵאשִׁ֖ית}.

Si je choisie d'utiliser comme police principale la police Linux Libertine [2], j'ai un problème : celle-ci ne supporte pas encore toutes les subtilités de l'hébreu biblique.

Ainsi j'obtiens le résultat suivant, assez inesthétique :

Mot hébreu avec Linux Libertine : bof, bof.

Évidemment je pourrais trouver une police gérant aussi l'hébreu, par exemple la classique Times New Roman :

Mot hébreu avec Times New Roman : mieux

Cependant, je peux préférer la Linux Libertine pour les caractères latins.

Varier la police

La solution est donc de prendre une police particulière pour l'hébreu, par exemple sur le site du SIL.

Il faut alors utiliser fontspec, qui permet de définir des nouvelles familles de caractères, en combinaison avec polyglossia, qui permet de gérer les changements de langue.

Pour cela, on définit une famille \font.

Donc pour avoir l'hébreu affiché avec la police Ezra SIL, je crée une nouvelle famille de polices :

\newfontfamily\hebrewfont[Script=Hebrew]{Ezra SIL}

Grâce à cela, la police change automatiquement lors de l'appel à \hebrewtext. N'oubliez pas cependant le Script=Hebrew. Il permet à XeLaTeX, lorsqu'il compose l'affichage final, d'utiliser les bon paramètres pour appeler les caractères de la police et par conséquent d'avoir un placement correct de ces caractères, notamment les niquud.

Mot hébreu avec la police Ezra Sil : un problème de taille

Régler la police

Comme vous pouvez constater, il y a un problème de taille. En effet, deux polices différentes n'ont pas, pour un même nombre de points, la même taille physique.

La solution est alors de dire à fontspec d'appliquer un redimensionnement sur la police. Dans le cas présent, nous souhaitons utiliser la police à 80 % de sa taille :

\newfontfamily\hebrewfont[Scale=0.8,Script=Hebrew]{Ezra SIL}

Mot hébreu avec la police Ezra Sil et une taille correcte

En problème connexe se pose la manière de saisir les caractères Unicodes. Je vous promet de vous écrire bientôt des articles pour expliquer comment créer son propre pilote de clavier sous Mac Os X...

[1] Du moins tout les caractères ayant été suffisamment étudiés pour pouvoir être décrits dans un certain formalismes. Ainsi certaines rares sont encore en cours d'intégration à Unicode...

[2] Via \setmainfont{Linux Libertine O}.

Formaliser les variantes textuelles avec (E)ledmac

Maïeul — 2012-09-20T15:21:32Z

Eledmac [1] permet d'associer des commentaires à certains mots d'un texte. Il peut donc servir pour établir des éditions critiques.

Néanmoins, il ne propose pas de formalisation de l'encodage des variantes. Chacun est donc libre d'utiliser son propre encodage.

Cet article décrit une manière de formaliser ces encodages en tirant tous le parti des commandes LaTeX, et notamment du package etoolbox [2].

Le présent article est désormais inutile, si ce n'est pour comprendre comment produire de telles commandes, puisque j'ai publié un package en reprenant le principe.

Notre exemple

Soit cinq manuscrits d'un texte : P, A, B, C, D. P est le manuscrit qui sert de référence. Les variantes de A, B, C, D sont indiquées dans l'apparat.

Soit le pseudo-mot « Lorem ». Ce mot subit les variantes suivantes :

manuscrits A et B : mot omis.
manuscrit C : mot remplacé par « loram ».
manuscrit D : mot remplacé par « lorim ».

Approche non formalisée

Si on ne formalise notre apparat, on pourrait mettre :

\edtext{lorem}{\Afootnote{AB \emph{omit} ; C loram ; D lorim}}

Qui produit dans l'apparat :

lorem] AB omit ; C loram ; D lorim

Les limites de cette approche sont évidentes :

Si on change de présentation, on doit changer toutes nos notes.
Impossible de produire des statistiques.
Difficulté à exporter vers d'autres formats que LaTeX.
Impossible de vérifier si on ne s'est pas trompé dans l'indication du manuscrit.

Proposition de formalisation

Pour obtenir le même résultat, nous proposons la formalisation suivante :

\var{lorem}{A,B}{
{{C}{loram}},
{{D}{lorim}}
}

\var est une commande personnalisée, qui prend les arguments suivants :

Texte principal
Liste des manuscrits où le mot est omis.
Liste des variantes, séparées par des virgule. Chaque variante est indiquée sous la forme {manuscrit}{variante}.

Mise en œuvre : liste des commandess

Nous allons déclarer les commandes suivantes :

\var (3 arguments), commande principal, qui appellera :
- \del (1 argument), chargée d'indiquer les omissions [3]
- \variantes (1 argument) chargé d'indiquer les variantes. Cette commande appelera elle même une commande \variante chargé de formaté une variante particulière (2 argument : le manuscrit et la variante).

Ce qui donne le schéma suivant :

Schéma des commandes d'indication de variantes

Mise en œuvre, étape 1 : la commande `\del`

Commençons par déclarer notre commande principale, \variante.

\newcommand{\var}[3]{% \edtext{#1}{\Afootnote{\del{#2}}}
}

Pour le moment, nous ne nous occupons que d'indiquer les omissions. Nous passons le premier argument de \var comme premier argument de \edtext, et nous passons le second argument à la commande \del, à l'intérieur de l'argument dans \Afootnote.

La commande \var est définie ainsi :

\newcommand{\del}[1]{% \renewcommand{\do}[1]{##1}% \docsvlist{#1} \emph{omit}%
}

Analysons le code, en commençant par la ligne 3 :

\docsvlist est une commande d'etoolbox. Elle analyse une liste d'éléments séparés par des virgules [4]. Chaque élément de la liste est passé à une commande \do. Ici, nous analysons l'argument #1, qui contient la liste des manuscrits où la variante est omise.

Une fois cette boucle effectuée, nous indiquons que les manuscrits omettent la variante via \emph{omit}

La commande \do est définie en standard par etoolbox. Cependant nous allons ici la rédéfinir, mais uniquement à l'intérieur de \del. C'est à dire que la définition que nous en donnons ne sera pas valable si on l'appel en dehors de \del.

Ici, nous nous contentons d'afficher l'argument, dans le cas présent le manuscrits. Comme notre commande est définie à l'intérieure d'une autre commande, ses arguments sont indiqués par deux #, et non pas un seul.

Si nous utilisons la formulation précédente, nous obtenons alors :

lorem ] AB omit

Ce qui est bien. Néammoins supposons que nous ne souhaitons pas indiquer de manuscrits omettant le mot, mais seulement des manuscrits le changeant :

\var{ipsum}{}{{C}{ipsem}}

On obtient alors un inesthétique :

ipsum] omit

Pour éviter ce problème, nous allons utiliser la commande \ifstrempty{chaîne}{sioui}{sinon}, qui appelle sioui si chaîne est vide, et sinon si la chaîne n'est pas vide.

Nous ferons l'appel dans la commande \variante, pour conditionnner l'appel à \del :

\newcommand{\var}[3]{% \edtext{#1}{\Afootnote{% \ifstrempty{#2}{}{\del{#2}}% }}
}

Mise en œuvre, étape 2 : les commandes `\variante` et `\variantes`

La commande \variantes est la suivante :

\newcommand{\variantes}[1]{% \newif\iffirst% \firsttrue% \renewcommand{\do}[1]{\iffirst\firstfalse\else ; \fi\variante##1}% \docsvlist{#1}% }

Analysons :

L. 2-3 : nous déclarons un test : \iffirst. Cela nous permettra d'afficher un point virgule avant le variante uniquement si nous ne somme pas à la première variante.
L. 4 : à nous une commande \do :
- \iffirst\firstfalse\else ; \fi : \iffirst teste si nous sommes à la première variante (cf. l. 2-3).
  - Si tel est le cas, nous appelons \firstfalse, qui permettra que \iffirst soit faux prochain passage.
  - Si tel n'est pas le cas (\else), on affiche un point virgule : \else ; .
  - \fi finit la structure de test commencé par \iffirst.
- Nous appelons ensuite la commande \variante. Notez à nouveau le double #. Vous remarquerez que nous ne mettons pas de {} pour indiquer les arguments de la commande. En effet, si vous vous rappellez de la syntaxe utilisée, nos variantes sont justement indiqué sous la forme {manuscrit}{texte}.
  - L. 5 nous bouclons sur toute les variantes.

Passons à la commande \variante. Elle est déclaré ainsi :

\newcommand{\variante}[2]{% #1 #2% }

Rien de bien méchant : on affiche simplement le manuscrit (#1, puis la variante (#2).

Il nous faut maintenant appeler \variantes à l'intérieur de \var.

\newcommand{\var}[3]{% \edtext{#1}{\Afootnote{% \ifstrempty{#2}{}{\del{#2}\ifstrempty{#3}{}{ ; }}% \variantes{#3}% }}
}

Le seul élément notable est l. 3 : après avoir affiché les omissions, nous affichons un point virgule, si jamais nous avons des variantes (\ifstrempty{#3}{}{ ; }.

Nous obtenons alors le résultat désiré :

lorem] AB omit ; C loram ; D lorim

Et pour un peu plus de contrôle : une liste des manuscrits

Suppons que par inadvertance, nous ayons indiqué un manuscrit E, qui n'existe pas :

\var{dolor}{E}{}

Il serait bon que LaTex nous indique notre erreur.

Pour ce faire nous allons utiliser :

le mécanisme d'affichage d'erreur dans les logs, fournit par eledmac, à savoir la commande \eledmac@warning.
le mécanisme d'etoolbox de déclaration de liste.

Comme la commande \eledmac@warning contient un arobase, il nous faudra déclarer nos commande entre \makeatletter et \makeatother.

Commençons par créer une commande : \manuscrits. Cette commande contiendra une liste de manuscrits, qu'etoolbox pourra consulter pour :

vérifier si un manuscrit existe, avec \ifinlist{\manuscrits}{sioui}{sinon}.
faire une boucle dessus pour afficher les manuscrits avec \dolistloop{\manuscrits}.

\newcommand{\manuscrits}{}
\listadd{\manuscrits}{A}
\listadd{\manuscrits}{B}
\listadd{\manuscrits}{C}
\listadd{\manuscrits}{D}

L. 1 nous déclarons une liste vide, l. 2-5 nous la complétons.

Puis modifions nos commandes \del et \variante.

\newcommand{\del}[1]{% \renewcommand{\do}[1]{% \ifinlist{##1}{\manuscrits}% {##1}% {\eledmac@warning{Man. ##1 inconnu, p.\the\page@num ; l.\the\line@num}Man. ##1 inconnu}% }% \docsvlist{#1} \emph{omit}%
}

L. 3 : Nous testons si le manuscrit se trouve dans la liste
L 4 : Si tel est le cas, nous l'affichons.
L 5 : sinon nous émettons un message d'erreur, précisant le numéro de page (\the\page@num et de ligne \the\line@num [5]). Nous affichons également dans le PDF l'erreur.

Pour \variante, le code est similaire, mais nous indiquons également la variante proposée :

\newcommand{\variante}[2]{% \ifinlist{#1}{\manuscrits}% {#1 #2}% {\eledmac@warning{Man. #1 inconnu, p.\the\page@num ; l.\the\line@num ; #2}Man. #1 #2}% }

En guise d'exercice, par difficulté croissante :

Remplacer le séparateur entre les variantes par une double barre verticale.
Créer une variante de \var qui permette de déclarer une même variante pour plusieurs manuscrits : \var{amet}{}{{A,B}{amet}}
Créer une commande \ledmanuscrits qui reçoit comme argument une liste de manuscrits séparés par des virgules et les ajoute à \manuscrits.
Améliorer le code pour imposer que l'ordre des manuscrits soit celui indiqué dans \manuscrits (je n'ai pour le moment aucune idée de l'algorithmique derrière).

[1] Où ledmac, son précédesseur

[2] Ce package est chargé par défaut avec eledmac, mais non pas avec ledmac.

[3] Il n'est pas possible de déclarer \omit : une telle command existe déjà dans LaTeX.

[4] csv = « comma separated values »

[5] \page@num et \line@num sont des compteurs internes à eledmac. Néanmoins, ce sont des compteurs TeX et non pas LaTeX : d'où la syntaxe \the\xxx pour les afficher.

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.

Afficher le nombre d'entrées dans une bibliographie

Maïeul — 2012-08-12T21:35:49Z

J'ai récemment répondu à une question d'une personne qui souhaitait afficher le nombre d'entrée d'une bibliographie, mais sans afficher cette bibliogaphie.

Le problème

La personne avait une base de donnée bibliographique avec le champ keyword rempli, pour distinguer plusieurs projets. Il souhaitait ensuite afficher le nombre d'entrées pour chaque projets, mais ne pas afficher la bibliographie du projet, ou en tout cas, pas tout de suite. Cependant, il voulait pouvoir utiliser les options de sélections d'entrée, par exemple :

\nocite{*} \printbibliography[keyword=projetx] \printbibliography[keyword=projety]

Ceci afficher les entrées ayant (respectivement) le mot clef projetx et le mot clef projet2. La personne souhaitait compter simplement le nombre d'entrées pour chacun des mots.

Principe de solution

Le principe de la solution est le suivant :

avoir un compteur \refs qui enregistrerait le nombre d'entrée par catégorie.
avoir un nouveau type de bibliographie finale qui se contenterait d'incrémenter le compteur à chaque entrée, puis d'afficher le valeur du compteur, sans pour autant afficher les entrées.

Mise en place

Dans le préambule, mettre :

\newcounter{refs} \makeatletter \defbibenvironment{counter}% {\setcounter{refs}{0}% \renewcommand{\blx@driver}[1]{}% }% {\therefs}% {\stepcounter{refs}}% \makeatother

L. 1 : création du compteur refs.
L. 2 : nous allons utiliser des commandes avec des @ dans le nom : nous avons besoin de \makeatletter.
L. 3 : définition d'un nouveau type de bibliographie finale, appelée counter :
- Au début de cette bibliographie :
  - L. 4 : réinitialisation du compteur refs.
  - L. 5 : modification de la commande appelée pour afficher l'entrée : nous ne voulons pas afficher d'entrée.
- L. 7 : à la fin de la bibliographie, affichage du compteur.
- L. 8 : à chaque entrée, incrémentation du compteur.
L. 9 : plus besoin d'utiliser @ dans les noms de commandes.

On consultera le manuel de biblatex pour plus de détails sur l'utilisation de \defbibenvironment.

Il faut également permettre de ne pas avoir de titre à la bibliographie :

\defbibheading{counter}{}

Utilisation

Pour afficher le nombre d'entrées liées au mot projetx, il suffit d'utiliser :

Nous avons \printbibliography[env=counter,heading=counter] entrées pour le mot projetx.

Et si notre mot projetx à 2 entrées, cela donne :

Nous avons 2 entrées pour le mot projetx.

Quelqu'un a suggéré d'utiliser \AtDataInput. Je pense effectivement que cela pourrait être mieux, mais peut poser des problèmes si on utiliser des sous-entrées bibliographiques que l'on ne veut pas avoir dans le total des bibliographies. À tester donc.

Le problème notamment est si l'on a beaucoup de test à faire : il faut les répéter selon deux syntaxes différentes : dans la bibliographie finale et dans le AtDataInput.

Pour ceux qui souhaite afficher le totale directement après la bibliographie, utilisez la contribution "Compter le nombre d'entrées dans une bibliographie".

Division de sources et abréviations

Maïeul — 2012-03-05T18:41:14Z

Cet article annule et remplace mon article de novembre sur les divisions de sources et les op. cit. J'ai en effet trouvé une méthode beaucoup plus simple et généraliste pour résoudre les problèmes qui y étaient soulevés.

Rappelons le problème : j'utilise un système se basant sur le mécanisme des références croisées et du champ titleaddon pour gérer la division des sources.

Ce système fonctionne bien, mais la gestion des abréviations de type op. cit. et ibid. pose problème. Il nous faut donc modifier les macros standard de biblatex.

Je tiens à remercier Ratatouille pour m'avoir relancer sur le sujet ce qui m'a permis de trouver une solution satisfaisante.

Les exemples

Pour cet article, je me base sur les entrées suivantes :

@bookinbook{ActaPetriPauli, Address = {Hildesheim and New York}, Booktitle = {Acta apostolorum apocrypha}, Editor = {Richard Aldebert Lipsius}, Entrysubtype = {apocryphes}, Pages = {178-222}, Publisher = {Georg Olms Verlag}, Title = {Acta Petri et Pauli}, Usera = {1}, Volume = {I}, Year = {1972 (rééd. de 1891)}} @bookinbook{ActaPetriPauli80, Crossref = {ActaPetriPauli}, Pages = {213-214}, Title = {Acta Petri et Pauli}, Titleaddon = {80}, Usera = {1}} @bookinbook{ActaPetriPauli81, Crossref = {ActaPetriPauli}, Pages = {214-215}, Title = {Acta Petri et Pauli}, Titleaddon = {81}, Usera = {1}}

Premier problème : perte de la division de source

Soit le code suivant :

\cite{ActaPetriPauli81} … \cite{ActaPetriPauli81}

J'obtiens par défaut :

Acta Petri et Pauli, 81, dans Acta apostolorum apocrypha, t. I, éd. Richard Aldebert Lipsius, Hildesheim et New York : Georg Olms Verlag, 1972 (rééd. de 1891), p. 214–215

…

Acta Petri et Pauli, op. cit.

Pour rétablir la division de source, il me faut modifier la manière dont sont affichées les versions abrégées. Cela se passe via la macro cite:title, qui par défaut est définie ainsi, dans le style verbose-trad-2 :

\newbibmacro*{cite:title}{% \printtext[bibhyperlink]{% \printfield[citetitle]{labeltitle}% \setunit{\nametitledelim}% \bibstring[\mkibid]{opcit}}}

Il suffit de la modifier pour lui indique d'imprimer le champ titleaddon et le champ pages :

\renewbibmacro*{cite:title}{% \printtext[bibhyperlink]{% \printfield[citetitle]{labeltitle}% \setunit{\nametitledelim}% \bibstring[\mkibid]{opcit}% \setunit{\bibpagespunct}% \printfield{titleaddon}% \setunit{\bibpagespunct}% \printfield{pages}% }}

J'obtiens alors :

Acta Petri et Pauli, 81, dans Acta apostolorum apocrypha, t. I, éd. Richard Aldebert Lipsius, Hildesheim et New York : Georg Olms Verlag, 1972 (rééd. de 1891), p. 214–215

…

Acta Petri et Pauli, op. cit., 81, p. 214-215

De même, pour gérer le cas où nos deux références se suivent immédiatement, et donc où la deuxième est remplacée par idem, il me faut modifier la macro cite:idem, qui par défaut est ainsi définie :

\newbibmacro*{cite:ibid}{% \printtext{% \bibhyperlink{cite\csuse{cbx@lastcite@\thefield{entrykey}}}{% \bibstring[\mkibid]{ibidem}}}% \ifloccit {\global\toggletrue{cbx:loccit}} {}}

Il suffit de la redéfinir ainsi :

\renewbibmacro*{cite:ibid}{% \printtext{% \bibhyperlink{cite\csuse{cbx@lastcite@\thefield{entrykey}}}{% \bibstring[\mkibid]{ibidem}}}% \setunit{\bibpagespunct}% \printfield{titleaddon}% \iffieldundef{titleaddon}{}{\setunit{\bibpagespunct}% \printfield{pages}}% \ifloccit {\global\toggletrue{cbx:loccit}} {}}

Second problème : pas de op. cit. si je ne cite pas le même passage

J'essaie maintenant :

\cite{ActaPetriPauli80} … \cite{ActaPetriPauli81}

J'obtiens alors

Acta Petri et Pauli, 80, dans Acta apostolorum apocrypha, t. I, éd. Richard Aldebert LIPSIUS, Hildesheim et New York : Georg Olms Verlag, 1972 (rééd. de 1891), p. 213–214

…

Acta Petri et Pauli, 81, dans Acta apostolorum apocrypha, t. I, éd. Richard Aldebert LIPSIUS, Hildesheim et New York : Georg Olms Verlag, 1972 (rééd. de 1891), p. 214–215

Pas très joli, joli ! Et puis cela prend de la place, ce n'est pas très écolo, donc pas non plus Joly.

Dans mon précédent article, c'est ici que les j'avais en effet opté pour une solution peut satisfaisante, qui consistait à tester si l'élément parent avait été cité. Cette solution était peu satisfaisante pour deux raisons :

Elle ne permettait pas d'obtenir un résultat correct si l'élement parent n'avait pas été cité [1].
Elle ne permettait pas d'utiliser des ibid de manière correcte [2].

La solution que j'ai désormais adoptée est plus efficace. Elle se comprend à partir de la manière dont biblatex gère les abréviations de type op. cit. : en stockant dans des tableaux et variables (au sens des langages de programmations) les valeurs du champ entrykey du l'entrée courante. Comme son nom l'indique, ce champ a pour valeur par défaut la clef de citation de l'entrée courante : par exemple ActaPetriPauli81. Toutefois, il est possible, comme pour tout les champs, de modifier temporairement cette valeur au sein d'une macro bibliographique. Nous allons nous servir de cette possibilité pour lui affecter la valeur du champ crossref. Par conséquent, lorsque je citerais une sous-entrée de ActaPetriPauli, j'indiquerais à biblatex de retenir l'entrée ActaPetriPauli dans sa liste des entrées à abréger.

Pour mettre la valeur du champ crossref dans le champ entrykey, il faut procéder en deux temps [3] :

Copier sa valeur dans une commande \crossref, à l'aide de la commande \savefield.
Copier la commande \crossref, à l'aide de la commande \restorefield. Ce qui donne :
```
\savefield{crossref}{\crossref}\restorefield{entrykey}{\crossref}
```

Bien sûr, il faut également conditionner cette copie :

À la présence d'un champ crossref, sinon on risque d'avoir des problèmes.
À la présence d'un champ titleaddon, car les crossrefs ne sont pas systématiquement pour des divisions de sources. On utilise pour cela la commande bien connue \iffieldundef :
```
\iffieldundef{crossref}{}{\iffieldundef{titleaddon}{}{\savefield{crossref}{\crossref}\restorefield{entrykey}{\crossref}}}
```

Reste à choisir où mettre ces commandes ! Il faut savoir que la gestion des versions abrégées des références se fait au niveau d'une macro cite qui est la première macro appelée par les commandes \XXXcite. Dans le style verbose-trad-2 cette macro est définie ainsi :

\newbibmacro*{cite}{% \usebibmacro{cite:citepages}% \global\togglefalse{cbx:fullcite}% \global\togglefalse{cbx:loccit}% \bibhypertarget{cite\the\value{instcount}}{% \ifciteseen {\iffieldundef{shorthand} {\ifciteibid {\usebibmacro{cite:ibid}} {\ifthenelse{\ifciteidem\AND\NOT\boolean{cbx:noidem}} {\usebibmacro{cite:idem}} {\usebibmacro{cite:name}}% \usebibmacro{cite:title}}% \usebibmacro{cite:save}} {\usebibmacro{cite:shorthand}}} {\usebibmacro{cite:full}% \usebibmacro{cite:save}}}}

Il suffit donc d'insérer notre code de « recopie » en début de macro :

\renewbibmacro*{cite}{%
\iffieldundef{crossref}{}{\iffieldundef{crossref}{}{\iffieldundef{titleaddon}{}{\savefield{crossref}{\crossref}\restorefield{entrykey}{\crossref}}}}% \usebibmacro{cite:citepages}% \global\togglefalse{cbx:fullcite}% \global\togglefalse{cbx:loccit}% \bibhypertarget{cite\the\value{instcount}}{% \ifciteseen {\iffieldundef{shorthand} {\ifciteibid {\usebibmacro{cite:ibid}} {\ifthenelse{\ifciteidem\AND\NOT\boolean{cbx:noidem}} {\usebibmacro{cite:idem}} {\usebibmacro{cite:name}}% \usebibmacro{cite:title}}% \usebibmacro{cite:save}} {\usebibmacro{cite:shorthand}}} {\usebibmacro{cite:full}% \usebibmacro{cite:save}}}}

J'obtiens correctement :

Acta Petri et Pauli, 80, dans Acta apostolorum apocrypha, t. I, éd. Richard Aldebert LIPSIUS, Hildesheim et New York : Georg Olms Verlag, 1972 (rééd. de 1891), p. 213–214

…

Acta Petri et Pauli, 81, op. cit., p. 214–215

La précédente version de cet article contenait une astuce concernant les pages référencées avec la commande \cite. Cette astuce n'avait à vrai dire rien à voir avec le problème qui nous occupe : je l'ai reproduite dans un article dédié.

[1] C'était là mon troisième problème, que je n'arrivais pas à résoudre.

[2] Je ne m'étais pas aperçu de ce problème

[3] Je renvoie au manuel de biblatex pour plus de détails.

Combiner Ledpar et Bibleref

Maïeul — 2011-10-29T21:31:04Z

J'ai utilisé l'autre jour pour la première fois le package ledpar [1]

Dans l'une des mes colonnes, j'ai souhaité mettre des références bibliques, via la commande \bibleverse du package bibleref-french. Dans un précédent article, j'avais expliqué ma commande personnelle pour faciliter l'utilisation de ce package. J'ai donc souhaité l'utiliser. Et patatra, j'obtient eu une erreur de compilation !

Une jolie erreur de type « undefined control sequence ». Après quelque temps de réflexions, j'ai compris d'où venait le problème. Pour pouvoir afficher ses lignes en parallèles, ledpar stocke le contenu dans des « boîtes ».

Or la commande \bibleverse est une commande « fragile ». Ce qui veut dire qu'elle est interprétée avant d'être stockée en boîtes.

Par conséquence, ce n'est pas elle qui est stockée en boîte, mais son contenu, à savoir l'appel à des commandes contenant des @. Or des telles commandes ne peuvent pas être appelées directement dans un fichier .tex, ou dans un boîte [2]. Par conséquent, cela provoque des erreurs de compilation [3].

La solution ? Protéger la commande avec \protect.

Par conséquent, il me faut remplacer

\newcommandx*\bible[3][1,2]{%
\ifthenelse{\equal{#1}{}}% {\emph{#3}}% % Si on indique pas de référence {% \emph{#3}\footnote{\bibleverse{#1}(#2)}% }%
}

par

\newcommandx*\bible[3][1,2]{%
\ifthenelse{\equal{#1}{}}% {\emph{#3}}% % Si on indique pas de référence {% \emph{#3}\footnote{\protect\bibleverse{#1}(#2)}% }%
}

Et voilà, plus d'erreur de compilation !

On pourra consulter une petite explication en anglais sur les commandes fragiles et robuste.

On peut également consulter [une petite explication sur makeatletter makeatother

[1] Alors même que je suis censé en être le mainteneur !

[2] C'est le fameux \makeatletter et \makeatother qui permet éventuellement de les utiliser dans un fichier .tex.

[3] En langage TeXnique, notre commande \bibleverse est dite « fragile ».

Geekographie Maïeulesque

xindy, hyperref et |see

Fichier d'exemple

Analyse du fichier .idx et du fichier .ind

Modification du .xdy

Définition de \seelink et de \targetindexentry

Correction de \hyperlink et hypertarget

Régler l'apparence des index avec xindy

Exemple adapté à la situation

Répartition des tâches

Trois exemples de configuration niveau LaTeX

Colonages : les options de indextools

Apparence des sectionnement par lettre

Une flèche avant les sous-entrée bibliographique

XXX exemples de configuration niveau au niveau de xindy

xindy, ou la succession de fichiers de configuration

Séparation l'entrée et ses références par une ligne de point

Regrouper les pages dans un intervalle

Pas de regroupement des pages

Regroupement dès deux pages

s et ss

Synthèse

Mixer numérotation continue et discontinue

Description du problème

Solution : principe

Solution : mise en œuvre

Commandes à arguments illimités

Problème

Solution : principe

Mise en œuvre

Langues dans un alphabet non latin et polices de caractère

Unicode ne suffit pas

Exemple

Varier la police

Régler la police

Formaliser les variantes textuelles avec (E)ledmac

Notre exemple

Approche non formalisée

Proposition de formalisation

Mise en œuvre : liste des commandess

Mise en œuvre, étape 1 : la commande \del

Mise en œuvre, étape 2 : les commandes \variante et \variantes

Et pour un peu plus de contrôle : une liste des manuscrits

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

Afficher le nombre d'entrées dans une bibliographie

Le problème

Principe de solution

Mise en place

Utilisation

Division de sources et abréviations

Les exemples

Premier problème : perte de la division de source

Second problème : pas de op. cit. si je ne cite pas le même passage

Combiner Ledpar et Bibleref

Analyse du fichier `.idx` et du fichier `.ind`

Modification du `.xdy`

Définition de `\seelink` et de `\targetindexentry`

Correction de `\hyperlink` et `hypertarget`

Colonages : les options de `indextools`

XXX exemples de configuration niveau au niveau de `xindy`

`xindy`, ou la succession de fichiers de configuration

`s` et `ss`

Mise en œuvre, étape 1 : la commande `\del`

Mise en œuvre, étape 2 : les commandes `\variante` et `\variantes`

Trier selon le champ `shortseries`