XeLaTeX et Latexmk

jeudi 19 janvier 2017, mise à jour mercredi 25 janvier 2017, par Maïeul
Suivre la vie du site RSS 2.0 Forum

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 (Xe)LaTeX
  • compilation Biber [1]
  • compilation (Xe)LaTeX
  • encore une compilation (Xe)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 (Xe)LaTeX, puis regarde les fichiers intermédiaires produits (.aux, .bcf etc) et lance alors les scripts tels que Biber, puis à nouveau (Xe)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.

Notes

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

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

Vos commentaires

  • Le 26 septembre 2017 à 18:41, par Carg En réponse à : XeLaTeX et Latexmk

    Bonjour, Merci pour cette information. Pardon pour cette question naïve, mais j’ai un fichier de configuration .latexmkrc qui commence actuellement par :

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

    Est-ce que je dois conserver la seconde ligne définissant $pdflatex :

    $pdf_mode = "5" ;
    $pdflatex = "xelatex" ;

    Merci !

  • Le 26 septembre 2017 à 18:42, par Maïeul En réponse à : XeLaTeX et Latexmk

    Non justement, le but est de ne pas avoir cette deuxième ligne.

  • Le 13 octobre 2021 à 11:11, par Joseph Tux En réponse à : XeLaTeX et Latexmk

    Merci pour cet article (et pour tous les autres !)

    Dans mon ancien .latexmkrc, j’avais mis les 3 lignes suivantes : $pdflatex= "xelatex - -shell-escape %S" $pdfmode=1 $makeindex = "texindy -L french -I xelatex %S"

    pour utiliser xindy.

    avec la seule ligne que vous préconisez, est-il possible de mettre $xelatex= "xelatex —shell-escape %S" ou une autre façon d’imposer l’option « - -shell-excape » exigé par xindy (si j’ai bien compris !) ?

  • Le 13 octobre 2021 à 18:11, par Joseph Tux En réponse à : XeLaTeX et Latexmk

    Merci pour cet article (et pour tous les autres !)

    Dans mon ancien .latexmkrc, j’avais mis les 3 lignes suivantes :

    $pdflatex= "xelatex - -shell-escape %S"

    $pdfmode=1

    $makeindex = "texindy -L french -I xelatex %S"

    pour utiliser xindy.

    avec la seule ligne que vous préconisez, est-il possible de mettre $xelatex= "xelatex —shell-escape %S" ou une autre façon d’imposer l’option « - -shell-excape » exigé par xindy (si j’ai bien compris !) ?

Qui êtes-vous ?

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Acheter XeLaTeX appliqué aux sciences humaines

À propos

Titulaire d’un doctorat en théologie et d’un doctorat en histoire, sous la direction conjointe de Frédéric Amsler et d’Élisabeth_Malamut, je commence à partir du 1er août 2017 un travail d’édition critique des Actes de Barnabé.

Dans le cadre de la rédaction de mon mémoire de master puis de ma thèse de doctorat, j’ai été emmené à utiliser LaTeX, et j’ai donc décider de partager mes techniques. En effet, au cours de mes premiers apprentissages, j’ai découvert que les ressources indiquant les outils pour l’utilisation de LaTeX en sciences humaines étaient rares. Ceci m’a conduit à maintenir ou créer plusieurs packages LaTeX et à donner plusieurs formations.

J’ai reçu en 2018 le prix DANTE e.V pour mon travail autour de LaTeX, en particulier autour de reledmac et reledpar.

Par ailleurs, je suis membre actif de la communauté SPIP, au sein de laquelle j’administre le site Spip-Contrib. Je propose sur ce site quelques notes sur SPIP, en général à destination de webmestre.

Il m’arrive également de faire un petit peu de Python, de temps en temps.

Enfin, je tiens un blog de réflexions politiques et religieuses.

Maïeul