Geekographie Maïeulesque

Bug avec polyglossia v1.45 et reledpar

Maïeul — 2020-04-21T06:00:00Z

La version 1.45 de polyglossia a changé certaines commandes utilisées par reledpar. Par conséquent, celui-ci n'était plus capable de gérer correctement le changement de langue entre les deux textes mis en parallèles.

Nous nous sommes aperçu de cela après la sortie de la TeXLive 2020. Par conséquent, les correctifs ne sont pas disponibles dans la TeXLive 2019.

Correctifs à appliquer

Si vous utiliser la TeXLive 2019, ne mettez pas à jour polyglossia, ou revenez à une version antérieure à la 1.45.
Si vous utiliser la TeXLive 2020, mettez à jour reledpar pour avoir la version 2.23.1.

Bug avec polyglossia 1.42.4

Maïeul — 2016-04-13T14:42:10Z

Décidément, c'est la saison des bugs. La version 1.42.4 de polyglossia, envoyée sur le CTAN le 25 mars, casse les espaces à l'interieur des guillemets français.

Voici comment contourner le problème, en attendant qu'il soit résolu directement dans polyglossia.

Le problème

Soit le les lignes suivantes :

\documentclass{article} \usepackage{polyglossia} \setmainlanguage{french} \setotherlanguage{english} \usepackage[french=guillemets]{csquotes} \begin{document} \enquote{x} \end{document}

Avant la version 1.42.4 de polyglossia, des espaces étaient automatiquement insérées au niveau des guillemets.

Espaces dans les guillemets : bonne typographie

Après cette version, les espaces disparaissent.

Pas d'espaces dans les guillemets : mauvaise typographie

La solution

Le problème a été introduit par un commit visant à résoudre un autre problème.

On pourrait évidemment surcharger le fichier french.ldf modifié par ce commit pour revenir à l'ancien fichier. Toutefois, il n'est en généralement pas conseillé de surcharger un fichier entier : on ne profite pas des évolutions futures.

Cependant il est assez simple de corriger cela. Il suffit de rétablir au sein de la commande \french@punctuation les codes commentés, et ce grâce à la commande \apptocmd qui permet d'ajouter des morceaux de code à la fin d'une commande déjà existante.

Comme la commande \french@punctuation contient des @, et que les commandes que l'on souhaite insérer aussi, il faut entourer notre \apptocmd de \makeatletter…\makeatother.

Cela étant, le seul bout de code à insérer dans le préambule est :

\apptocmd{\french@punctuation}{% \XeTeXinterchartoks \french@punctguillstart 255 = {\nobreakspace\xpg@nospace}% "« " -> "«~" \XeTeXinterchartoks 255 \french@punctguillend = {\xpg@unskip\nobreakspace}% " »" -> "~»" }{}{}

Je ne manquerais pas de vous tenir au courant lorsque la nouvelle version de polyglossia sera sortie, mais il faudra alors passer à la TeXLive 2017, la TeXLive 2016 étant gelée.

Corrigenda : si vous utiliser TeXLive 2016, lisez l'article suivant "Polyglossia et XeLaTeX 3.14159265-2.6-0.99996 (TeXLive 2016)".

Remerciement à Aurélien Berra pour avoir signalé le problème et trouvé la piste de solution.

ArabLuaTeX : ArabTeX pour LuaLaTeX

Robert Alessi — 2016-04-13T06:30:00Z

La notation « ArabTeX » a été introduite sous TeX/LaTeX en 1992. Elle a été ensuite portée sous XeLaTeX par arabxetex. arabluatex l'introduit pour la première fois sous LuaLaTeX. arabluatex ne prend actuellement en charge que la langue arabe. C'est une différence importante par rapport à arabtex qui intègre un grand nombre de langues sémitiques. De nouvelles langues seront progressivement ajoutées à arabluatex, à commencer par l'hébreu et le syriaque.

Présentation

Il n'est pas question d'entrer ici dans le détail. Le package, actuellement en version 1.0.1 est publié sur le CTAN, où l'on peut trouver une documentation complète.

Pour une comparaison entre arabtex (pour (La)TeX), arabxetex (pour XeLaTeX) et arabluatex (pour LuaLaTeX), je renvoie à cette documentation (point 1.1).

Comme arabtex, arabluatex transforme la notation ASCII ArabTeX en arabe unicode. Cette notation est intéressante à deux titres :

elle s'intègre parfaitement au code informatique. Cela est particulièrement important quand il s'agit de saisir des documents complexes, tels que des documents scientifiques ou des éditions critiques dans lesquelles abondent toutes sortes d'annotations. Ce n'est pas le cas du script arabe unicode, qui perturbe constamment le sens des crochets, parenthèses, accolades et autres signes informatiques, sans parler des interversions de mots.
elle permet un encodage précis de la langue arabe, et donne la possibilité, par exemple, de séparer les préfixes, les particules et les affixes, introduisant ainsi la possibilité de recherches grammaticales selon des critères complexes.

Il faut ajouter à cette liste les différentes possibilités de traitement du code ASCII ArabTeX :

vocalisation totale (scriptio plena) : mode [fullvoc]
vocalisation : mode [voc]
arabe non-vocalisé (scriptio defectiva) : mode [novoc]
translittération selon les différents standards : mode [trans]

Tous ces traitements sont possibles à partir d'une seule opération de saisie.

Particularités

Le fonctionnement d'arabluatex est très différent de celui de ses prédécesseurs. Le traitement du code ASCII ne repose ni sur TeX ni sur le moteur TECkit, mais sur un jeu de fonctions Lua. Dans un premier temps, sont traitées dans les environnements arabes toutes les commandes LaTeX qui sont censées avoir de l'arabe dans leurs arguments, comme \emph ou \textbf. Ensuite, le code ASCII, une fois isolé, est confié à de nouvelles fonctions qui appliquent diverses tables de correspondances selon les choix qui ont été faits.

Autre particularité très importante : arabluatex ne fait appel ni à polyglossia ni à luabidi. Les sens d'écriture sont pris en charge directement par les primitives de LuaTeX que sont \pagedir \bodydir \pardir et \textdir. Sous LuaTeX, c'est en effet toujours ainsi que l'on devrait régler les sens d'écriture.

Dernier point important : arabluatex ne traite pas le code ASCII tout à fait comme ses prédécesseurs. Il faut donc lire la documentation avant de l'utiliser.

Pour ne prendre ici qu'un exemple, sous arabluatex on ne doit jamais écrire deux fois une lettre solaire pour obtenir le tašdīd euphonique. Ainsi, pour obtenir اَلشَّمسُ, on peut écrire al-^samsu ou a^s-^samsu, mais jamais al-^s^samsu qui est en fait absurde.

arabluatex et reledmac

Dans les environnements \arb{} ou\begin{arab} ... \end{arab} la commande à double argument \edtext{}{} est prise en charge. On peut ainsi avoir ceci :

\beginnumbering \pstart \begin{arab} wa-ya.sIru ta.hta 'l-jildi \edtext{\arb{.sadIduN}}{\Afootnote{M: \arb{.sadIdaN} E1}} \end{arab} \pend \endnumbering

Comme on le voit, dans l'édition d'un texte arabe, il faut remettre la commande \arb{} dans le premier argument de \edtext{}{}. On peut ainsi avoir comme lemme du texte dans une autre langue que l'arabe.

arabluatex et les commandes complexes

Comme on l'a dit plus haut, toute commande LaTeX à argument simple, placée à l'intérieur d'un environnement arabe, est censée contenir exclusivement du texte arabe.

Parfois, ce n'est pas le cas. Par exemple, si l'on souhaite insérer une commande dont l'agument est une dimension, il faut l'insérer elle-même dans la commande \RL{} fournie par arabluatex, comme ceci :

\begin{arab} da_hala \RL{\hspace{1in}} mubtasimaN \end{arab}

Si l'argument ne contient que de l'arabe, on écrira :

\begin{arab} \index{d_hl}da_hala mubtasimaN \end{arab}

Et c'est tout ! La « magie » de Lua fera le reste, et l'on obtiendra à la fin un index tout arabe, avec un classement alphabétique correct. En revanche, si la commande \index{} ne contient pas que de l'arabe, il faudra écrire :

\begin{arab} \RL{\index{d_hl|see{...}}}da_hala mubtasimaN \end{arab}

En conclusion

Happy LuaTeXing, bien sûr !

xindy et bibleref

Maïeul — 2016-04-08T12:30:36Z

On m'a posé récemment la question de l'utilisation de xindy avec bibleref. Quelques petites adaptations sont nécessaires pour permettre aux deux outils de cohabiter.

Le problème

Soit l'exemple complet minimum suivant :

\documentclass[a4paper, notitlepage, 11pt]{article} \usepackage[xindy]{indextools} \usepackage{bibleref-french} \renewcommand{\biblerefindex}[0]{\index[bible]} \makeindex[name=bible, title=Index des sources bibliques] \begin{document} Une ref biblique: \ibibleverse{Lc}(3:12) \newpage \printindex[bible] \end{document}

Première compilation XeLaTeX : production d'un PDF sans index.

Compilation avec xindy

texindy -L french -I xelatex bible.idx

Seconde compilation avec XeLaTeX : un index vide. Ha ! Quid ?

Analyse du problème

Ouvrons le fichier .ind. On voit effectivement qu'il ne contient que l'introduction de l'index :

\begin{theindex} \providecommand*\lettergroupDefault[1]{} \providecommand*\lettergroup[1]{% \par\textbf{#1}\par \nopagebreak } \end{theindex}

Le problème se situe donc au niveau de texindy. Regardons donc les messages de compilation. Une ligne nous renseigne sur la cause du problème :

WARNING : unknown attribute `textrm' ! (ignored)

Rappelons que pour xindy un attribut correspond à ce qui est mis après un | lors de l'indexation.

En ouvrant le fichier .idx produit lors de la compilation, on constate effectivement la présence d'un |textrm.

\indexentry{Lc\relax \relax @\BRbooktitlestyle {Luc}!003:012@\BRchapterstyle {3}\BRchvsep \BRversestyle {12}|textrm}{1}

À la différence de makeindex, tout attribut doit être déclaré explicitement dans un fichier .xdy. En l'occurrence, le |textrm ne me paraît pas particulièrement utile. Donc plutôt que de le déclarer dans un .xdy, nous allons plutôt demander à bibleref de ne pas l'insérer.

Pour cela, une seule ligne suffit, à mettre dans le préambule :

\renewcommand{\bvidxpgformat}{}

Résultat final

Après cela, recompilons avec XeLaTeX, puis avec texindy, puis à nouveau XeLaTeX.

L'index est effectivement inséré.

Un index biblique avec xindy

Évidemment, dans le cadre d'un index biblique, il n'est pas utile d'avoir des sectionnement de l'index par lettres. Mais je renvoie à mon article sur la personnalisation de l'apparence des index.

Bug in biblatex-bookinarticle 1.3.0

Maïeul — 2016-02-24T15:00:41Z

The version 1.3.0 of biblatex-bookinarticle introduced a big bug, which have broken compatibility with old bibtex's fields name. The version 1.3.1, just send on CTAN, fix it.

If needed, you can dowload it here.

biblatex-bookinarticle 1.3.1

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.

xindy, eledmac et hyperref

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

J'en viens maintenant à aborder l'utilisation de \xindy avec eledmac, et plus précisément avec sa commande \edindex qui permet d'indexer une référence en renvoyant à la page et au numéro de ligne.

Pré-requis

La compatibilité pleine de eledmac avec xindy n'est fournie qu'avec la version 1.22.0 de eledmac.

Pour l'installer :

télécharger le zip disponible sur le CTAN.
appliquer la commande pdflatex sur les deux fichiers .ins pour obtenir les fichiers .sty.
mettre les fichiers .sty à côté de votre fichier d'exemple ou dans le dossier tex/latex/eledmac de [votre dossier texmf local.

Fichier d'exemple

Prenons un fichier .tex reprenant le code de mes précédents exemples, mais utilisant \edindex à la place de \index.

% À compiler avec XeLaTeX % À compiler avec XeLaTeX \documentclass{article} % Réglages géneraux \usepackage{fontspec} \setmainfont{Linux Libertine O} \usepackage{polyglossia} \setmainlanguage{french} \usepackage{setspace} \onehalfspacing % Définition des index \usepackage[xindy]{indextools}%On précise qu'on veut utiliser xindy % Apparence des index % Cf http://geekographie.maieul.net/171 \newcommand{\lettergroup}[1]{% {\centering\large---\emph{#1}---\par}% } \apptocmd{\subitem}{$\rightarrow$\,}{}{} % % Chargement de eledmac et de hyperref avec les bonnes options \usepackage[series={A},noeledsec,nofamiliar,noend,xindy,xindy+hyperref]{eledmac} \usepackage[hyperindex=false]{hyperref} % Toujours appeler \makeindex après le chargement de eledmac, cf doc de eledmac. \makeindex[name=animal,title=Animaux,columnseprule] \begin{document} \beginnumbering \autopar On va parler de chats sauvages\edindex[animal]{chat!sauvage} et domestiques\edindex[animal]{chat!domestique}, de tortues marines\edindex[animal]{tortue!marine} et terrestres\edindex[animal]{tortue!terrestre}, d'élèphant d'Asie\edindex[animal]{élèphant!d'Asie} et d'Afrique\edindex[animal]{élèphant!d'Afrique}, et soyons fou, d'élans de Sibérie\edindex[animal]{élan!de Sibérie} et d'Amérique\edindex[animal]{élan!d'Amérique}. On va parler au paragraphe suivant des même animaux. C'est à dire : de chats sauvages\edindex[animal]{chat!sauvage} et domestiques\edindex[animal]{chat!domestique}, de tortues \edtext{marines}{\Afootnote{ninja\edindex[animal]{tortue!ninja|textbf}}}\edindex[animal]{tortue!marine} et terrestres\edindex[animal]{tortue!terrestre}, d'élèphant d'Asie\edindex[animal]{élèphant!d'Asie} et d'Afrique\edindex[animal]{élèphant!d'Afrique}, et soyons fou, d'élans de Sibérie\edindex[animal]{élan!de Sibérie} et d'Amérique\edindex[animal]{élan!d'Amérique}. \edtext{Le paragraphe suivant est vraiment très particulier. Il est là juste pour tester ce que donne une indexation lorsqu'on parle d'une note qui est sur plusieurs lignes.}{\lemma{Le paragraphe…lignes}\Afootnote{serpent\edindex[animal]{serpent!de mer}}}% \endnumbering \newpage \beginnumbering \autopar Et pour la bonne cause, on va aussi parler de chats sauvages\edindex[animal]{chat!sauvage|textbf} qui se disputent avec les chiens errants\edindex[animal]{chien!errant}. \endnumbering \printindex[animal] \end{document}

Rien de très original dans le contenu, comme vous pouvez le constatez, si ce n'est que j'ai ajouté l'indexation d'un élément en note critique.

Les deux lignes les plus importantes pour le fonctionnement avec xindy sont :

\usepackage[xindy,xindy+hyperref]{eledmac} \usepackage[hyperindex=false]{hyperref}

La ligne \usepackage[hyperindex=false]{hyperref} vous laisse prendre la main sur l'ajout de liens hypertextes sur les localisation dans l'index, ainsi que je l'ai expliqué dans mon précédent article.

L'option xindy de eledmac est obligatoire si on souhaite utiliser \edindex avec xindy [1].

L'option xindy+hyperref permet en outre de faire fonctionner les liens internes.

Trois premières compilations XeLaTeX

Lorsqu'on indexe avec \edindex le fichier .idx n'est correct qu'après la troisième compilation (X^e)LaTeX. Nous supposons donc que vous faites trois compilations d'affilée de XeLaTeX.

À la fin de ces compiliations, outre le fichier .pdf et le fichier .xdy, vous obtenez un fichier eledmac-markup-attr.xdy.

Il s'agit d'un fichier de configuration xindy produit par eledmac et qui contient la déclaration des attributs de localisation propres à chaque entrée d'index produite par \edindex.

Compilation `xindy`

Il nous faut donc appeler ce fichier .xdy lors de notre compilation. Deux solutions s'offrent à nous.

La première consistent à passer le nom de ce fichier à l'option -M de texindy. Ainsi à la place d'appeler :

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

On appellera

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

Cependant il existe une solution plus simple : inclure l'appel à eledmac-markup-att.xdy directement dans le fichier monstyle.xdy via :

(require "eledmac-markup-attr.xdy")

Procédez donc à cette compilation : vous obtenez des lignes du type

WARNING : location-reference « 1-1 » did not match any location-class ! (ignored)

Ceci s'explique simplement : xindy n'est pas capable, par défaut, de comprendre une localisation de type numerodepage-numerodeligne tel que l'écrit \edtext dans le fichier .idx.

Qu'importe, nous allons lui apprendre, en ajoutant les lignes suivantes dans notre fichier de configuration .xdy [2] :

(define-location-class "eledmac" ("arabic-numbers" :sep"-" "arabic-numbers") :hierdepth 2 )

Ces lignes disent simplement qu'il existe une classe de localisation, c'est à dire une manière de référencer une entrée, nommée eledmac. Les entrées ainsi localisées possèdent deux niveau de localisation (:hierdepth 2), c'est à dire dans notre cas le page puis la ligne. Le premier niveau est écrit en nombre arabe, le second aussi, et les deux sont séparés par le caractère -.

Avec ces lignes nous arrivons à compiler correctement avec texindy. Cependant après la compilation XeLaTeX suivante, nous obtenons un index peu utilisable, comme vous pouvez le constatez dans le fichier ci-dessous.

Premier essai d'index avec eledmac + xindy

Le numéro de ligne est collé au numéro de page, si bien que l'index ne permet pas de retrouver la référence. Qu'importe, nous allons dire à xindy de mettre le numéro de ligne entre parenthèse, avec les lignes suivantes dans le fichier .xdy

(markup-locref-list :open " (" :sep ", " :close ")" :depth 1 :class "eledmac")

Nous indiquons que pour la classe de localisaton eledmac, que nous avions précédemment définie, le niveau 1 de localisation, c'est à dire dans le cas présent le numéro de ligne, puisque les niveaux commençent à 0, est marqué dans le fichier .ind par une parenthèse ouvrante au début et par une parenthèse fermante à la fin, les différentes entrées du même niveau étant séparées par des virgules.

Avec un tel fichier .xdy, après une nouvelle compilation xindy et une autre compilation XeLaTeX, nous obtenons un index final correctement formaté.

xindy et eledmac : exemple distinguant bien le numéro de ligne du numéro de page

Il y aura une suite à ces tutoriaux sur xindy, mais la semaine prochaine.

[1] En fait pas tout à fait : elle n'est obligatoire que si on souhaite mettre des index en notes de bas de page ou si on souhaite avec des liens hypertextes. Mais autant prendre l'habitude de la charger, cela évitera les mauvaises surprises.

[2] Attention à bien mettre ces lignes dans votre fichier et non pas dans le fichier eledmac-markup-attr.xdy, qui est réécrit à chaque compilation XeLateX !

xindy et hyperref

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

Nous arrivons maintenant à un point délicat dans l'utilisation de xindy : sa compatibilité avec le package hyperref. Ce dernier insère en effet des liens hypertextes dans l'index : chaque référence pointe vers la page correspondante. Cependant l'insertion de ces liens utilisent les mécanismes de makeindex et pas ceux de xindy ce qui n'est pas sans poser quelques petits problèmes.

Un exemple qui marche …

Reprenons l'exemple de l'article précédent mais en activant hyperref :

\documentclass{article} \usepackage{fontspec} \usepackage{polyglossia} \setmainlanguage{french} \setmainfont{Linux Libertine O} \usepackage{setspace} \onehalfspacing \usepackage[xindy]{indextools}%On précise qu'on veut utiliser xindy \makeindex[name=animal,title=Animaux,columnseprule] % Personnaliser l'apparence de lettergroup \newcommand{\lettergroup}[1]{% {\centering\large---\emph{#1}---\par}% } \apptocmd{\subitem}{$\rightarrow$\,}{}{} \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}. \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}. \printindex[animal] \end{document}

Cela produit le PDF ci-dessous.

xindy + hyperref : exemple qui fonctionne

Comme vous pouvez constater, tout semble fonctionner : notre index est correct et les liens internes fonctionnent.

… mais c'est tout

Les problèmes surviennent lorsqu'on tente de marquer une référence comme importante, par exemple avec |textbf. Ainsi :

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

Lors de la compilation texindy vous obtenez le message suivant :

WARNING : unknown cross-reference-class `hyperindexformat' !

Et de fait, la référence marquée par |textbf est absente de l'index final.

xindy + hyperref + |textbf ne fonctionne pas

La cause du problème

Rappelons que xindy se « contente » de transformer un fichier .idx en un fichier .ind. Ouvrons le fichier .idx pour comprendre comment cela.

À côté de ligne sans qui ne posent pas de soucis telle que :

\indexentry{chat!sauvage|hyperpage}{1}

Nous y trouvons la ligne problématique :

\indexentry{chat!sauvage|hyperindexformat{\textbf}}{3}

Et nous voici en face de deux limites de xindy [1] :

alors que makeindex transforme toute syntaxe de type |xxx en la commande correspondante, il n'en va pas de même avec xindy, qui nécessite qu'on lui déclare ces commandes manuellement. En effet, xindy, qui n'est pas conçue uniquement pour LaTeX, considère que la syntaxe |xxx après une entrée dans le fichier .idx correspond à un attribut de localisation, c'est à dire une propriété associée à la localisation d'une entrée. Certains de ces attribut de localisation sont déclarés dans le fichier base/latex-loc-fmts.xdy que texindy charge par défaut.
ces attributs ne peuvent pas recevoir d'arguments. Ainsi, même si nous déclarions hyperindexformat, cela ne nous arrangerait pas. En effet, les commandes avec arguments sont considérés par \xindy comme des marqueurs de renvois au sein de l'index, alors que makeindex est plus souple sur la question.

Solution

Comment résoudre ce problème ? En demandant à hyperref de ne pas intervenir dans la gestion du .idx et en gérant nous même cela via le fichier de configuration .xdy

Désactiver la modification de l'index par `hyperref`

Il suffit simplement de charger le package avec l'option hyperindex=false :

\usepackage[hyperindex=false]{hyperref}

Vous constaterez alors que le fichier .ind ne contient plus que des lignes de type :

\indexentry{chat!sauvage}{1}

\indexentry{chat!sauvage|textbf}{3}

qui sont très bien interprétés par xindy, mais sans évidemment que les liens hypertextes ne soit intégrés.

Configuration de `xindy`

Pour résoudre ce problème, il nous suffit d'ajouter dans le fichier de configuration .xdy les lignes suivantes :

(define-attributes ("emph")) (markup-locref :open "\hyperpage{" :close "}" :attr "default") (markup-locref :open "\textbf{\hyperpage{" :close "}}" :attr "textbf") (markup-locref :open "\textit{\hyperpage{" :close "}}" :attr "textit") (markup-locref :open "\emph{\hyperpage{" :close "}}" :attr "emph")

La première ligne permet de définir l'attribut emph qui n'est pas défini par défaut dans texindy alors qu'il est plus sémantique que l'attribut textit.

Dans les quatres lignes nous réglons la propriété markup-locref pour l'attribut de localisation indiqué entre guillemets après le :attr, sachant que l'attribut defaut est – comme son nom l'indique – celui utilisé si aucun attribut n'est mentionné.

Pour chaque attribut nous définissons via :open un marqueur à insérer avant la localisation, et via :close nous définissons un marqueur à insérer après la localisation.

Avec un tel système, notre fichier .idx deviendra un fichier .ind contenant des lignes telles que

\subitem sauvage\dotfill \hyperpage{1}--\hyperpage{2}, \textbf{\hyperpage{3}}

Ce qui est parfaitement compris par LaTeX lors de compilation suivante, \hyperpage insérant un lien hypertexte vers une page.

Cela nous permet d'obtenir le fichier ci-dessous, contenant de liens internes, y compris en gras.

xindy + hyperref + |textbf exemple qui fonctionne

[1] Bien tenues par rapport à ses avantages, puisqu'on peut facilement les contourner.

Hook de pre-commit pour fichier .dtx, .sty et autres fichiers de package

Maïeul — 2015-02-21T19:51:12Z

Dans un précédent article, je parlais de mon hook de pré-commit pour vérifier l'ajout de de % à la fin de chaque ligne dans un fichier .dtxy ou .sty.

J'ai amélioré ce hook pour lui ajouter d'autres fonctions de vérifications utiles lorsqu'on crée des packages LaTeX.

Principe

Les fichiers .dtx permettent de documenter un code LaTeX en même temps qu'on le saisit. Il nécessite cependant une syntaxe rigoureuse, et il m'arrive parfois de faire quelques erreurs.

Installation

Rien ne changer : télécharger le hook, l'installer dans le dossier .git/hook, le renommer pre-commit, et faire un chmod +x dessus.

Fonctionnalité

Fins de ligne

La fonction principale reste, bien sûr : impossibilité de commiter si un ligne non vide ne finit pas par un %, ou si ce % est précédé d'un ou plusieurs espaces.

Commande `\cs{}`

Impossible de commiter si l'argument d'une commande \cs commence par un \

Environnement `macro` et `macrocode`

Impossible de commiter si le début ou la fin de l'environnement n'est pas sur une ligne spécifique.
Vérification du nombre d'espaces entre le % et le \begin ou \end : 1 pour macro et 4 pour macrocode. Impossible de commiter dans le cas contraire.
Vérification des appareillement d'environnement. Attention, on ne vérifie pas les éventuelles suppressions de début/fin d'environnement. Impossible de vérifier dans le cas contraire.
Vérifier que le nom de la macro est bien mentionné après \begin{macro}.


		
		Comme avant, le code est versionné sur Github.



indextools, un fork de imakeidx
Maïeul — 2015-01-25T14:11:54Z
À mon grand regret j'ai du, pour la première fois de ma vie, créé un fork d'un package. Le package imakeidx a dont une nouvelle version : indextools.
		La raison technique
La raison technique de cette fork est la suivante : lorsqu'on utile hyperref en combinaison avec un package d'indexation, il est conseillé de charger hyperref après le package, pour avoir des liens internes.
Cependant hyperref doit être chargé avant bidi, le package qui permet de gérer les langues qui s'écrivent de droite à gauche. Ce qui fait que l'ordre de chargement correct est :
 imakeidx
 hyperref
 bidi
Malheureusement, bidi redéfinie la manière dont est affichée l'index, ce qui entraîne pour conséquent que certaine fonctionnalité de imakeidx, notamment le reformatage de l'index, ne sont plus prises en compte.
Pour résoudre ce problème, il fallait donc modifier imakeidx pour que ce dernier définisse l'affichage de l'index lors du \begin{document}, dont après bidi.
La raison humaine
Ayant trouvé ce bug, je l'ai signalé à l'auteur d'imakeidx. Celui-ci n'a pas daigné me répondre, même pour me dire, par exemple, que ma solution était mauvaise. Juste ... rien, pas de réponse.
Je l'ai donc contacté via un réseau public pour :
 lui demander pourquoi il ne répondait pas
 si c'était par manque de temps pour s'occuper d'imakeidx, s'il souhaitait me déléguer la gestion du package.
 sinon, s'il comptait intégrer une correction de ce bug.
L'auteur n'a pas répondu ni à la première ni à la troisième question. Quant à la seconde, il a indiqué, séchement, qu'il ne souhaitait pas que je reprenne le package.
Il a sans doute ses raisons, mais en attendant un bug existe, et je trouve idiot de laisse un package ainsi bugué.
C'est pourquoi j'ai, avec regret, décidé de forker le projet, c'est à dire d'en faire une version divergente de la version principale. Ce fork est donc sorti : indextools.
Pour le moment il se contente de résoudre ce bug. J'espère qu'un jour nous n'aurons plus qu'un seul package. En attendant, ceux qui souhaitent utiliser les fonctionnalités de bidi, hyperref et imakeidx en même temps peuvent utilise indextools.

Geekographie Maïeulesque

Bug avec polyglossia v1.45 et reledpar

Correctifs à appliquer

Bug avec polyglossia 1.42.4

Le problème

La solution

ArabLuaTeX : ArabTeX pour LuaLaTeX

Présentation

Particularités

arabluatex et reledmac

arabluatex et les commandes complexes

En conclusion

xindy et bibleref

Le problème

Analyse du problème

Résultat final

Bug in biblatex-bookinarticle 1.3.0

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

xindy, eledmac et hyperref

Pré-requis

Fichier d'exemple

Trois premières compilations XeLaTeX

Compilation xindy

xindy et hyperref

Un exemple qui marche …

… mais c'est tout

La cause du problème

Solution

Désactiver la modification de l'index par hyperref

Configuration de xindy

Hook de pre-commit pour fichier .dtx, .sty et autres fichiers de package

Principe

Installation

Fonctionnalité

Fins de ligne

Commande \cs{}

Environnement macro et macrocode

indextools, un fork de imakeidx

La raison technique

La raison humaine

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

Modification du `.xdy`

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

Correction de `\hyperlink` et `hypertarget`

Compilation `xindy`

Désactiver la modification de l'index par `hyperref`

Configuration de `xindy`

Commande `\cs{}`

Environnement `macro` et `macrocode`