Geekographie Maïeulesque

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.

LaTeX en ligne de commande

Maïeul — 2011-05-22T09:54:29Z

La plupart des éditeurs de textes spécialisés en LaTeX [1] proposent un bouton pour mettre en œuvre les principales commandes de compilation : LaTeX, XeLaTeX, MakeIndex, BibTeX.

Toutefois très rapidement il devient nécessaire de pouvoir faire plus : par exemple si l'on dispose de plusieurs index, il faut compiler chaque fichier d'indexation.

Pour cela la méthode la plus simple est de passer par la ligne de commande. Cette article explique comment faire, sous Mac, avec le Terminal. Je ne connais ni Linux ni Windows, donc je ne peux dire [2].

Il ne vise donc pas à présenter comment se servir du Terminal, mais à montrer ce qui est nécessaire pour se servir de LaTeX avec le Terminal.

Qu'est-ce que le Terminal ?

Le Terminal est un logiciel qui permet de taper des commandes : il s'agit (sommairement) de chaînes de caractères qui vont exécuté des scripts sur l'ordinateur.

Dans le terminal on peut donc taper des commandes.

Naviguer dans le Terminal : la commande `cd`

La première chose nécessaire à l'utilisation de LaTeX avec le Terminal est de se rendre dans le dossier où se situe le fichier .tex à compiler.

Pour ce faire il faut utiliser la commande cd. Elle permet de se déplacer dans l'arborescence des dossiers. La syntaxe est simple cd chemin_du_fichier.

Le chemin peut s'exprimer :

de manière absolue en en mettant un / en début : par exemple :

/Users/maieul/documents

de manière relative au dossier courant en ne mettant pas de / au début. Par exemple, si je veux me déplacer dans le dossier B du dossier A du dossier courant :

cd A/B

On peut également utiliser le signe ~ pour désigner le dossier de départ [3]. Deux points de suite signifient que l'on remonte dans l'arborescence : cd ..

Toutefois on peut aussi simplement taper cd puis glisser/déposer un dossier dans le terminal : celui-ci « frappera » automatiquement le chemin.

Il suffit alors de frapper sur la touche « retour » pour changer de répertoire :

Exemple :

cd ~/Documents/master/memoire

Les différentes compilations

On peut alors lancer les différentes compilations depuis le terminal :

Compilation (X^e)LaTeX du fichier principal

latex fichier.tex

ou bien si on utilise XeLaTeX

xelatex fichier.tex

Compilation de la bibliographie

bibtex fichier

ou bien si on utilise Biber, ce que je recommande

biber fichier

Notez bien l'absence de d'extension : les commandes bibtex et biber vont repérer automatiquement les bons fichiers.

Compilation de l'index

makeindex fichier.idx

Avec un fichier de style .ist, on peut donner aussi :

makeindex -s index.ist fichier.idx

Avec ceci il est donc possible de compiler plusieurs index : je renvoie aux documentations des packages index et multind.

Ceci ne fonctionne que si vous avez installé LaTeX via TeXMac.

[1] Comme par exemple TeXShop ou TeXmaker.

[2] Même si je pourrais chercher.

[3] Le dossier avec une maison dans laquelle se trouve vos dossiers Documents etc.

Trouver les fichiers par défaut

Maïeul — 2011-03-21T10:05:36Z

Il peut être utile de trouver les fichiers par défaut LaTeX chargés par défaut lors d'une compilation.

Pour quoi faire ?

L'intérêt de trouver les fichiers par défaut est relativement évident : analyser leur code pour éventuellement apporter des modifications (par exemple : le style des bibliographies).

Ces modifications peuvent se faire de deux manières :

soit en reprenant l'intégralité du fichier à côté de son fichier maître, et en modifiant la ligne qui nous intéresse. Cela n'est pas recommandé car on ne profite pas ainsi des mises à jour de l'ensemble du fichier.
soit en reprenant les seules commandes / chaînes de langues / macros qui nous intéressent.

Comment faire

Lors de la compilation d'un fichier LaTeX, un fichier .log est créé. Celui-ci liste l'ensemble des fichiers appelés. C'est donc ce fichier qu'il faut analyser pour trouver le chemin du fichier par défaut qui nous intéresse.

Un index des sources primaires (2)

Maïeul — 2011-01-14T11:04:44Z

Suite de mon précédent article sur la manière de faire un index des sources primaires en LaTex.

J'explique comment se servir du script Python que j'ai développé [1].

[Mise à jour : j'ai trouvé une solution bien meilleure. En conséquent, cette contribution est obsolète.]

Utilisation du script : installation des paquets Python

Il faut avoir Python installé sur son ordinateur. Il est livré en standard sous MacOs, et je pense dans la plupart des distributions Linux.

Pour Windows, c'est par là : http://www.python.org/download/windows/.

Il faut ensuite installer le paquet zbibtex.

Pour ce faire :

récupérer le fichier .gz, le décompresser.
avec la console de commande (le Terminal sous MacOs), se rendre dans le dossier correspondant.
taper python setup.py install, voire sudo python setup.py install pour avoir les droits d'administrateur.

Bien !

Utilisation du script : organisation du fichier `.bib`

Le script indexera avec comme entrée principale l'auteur, et comme entrée secondaire le titre.

Pour l'auteur, il prendra la valeur du champ userb et, à défaut, celle du champ author. Pour le titre, il prend le champ indextitle et, à défaut, le champ title.

Il faut installer le script .py à côté du fichier LaTex source. Ce script ne fonctionne, évidemment, que si vous avez mis en œuvre la première étape, l'étape LaTex, décrite dans mon article précédent.

Par ailleurs les clefs de référence bibliographique ne doivent contenir que des caractères alphanumériques : pas de signe de ponctuation, de tirer ou autre. Sinon cela fait planter le script ...

Enfin votre fichier doit être encodé en unicode, et utilisé les accents unicodes, et non pas les pseudo accents LaTex [2].

Utilisation du script : personnalisation des variables

Ouvrez le fichier avec un éditeur de texte. Vous trouverez les lignes suivantes.

#### definition des constante
modification = [('biblio.bib','principal.sox','principal.sod'),('biblio.bib','principal.sex','principal.sed')]

Chaque série entre parenthèses correspond à un index différent. La première valeur correspond au fichier .bib. La seconde au fichier produit par la première compilation de LaTex. La troisième à celui utilisé par la seconde compilation, et produit par la compilation avec MakeIndex.

Ainsi, si votre fichier père s'appelle main.tex, que votre fichier de bibliographie s'appelle bibliographie.bib, et que pour la déclaration des index vous avez mis dans votre en-tête latex :

\usepackage{index}
\makeindex
\newindex{sources}{pmx}{pmd}{Index des sources}
\newindex{secondaires}{bix}{bid}{Index des études}

Il faudra que vous mettiez

#### definition des constante
modification = [('bibliographie.bib','main.pmx','main.pmd'),('bibliographie.bib','mainbix','main.bid')]

Ensuite, avec votre invite de commande, après la première compilation LaTex du fichier principal, faite :python index.py

Cela va lire les fichiers d'index, les modifier pour insérer une indexation correcte, puis les compiler avec MakeIndex. Inutile donc de compiler ensuite avec MakeIndex.

L'insertion sera de la forme : \textsc{Nom}, Prénoms (particule), suffixe!titre Important : en revanche, il sera nécessaire de passer par cette étape après chaque compilation LaTex du fichier principal. En effet, chaque compilation remplace le fichier auxiliaire.

Il vous reste ensuite à recompiler avec LaTex le fichier principal. Et voilà, vous obtiendrez un index des sources, trié par auteur puis par titre.

J'ai longtemps hésité : fallait-il classer dans la rubrique LaTex ou dans la rubrique Python ? Comme cela concernait un besoin LaTexien, j'ai choisi de mettre cela dans la rubrique LaTex.

Ce script est soumis à la même licence que l'ensemble du site, à savoir Creative Common, pas d'utilisation commerciale, paternité, partage des conditions initiales à l'identique.

[1] Pour les Pythoniens, j'espère avoir mis assez de commentaires dans le fichier.

[2] Dans BibDesk c'est une option à cocher dans les préférences

Geekographie Maïeulesque

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

LaTeX en ligne de commande

Qu'est-ce que le Terminal ?

Naviguer dans le Terminal : la commande cd

Les différentes compilations

Trouver les fichiers par défaut

Pour quoi faire ?

Comment faire

Un index des sources primaires (2)

Utilisation du script : installation des paquets Python

Utilisation du script : organisation du fichier .bib

Utilisation du script : personnalisation des variables

Mise en œuvre : 1^er essai

Syntaxe de base du fichier `latexmkrc`

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

Le fichier `makefile` final

Naviguer dans le Terminal : la commande `cd`

Utilisation du script : organisation du fichier `.bib`