Geekographie Maïeulesque

XeLaTeX et Latexmk

Maïeul — 2017-01-19T20:53:03Z

La version 4.52 de Latexmk vient de sortir. Elle intègre directement le support de XeLaTeX. Ceci ne facilite pas que la création d'un fichier de configuration, mais permet de gagner un temps substantiel lors de la compilation. Explications.

Rappel : ce qu'est `Latexmk`

La compilation complète d'un document LaTeX suit en général les étapes suivantes :

compilation (X^e)LaTeX
compilation Biber [1]
compilation (X^e)LaTeX
encore une compilation (X^e)LaTeX pour s'assurer que tous les liens soient corrects et que la table des matières soit bien positionnée.

Cependant, il faut parfois plus de compilation, parfois moins, parfois il faut compiler deux fois avec Biber [2]. Or, il est difficile de déterminer à l'avance le nombre de compilations à exécuter.

Latexmk est un logiciel qui permet d'automatiser le processus sans se soucier du nombre de compilations. Pour se faire, Latexmk lance d'abord une compilation (X^e)LaTeX, puis regarde les fichiers intermédiaires produits (.aux, .bcf etc) et lance alors les scripts tels que Biber, puis à nouveau (X^e)LaTeX, jusqu'à ce que le contenu des fichiers intermédiaires soit stabilisé. On est ainsi assuré d'exécuter exactement toutes les compilations nécessaires, mais pas une de plus.

En outre, Latexmk indique en fin de compilation les clefs bibliographiques indéfinies et les labels problématiques.

Compatibilité avec XeLaTeX

Les anciennes versions de latexmk ne prenaient pas directement XeLaTeX en charge, et il fallait ajouter des lignes dans le fichier de configuration latexmkr les lignes suivantes :

$pdflatex = "xelatex %"; $pdf_mode = "1";

La nouvelle version de latexmk prend directement en charge XeLaTeX. Pour ce faire, il suffit :

soit de lancer latexmk avec l'option -xelatex : latexmk -xelatex fichier.tex
soit de mettre dans son fichier de configuration latexmkrc (à côté des sources à compiler) ou .latexmkrc (dans son répertoire utilisateur [3]) la ligne suivant :
```
$pdf_mode = 5;
```

Avantage de la compatibilité directe avec `XeLaTeX`

« À quoi bon écrire un article juste pour expliquer une petite modification de configuration ? » me diriez-vous. En réalité, le fait que latexmk gère directement XeLaTeX permet d'accélérer la compilation.

En effet, lorsque vous compilez avec XeLaTeX, celui-ci ne produit pas directement un fichier .pdf, mais passe par un fichier .xdy intermédiaire, qu'il transforme ensuite en fichier .pdf. Le processus est transparent pour l'utilisateur, si bien que vous ne voyez pas ce fichier intermédiaire. Mais si vous consultez le fichier de log de XeLaTeX, vous devrez trouver la ligne suivante :

File: l3xdvidpfmx.def 2016/08/18 v6679 L3 Experimental driver: xdvipdfmx

Cette ligne indique que le programme xdvipdfmx est appelé pour convertir les .xdy en .pdf.

Cette transformation est toutefois chronophage. C'est pourquoi, lorsque Latexmk est configuré pour utiliser XeLaTeX, il appelle ce dernier de sorte à ne produire que le fichier .xdy. Puis, lorsque les fichiers intermédiaires sont stabilisés, latexmk appelle xdvipdfmx pour produire le .pdf final à partir du .xdy.

Ainsi, si vous avez trois compilations XeLaTeX, xdvipdfmx n'est appelé qu'une fois, et non trois fois. Autant de temps et d'énergie gagnés.

[1] Ou BibTeX si vous êtes de l'ancienne école… mais dans ce cas vous ne lisez pas mon blog…

[2] Si vous utilisez mon package pour gérer les manuscrits avec BibLaTeX

[3] Ou ailleurs sur l'ordinateur pour partage entre plusieurs utilisateurs, voir la documentation de latexmk.

Premier pas avec xindy

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

Après avoir présenté rapidement ce qu'était xindy et pourquoi je recommande son utilisation, faisons les premiers pas avec xindy.

Pour le moment nous nous contenterons d'index un un document en français, avec deux index.

Préréquis

Je suppose que vous utilisez XeLaTeX et non pas LaTeX ou pdfLaTeX [1].

Je suppose également que xindy est installé sur votre ordinateur :

Si vous utilisez TeXLive2014 ou MacTeX 2014, c'est déjà le cas.
Si vous utilisez MikTeX, il existe un tutoriel pour l'installation. Je n'ai pas encore testé, donc tout retour est le bienvenu.

Enfin, je suppose que vous savez comment exécuter LaTeX et ses auxiliaires en lignes de commandes. Si vous ne savez pas :

lisez l'annexe de mon livre (obligatoire pour les gens sous windows)
ou bien lisez l'article LaTeX en ligne de commande

Fichier d'exemple minimal

Nous prendrons le fichier suivant [2] :

% À compiler avec XeLaTeX \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] \makeindex[name=plante,title=Plantes] \begin{document} On va parler de chats\index[animal]{chat}, de tortues\index[animal]{tortue}, d'élèphant\index[animal]{élèphant}, et soyons fou, d'élans\index[animal]{élan}. \newpage Ces animaux aiment bien les carottes\index[plante]{carotte}, les anémones\index[plante]{anémone}, les anthémis\index[plante]{anthémis}, et les courgette\index[plante]{courgettes}. \newpage \printindex[animal] \printindex[plante] \end{document}

Première compilation XeLaTeX

Compilez le document avec XeLaTeX. Vous obtenez deux pages, mais pas d'index. En revanche, vous obtenez le message suivant dans les messages de compilation

Package indextools Warning : Remember to run xelatex again after calling (indextools) texindy animal.idx'. Package indextools Warning: Remember to run xelatex again after calling (indextools)texindy plante.idx'.

Tout est dit : alors que indextools peut exécuter makeindex automatiquement, ce n'est pas le cas pour xindy [3].

Qu'importe, nous allons le faire maintenant.

Deux exécutions de `texindy`

On constate que deux fichiers .idx ont été produits : animal.idx et plante.idx. Nous allons donc les transformer en appelant texindy, le xindy préconfiguré pour LaTeX.

En ligne de commande donc, frapper (le $ représente l'invite de commande) :

$ texindy -L french -I xelatex animal.idx $ texindy -L french -I xelatex plante.idx

Explication de code :

texindy le programme que l'on appelle.
-L french utilisez les règles de classement alphabétique du français. Chaque langue à ses propres règles de classement [4], c'est pourquoi il est nécessaire de préciser la langue. Et si vous utilisez plusieurs langues dans votre index ? On y viendra plus tard.
-I xelatex indique que nous chargeons les règles propres à xelatex, autrement dit que nos fichiers .idx sont encodés en UTF8. Après chaque retour chariot, vous obtiendrez normalement des messages de compilation xindy.

Vous devriez désormais avoir deux fichiers ; animal.ind et plante.ind. Si oui, nous pouvons passer à la deuxième compilation XeLaTeX

Deuxième compilation XeLaTeX

Maintenant, recompilez votre fichier .tex avec XeLaTeX.

Vous devriez obtenir le fichier ci-dessous.

Premiers index avec xindy

On trouve bien les deux index, triée selon l'ordre alphabétique, avec les lettres accentuées bien placées.

On constate cependant une différence avec une compilation classique avec makeindex : les mots sont regroupés par lettres initiales, avec l'initiale affichée en début de chaque groupe. Nous verrons plus tard comment modifier l'apparence de cette initiale, voire la supprimer, lorsque nous aborderons la personnalisation de l'apparence de l'index.

Automatiser les compilations : `latexmk`

Par rapport à l'utilisation d'indextools + imakeidx nous avons perdu un peu au change : il faut procéder à une compilation supplémentaire de XeLaTeX, et en plus il faut compiler chaque fichier .idx.

En générale la deuxième, voire la troisième, compilation XeLaTeX est nécessaire, notamment si on a une bibliographie, des renvois internes et une tables des matières. Cependant, il serait plus simple d'avoir un outil qui nous fasse toutes ces compilation d'un coup.

Cet outil, c'est latexmk, dont j'ai déjà parlé.

Il nous suffit donc de mettre dans le fichier de configuration latexmkrc ou .latexmkrc :

$pdflatex = "xelatex %S"; $pdf_mode = "1"; $makeindex = "texindy -L french -I xelatex %S";

Pour qu'en ligne de commande un :

$ latexmk fichier.tex

fasse toutes les compilations.

[1] Pour ceux qui ne savent pas pourquoi je conseille XeLaTeX, lisez l'introduction de mon livre.

[2] Je suppose que vous avez la police Linux Libertine installé sur votre ordinateur. Si ce n'est pas le cas, vous pouvez commenter la ligne correspondante, cela ne change rien au problème, c'est juste plus esthétique.

[3] En fait c'est possible mais en appelant XeLaTeX avec certains options spécifiques. Peut importe, nous allons apprendre ici à utiliser latexmk pour simplifier.

[4] Par exemple : en français on classe d'abord sans tenir compte des accents, puis on les intègre dans un second classement ; en espagnol la ligature « ll » est classée comme une lettre à part, entre « l » et « m ».

Introduction à Latexmk pour faciliter les compilations

Maïeul — 2012-01-13T00:19:39Z

Suites aux remarques sur mon article à propos de make, j'ai me suis penché sur latexmk. C'est effectivement bien plus simple que makefile, même s'il y a encore quelques besoins auxquels je n'arrive pas à répondre.

Voici un petit tutoriel sur la manière de l'utiliser, notamment avec XeLaTeX

Principe

Quand on compile un document .tex il faut en général procéder à plusieurs compilations : avec LaTeX, puis avec biber, puis avec makexindex etc.

Latexmk permet d'automatiser ces compilations, en vérifiant à la suite de chaque compilation qu'elle doit être la prochaine compilation, et en regardant les fichiers auxiliaires (.aux, .bbl etc) pour voir s'ils changent entre les compilations, et donc s'il est nécessaire de procéder à plusieurs compilations.

Prenons un exemple simple : un fichier .tex sans bibliographie et sans index, mais avec un table des matières.

latexmk va d'abord compiler avec LaTeX. Puis il va voir qu'un fichier .toc est produit, ainsi qu'un fichier .aux. Il va alors procéder à une seconde compilation, et regarder si ces fichiers ont changé. Si il y a eu un changement, il va procéder à une troisième compilation et vérifier si ces fichiers ont changé. etc. Ainsi jusqu'à cinq fois (par défaut). Si au bout de la cinquième série de compilation les fichiers ont encore changé, il considère qu'il est impossible d'avoir des fichiers stables [1].

Maintenant imaginons que j'ajoute une bibliographie. Latexmk va pouvoir analyser à la première compilation LaTeX, en fonction des fichiers produits (le fichier bbl notamment) qu'il existe une biblio, qui réclame Biber (ou bibtex). Et il va automatiquement compiler avec biber (ou bibtex après la première compilation LaTeX, puis il procédera à une seconde compilation LaTeX etc.

Autrement dit, Latxmk est capable de mettre en œuvre les séries successives de compilation, et surtout de savoir quand il est nécessaire de procéder à une nouvelle compilation.

Mise en œuvre : 1^er essai

Latexmk est installé par défaut avec les différentes distributions LaTeX. Donc rien à installer.

Avec son Terminal, se rendre dans le dossier où se trouvent les fichiers à compiler [2].

Puis frapper latexmk nom_du_fichier_a_compiler. latexmk se lance et vous indique qu'il tente une première compilation :

Run number 1 of rule 'latex'

Il nous indique donc qu'il essaie de lancer la règle latex.

Qu'est-ce qu'une règle ? Une règle, c'est une suite d'opération nécessaire à la transformation d'un fichier a, par exemple un fichier .tex en un fichier b, par exemple un fichier .pdf, ou en l'occurrence un fichier .dvi (Je parles de ce fichier un peu plus bas.)

En l'occurence, la règle dit qu'il faut lancer le programme latex.

C'est ce qui se passe. Et là, patatra si vous utilisez XeLaTeX, avec le package fontspec vous obtenez un joli message The fontspec package requires either XeTeX or LuaTeX to function. et la compilation s'arrête là.

Logique : latexmk a essayé de compiler avec latex alors qu'il faudrait compiler à xelatex.

Il va donc falloir modifier le fonctionnement de latexmk, grâce à un fichier nommé latexmkrc à mettre dans le même dossier que les sources à compiler [3].

Syntaxe de base du fichier `latexmkrc`

Un tel fichier se compose d'une série de couple propriété / valeur. Chaque couple s'écrit une ligne avec la syntaxe suivante :

$proprieté = "valeur";

Première propriété : demander un fichier `pdf`

Il faut savoir qu'historiquement, LaTeX ne produisait pas de fichier .pdf, mais des fichiers .dvi. Ce n'est qu'avec le compilateur pdflatex qu'il a commencé à produire des fichiers .pdf.

La règle latex cherche à produire des .dvi.

Aujourd'hui, le .pdf est plus pertinent que le .dvi.

Nous allons donc mettre dans le fichier latexmkrc une demande de produire des fichiers .pdf.

Même si vous utilisez XeLaTeX, cette demande est très importante. En effet XeLaTeX ne produit pas des dvi mais que des pdf. Or si vous laisser les réglages par défaut, latexmk cherche à produire des dvi et n'y arrive pas.

Cette propriété, c'est pdf_mode. Si elle est égale à 1, alors latexmk va chercher à générer un pdf en utilisant la règle pdflatex.

Pour changer cette propriété, nous ajoutons donc à notre fichier latexmkrc :

$pdf_mode = "1";

Par ailleurs, par défaut cette règle pdflatex utilise le script pdflatex et non pas xelatex. Nous allons donc modifier cette règle, par la propriété pdflatex.

Deuxième propriété : utiliser XeLaTeX

La propriété pdflatex reçoit le nom de la commande à exécuter. En l'occurrence, pour nous il s'agit de xelatex.

Nous écrivons donc dans notre fichier :

$pdflatex = "xelatex";

On peut désormais lancer latexmk sans avoir d'erreur de compilation, puisque celui-ci va appeler la commande xelatex.

Par ailleurs, si une bibliographie est ajoutée, latexmk va lancer automatiquement biber ou biblatex, en choisissant lui-même le bon programme.

Troisième propriété : la génération de l'index

Lorsque latexmk détecte la création d'un fichier .idx, il sait qu'il s'agit d'un fichier d'index « brut », et qu'il faut le compiler pour obtenir des fichiers formatés.

Par défaut, il utilise makeindex. Mais on peut souhaiter utiliser splitindex lorsqu'on utilise le package splitidx pour avoir plusieurs index.

Il faut dire d'utiliser splitindex modifier la règle makeindex.

Nous pouvons donc mettre :

$makeindex = "splitindex";

Seulement cela pose un problème.

En effet, si j'ai un fichier principal.idx, latexmk s'attend que la règle makeindex produise un fichier principal.ind. Or splitindex produit des fichiers principal-xxx.ind, mais pas de fichier principal.ind.

La solution consiste à dire que la règle makeindex exécute plusieurs commandes : makeindex puis splitindex. Pour cela, il suffit de séparer chaque commande par un point virgule. Ce qui donne

$makeindex = "makeindex;splitindex;";

Problème : dans ce cas la commande makeindex ne vas pas s'exécuter sur le bon fichier. Il est donc nécéssaire de préciser le fichier sur lequel executer makeindex.

Pour cela, on utilise la notation %S, qui correspond au fichier source. Par exemple, dans le cas de la règle makeindex, il s'agit du fichier .idx, mais dans le cas de la règle pdflatex il s'agit du fichier .tex.

Donc cela donne :

$makeindex = "makeindex %S;splitindex %S;";

Et si j'utilise le script de gestion de l'index des sources primaires

Ce script que j'utilise pour la gestion de l'index des sources primaires [4] nécessite d'être appelé avant splitindex

Je serais tenté de faire :

$makeindex = "python index.py;makeindex %S;splitindex %S;";

Seulement voilà, cela entraîne latexmk à tourner en rond. Pourquoi ? Si je ne me trompe la raison est la suivante. Lorsque latexmk applique une règle, il regarde le contenu des fichiers générés par cette règle avant qu'elle soit appliquée et après son application. Si ces fichiers ont changé, il considère qu'il faudra réappliquer la règle.

Donc dans mon cas cela donne (en sautant les règles biber) :

Règle pdflatex, compilation avec xelatex, création du fichier .idx
Règle makeindex, modification du fichier .idx, via mon script python.
Règle pdflatex qui modifie à nouveau le fichier .idx.

Le fichier .idx a été transformé à l'issue de la deuxième application de la règle pdflatex, puisqu'on est passé d'un fichier qui avait subit le script python à un fichier qui ne l'a pas subit.

Donc latexmk se dit qu'il faudra réappliquer la règle pdflatex, mais aussi la règle makeindex, puisque celle-ci cherche à transformer les fichiers .idx.

Et comme la règle makeindex modifie, si j'y intègre le script python, le fichier .idx, on tourne en rond.

La solution est donc de mettre le script python n'ont pas au début de la règle makeindex mais à la fin de la règle pdflatex.

Donc non pas :

$makeindex = "python index.py;makeindex;splitindex;";

mais :

$pdflatex = "xelatex %S;python index.py";

Récapitulatif

Au final, mon fichier latexmrc contient les lignes suivantes :

$pdflatex = "xelatex %S;python index.py"; $pdf_mode = "1"; $makeindex = 'makeindex %S;splitindex %S;';

Un plus : les entrées bibliographiques indéfinies et les références introuvables

À la fin de l'exécution de latexmk, celui ci nous indique les entrées bibliographiques absentes de la base de donnée et les \label manquants :

Latexmk: Citation 'ti' on page 1 undefined Latexmk: Reference `ti' on page i undefined

En revanche, il ne mentionne pas les \label en nombre multiples.

On peut exécuter la commande

latexmk -c

pour nettoyer les fichiers intermédiaires (.aux, .ind etc.)

Malheureusement je n'ai pas encore trouvé comment faire pour que le nettoyage s'applique aussi aux fichiers :

.1,.2 du package ledmac
.idx et .ind produit par splitindex.

[1] Ce genre de cas est normalement rarissime.

[2] Pour apprendre à se servir de son Terminal sur Mac ; et pour Windows, pour les Linuxiens, c'est quasiment comme sur Mac.

[3] Il est possible de mettre ce fichier ailleurs, pour pouvoir appliquer un fonctionnement à l'ensemble des fichiers LaTeX que l'on traite. Voir la documentation de latexmk.

[4] Et qui vient d'être amélioré.

Introduction à make avec (Xe)LaTeX

Maïeul — 2011-08-08T13:42:26Z

Le programme make est un outil utilisé par les développeurs. On peut également s'en servir lorsqu'on fait du (X^e)LaTeX, pour automatiser les compilations.

En effet, il est assez courant de devoir faire plusieurs compilations successives, avec différents compilateurs ((X^e)LaTeX, SplitIndex, Biber etc.). Ces compilations doivent s'effectuer dans un certain ordre, parfois se répéter (par exemple en cas de variation des ruptures de pages, pour avoir une table des matières toujours à jour) etc.

Le risque est grand d'en oublier. C'est pourquoi utiliser make pour automatiser cela est une bonne idée. Voici un petit tutoriel à ma sauce. Il vient compléter celui qui m'a appris à me servir de make ainsi qu'un autre plus généraliste.

Que les puristes me pardonnent : il y a ici quelques approximations, pour les besoins de la cause.

On consultera désormais l'article sur LaTeXmk, qui est plus efficace.

Principe

Make est un logiciel qui sert à transformer un ou plusieurs fichiers en un fichier final. Pour ce faire, il va se servir d'un fichier makefile qui indique le fichier final souhaité, les fichiers sources initiaux et l'ensemble des étapes nécessaire à la production du fichier final.

Make est installé par défaut sur la plupart des distributions Linux. Sur Mac, il faut installer les outils dévellopeurs. En revanche son installation est complexe sur Windows.

Premier pas

Soit le dossier contenant les fichiers :

principal.tex
principal.bib

Je souhaite obtenir le fichier principal.pdf en exécutant successivement :

xelatex principal.tex
biber principal
xelatex principal.tex.
xelatex principal.tex pour avoir un sommaire correspondant à la mise en page finale.

Je vais écrire les lignes suivantes dans un fichier makefile [1].

principal.pdf: principal.tex principal.bib xelatex principal.tex biber principal xelatex principal.tex xelatex principal.tex

La première ligne indique que le fichier principal.pdf « dépend » de principal.tex et de principal.bib. Les lignes suivantes, qui doivent commencer par des tabulations, indique les commandes à exécuter pour produire le fichier. J'ai créé ainsi une règle de fabrication, nommée principal.pdf.

Lorsque dans mon terminal je tape (en étant situé dans le répertoire en question) : make principal.pdf, je vois les différentes compilation se succéder. À la fin je peux ouvrir mon fichier principal.pdf. Si je retape make principal.pdf, j'obtiens : make : `principal.pdf' is up to date.

En effet, makefile voit que les fichiers principal.tex et principal.bib ont été modifiés plus anciennement que le fichier principal.pdf. Il en conclut que le fichier principal.pdf est à jour.

En revanche, si je m'amuse à modifier l'un de ces fichier, taper make principal.pdf me recommencerait le processus de compilation.

Généralisons

Supposons qu'à côté de mes deux fichiers, j'ai également les fichiers annexe.bib et annexe.tex et qu'à partir de cela, je souhaite obtenir un fichier annexe.pdf.

Je pourrais m'amuser à créer une règle pour annexe.pdf. Mais je pourrais très bien fabriquer un règle générique pour les fichiers .pdf

%.pdf: %.tex %.bib xelatex $*.tex biber $* xelatex $*.tex xelatex $*.tex

Dans la description de la règle, le %.pdf signifie « n'importe quel fichier finissant par .pdf ». Pour la suite % signifie « la partie variante du nom du fichier », autrement dit « ce qui se trouve avant le .pdf ».

Dans le contenu de la règle, le $* signifie « la partie variante du nom du fichier de destination ».

Autrement dit, j'ai produit ici l'équivalent de

principal.pdf: principal.tex principal.bib xelatex principal.tex biber principal xelatex principal.tex xelatex principal.tex annexe.pdf: annexe.tex annexe.bib xelatex annexe.tex biber annexe xelatex annexe.tex xelatex annexe.tex

Mais cela pourrait s'étendre à fichier titi.pdf dépendant de titi.tex et titi.bib.

Évidemment mes fichiers cibles peuvent aussi dépendre de fichiers situés dans d'autres dossiers. Chez moi, par exemple, ce sont les fichiers situés dans les dossiers contenu et inclure. On peut indiquer la dépendance aux dossiers en indiquant la dépendance aux fichiers qu'ils contiennent.

%.pdf: %.tex %.bib contenu/*.tex inclure/*.tex xelatex $*.tex biber $* xelatex $*.tex xelatex $*.tex

Une règle par défaut

Pour le moment, je suis obligé, si je veux produire les fichiers principal.pdf et annexe.pdf, de faire successivement make principal.pdf et make annexe.pdf.

On pourrait vouloir produire ces deux fichiers d'un coup. Pour ce faire je vais créer une règle spéciale nommée all, que je vais placer en tout premier. Comme cette règle doit produire ces deux fichiers, je vais lui indique qu'elle nécessite les fichiers principal.pdf et annexe.pdf. Le programme make ira chercher les règles correspondante à la production de ces fichiers.

Ma règle s'écrit dont simplement :

all:principal.pdf annexe.pdf

Seulement voilà : imaginons que pour une raison quelconque, j'ai un fichier all dans mon dossier. Dans ce cas make je risque d'avoir des conflits. Pour éviter cela, je vais indiquer une règle spéciale : .PHONY. Cette règle indique simplement que les fichiers dont elle « dépend » n'existent pas, mais qu'il s'agit en réalité de nom de règle.

J'écris donc :

.PHONY:all

Si je tape make all, le programme va bien me produire mes deux fichiers principal.pdf et annexe.pdf.

Si je met cette règle en premier, elle sera exécutée si aucune règle n'est appelée, en frappant simplement make.

Nettoyage

La compilation produit tout le temps des fichiers annexes. Il peut être utile d'avoir une règle pour les supprimer automatiquement. La plupart du temps cette règle est appelée clean. Comme c'est une règle spéciale, il faut que je l'ajoute à la règle .PHONY

.PHONY:all clean

Voici un exemple de règle clean

clean: rm -f *.aux *.bcf *.log *.xml *.toc */*.aux *.bbl *.blg

La commande rm est une commande terminal qui efface les fichiers listés. L'option -f permet de ne pas avoir de message d'erreur si on demande l'effacement de fichiers qui n'existent pas. Ici nous demandons l'effacement des fichiers se finissant [2] par .aux, .bcf, .log, .xml, .toc, .bbl, .blg, ainsi que les fichiers .aux se situant dans des dossiers.

Affichage de message finaux

Reprenons notre règle %.tex. On aimerait avoir un message, à la toute fin des compilations, nous indiquant s'il y a des références bibliographiques inconnues.

Pour ce faire nous allons lire dans le fichier .log final, pour rechercher les ligne contenant Citation xxx undefined. Nous allons pour cela utiliser un programme, généralement livré en standard sous MacOs X et Linux, appelé grep. Ce programme permet de rechercher dans des fichiers du texte, en utilisant des outils de joker, qu'on appelle « expression régulière ».

Allons y, cela nous donne

%.pdf: %.tex %.bib contenu/*.tex inclure/*.tex xelatex $*.tex biber $* xelatex $*.tex xelatex $*.tex @echo "Citations indéfinies:" @grep -i "Citation .* undefined" $*.log || echo "Aucune"

Ligne 7, nous affichons, grâce à la commande Terminal toto le message « Citations indéfinies : ». Le @ sert à indiquer à make de ne pas afficher cette ligne [3].

Ligne 8, nous exécutons la commande grep. L'option -i permet de ne pas tenir compte de la casse. Nous recherchons dans le fichier .log tout les lignes contenant Citation suivi d'une série de n'importe quel caractère [4] suivi de undefined et nous les affichons. À défaut, nous affichons « Aucune ».

Évidemment on pourrait étendre cela aux tests des étiquettes de référence croisés : pour vérifier par exemple les étiquettes en double, ou celles inexistantes.

Cela donnerait

%.pdf: %.tex %.bib contenu/*.tex inclure/*.tex xelatex $*.tex biber $* xelatex $*.tex xelatex $*.tex @echo "Citations indéfinies:" @grep -i "Citation .* undefined" $*.log || echo "Aucune" @echo "Erreurs de label" @egrep -i "multiply defined" $*.log || echo "Pas de label multiple" @egrep -i "Reference .* undefined" $*.log || echo "Pas de label indéfini"

Le fichier `makefile` final

Au final, tout cela donne

.PHONY:all clean all:principal.pdf annexe.pdf clean: rm -f *.aux *.bcf *.log *.xml *.toc */*.aux *.bbl *.blg %.pdf: %.tex %.bib contenu/*.tex inclure/*.tex xelatex $*.tex biber $* xelatex $*.tex xelatex $*.tex @echo "Citations indéfinies:" @grep -i "Citation .* undefined" $*.log || echo "Aucune" @echo "Erreurs de label" @egrep -i "multiply defined" $*.log || echo "Pas de label multiple" @egrep -i "Reference .* undefined" $*.log || echo "Pas de label indéfini"

[1] Attention, il n'y a pas d'extension !

[2] Le caractère * est un joker signifiant « chaîne de taille indéfinie contenant n'importe quel caractère », je renvoi à n'importe quelle introduction au terminal.

[3] Pour mieux comprendre, vous pouvez essayer sans le @.

[4] Le .*, voir les tutoriaux sur les expressions régulières.

Geekographie Maïeulesque

XeLaTeX et Latexmk

Rappel : ce qu'est Latexmk

Compatibilité avec XeLaTeX

Avantage de la compatibilité directe avec XeLaTeX

Premier pas avec xindy

Préréquis

Fichier d'exemple minimal

Première compilation XeLaTeX

Deux exécutions de texindy

Deuxième compilation XeLaTeX

Automatiser les compilations : latexmk

Introduction à Latexmk pour faciliter les compilations

Principe

Mise en œuvre : 1er essai

Syntaxe de base du fichier latexmkrc

Première propriété : demander un fichier pdf

Deuxième propriété : utiliser XeLaTeX

Troisième propriété : la génération de l'index

Et si j'utilise le script de gestion de l'index des sources primaires

Récapitulatif

Un plus : les entrées bibliographiques indéfinies et les références introuvables

Introduction à make avec (Xe)LaTeX

Principe

Premier pas

Généralisons

Une règle par défaut

Nettoyage

Affichage de message finaux

Le fichier makefile final

Rappel : ce qu'est `Latexmk`

Avantage de la compatibilité directe avec `XeLaTeX`

Deux exécutions de `texindy`

Automatiser les compilations : `latexmk`

Mise en œuvre : 1^er essai

Syntaxe de base du fichier `latexmkrc`

Première propriété : demander un fichier `pdf`

Le fichier `makefile` final