LaTeX appliqué aux sciences humaines

En général, on n'installe pas LaTeX tout seul, on installe une distribution LaTeX.

Une distribution est un ensemble de fichiers comprenant :

• les logiciels TeX, LaTeX, et généralement XeLaTeX, mais aussi d'autres logiciels qui appartiennent à la « famille TeX(203) », que nous verrons en temps voulu ;
• des fichiers permettant d'étendre les possibilités de LaTeX : les packages et les classes ;
• de la documentation sur ces fichiers.

Il existe deux distributions courantes : TeX Live, qui se veut portable et est très adaptée pour MacOS X et Linux, et MikTeX pour Windows uniquement.

L'objet de ce chapitre est donc d'expliquer comment installer ces distributions.

La méthode la plus simple consiste à installer MacTeX(204). Celle-ci comprend non seulement une version de TeX Live pour Mac, mais aussi des logiciels pour faciliter la rédaction avec LaTeX.

Pour l'installer, il suffit de télécharger le fichier d'installation sur le site, en page d'accueil. Il s'agit d'un fichier .zip, qu'il faut le cas échéant décompresser.

Dedans se trouve un fichier .mpkg : un double-clic dessus suffit à lancer le logiciel d'installation. Il vaut mieux conserver les réglages standards d'installation.

Une fois l'installation effectuée, vous pouvez vous rendre dans le dossier « TeX » du dossier « Applications » de votre Mac.

Ce dossier comprend plusieurs applications :

Choisissez l'un d'entre eux pour commencer en LaTeX (☞ Chapitre 2Chapitre 2 - Commencer avec XeLaTeX).

En outre, un panneau de configuration, « Distribution TeX » est ajouté dans les Préférences Systèmes. Dans la plupart des cas, vous n'aurez pas à vous en servir. Il permet en effet de choisir entre plusieurs versions de la distribution (par exemple entre la version 2011 et la version 2012), ce qui est rarement nécessaire.

A-2-a. Les caractères LaTeX sous Mac Os X▲

La plupart du temps, les paquets TeX Live sont disponibles dans les dépôts de votre distribution. Néanmoins, la majeure partie des distributions GNU/Linux ne gèrent pas certains packages récents tels que Biber(205). C'est pourquoi nous privilégierons l'installation à partir du programme que vous pouvez trouver sur le site de TeX Live.

Une installation complète une fois effectuée pèse environ trois gigaoctets.

Le temps passant et les mises à jour s'accumulant, il est recommandé d'avoir quatre gigaoctets d'espace libre sur le disque dur.

A-3-a. Au préalable▲

sudo perl install-tl -gui wizard

A-3-b. Installation et configuration▲

Les systèmes Windows diffèrent considérablement des systèmes GNU/Linux et Mac OS X. Par conséquent, s'il est possible de faire une installation manuelle de la distribution TeX Live sous Windows, la procédure est fastidieuse et complexe.

C'est pourquoi nous nous tournerons vers une distribution consacrée exclusivement à Windows, qui automatise les tâches d'installation de la distribution LaTeX et permet de gérer son installation en se conformant aux pratiques qui ont cours sur ce système. Cette distribution a pour nom MiKTeX. Son installateur est très complet : en plus d'une distribution LaTeX, il installe aussi un logiciel graphique de mise à jour des paquets et un éditeur de texte.

A-4-a. Installation▲

La plupart des packages sont listés sur http://www.ctan.org/tex-archive/ qui sert de dépôt pour tous les projets tournant autour de TeX et LaTeX. C'est en général sur les serveurs du CTAN (Comprehensive TeX Archive Network) que les logiciels de mise à jour des packages vont chercher ceux-ci.

Pour être tenu au courant des nouveaux packages et des mises à jour des anciens packages, vous pouvez vous abonner à la liste https://lists.dante.de/mailman/listinfo/ctan-ann.

Les mises à jour de la distribution TeX Live ne sont fournies que pour une période d'un an environ après sa sortie (généralement entre mai et juillet). Passé ce délai, lorsque vous tenterez de mettre à jour votre distribution TeX Live, vous trouverez un message de ce type :

ou bien

Dans un tel cas, il vous faut soit installer une nouvelle version de la distribution TeX Live, en recommençant la procédure d'installation, soit continuer à utiliser l'ancienne qui ne reçoit plus de mises à jour. TeX Live est d'une grande stabilité, mais ce n'est pas nécessairement le cas de tous les packages que l'on peut être amené à utiliser. Si l'un des packages que vous utilisez est affecté d'un bogue qui vous gêne, vous n'aurez d'autre choix que de mettre à niveau la distribution TeX Live. Dans le cas contraire, vous pouvez parfaitement vous contenter de l'ancienne version.

A-5-a. Sous Mac OS X▲

A-5-b. Sous Linux▲

A-5-c. Sous Windows▲

B-1-a. TeXMaker (multiplateforme)▲

B-1-b. TeXWorks (Multiplateforme)▲

B-1-c. TeXShop (Mac)▲

Il existe deux principaux logiciels de gestion de fichier .bib : JabRef(208) et BibDesk(209). Tous les deux proposent de nombreuses fonctionnalités : recherches des doublons, tri selon plusieurs critères, import/export dans d'autres formats que .bib. Le choix entre les deux est donc délicat. Les utilisateurs Mac préféreront sans doute BibDesk, en raison de la proximité de son organisation avec certains logiciels Apple.

Pour BibDesk, le réglage en UTF-8 se fait dans les préférences, bouton « fichier ». Pour Jabref, il se fait dans les préférences, onglet « general ».

Ce qu'on appelle « répertoire courant » correspond à l'emplacement où l'on se situe dans l'arborescence des fichiers de l'ordinateur. Quand on veut utiliser les lignes de commande pour se servir de XeLaTeX, la première chose à faire est de changer le répertoire courant pour se rendre dans le dossier dans lequel se situent les fichiers à compiler.

Sur Mac OS X, le terminal se situe dans le dossier « Utilitaires » du dossier « Applications ».

Sous GNU/Linux, le Terminal se trouve dans le menu « Application » - « Accessoires », ou bien il vous suffit d'appuyer sur la touche « Windows » puis de taper les premières lettres de l'application : term devrait suffire. Cliquez sur le symbole qui apparaît.

Le répertoire courant est généralement indiqué à gauche de la ligne, le symbole ~ représentant le dossier de départ. Pour lister son contenu, frapper ls. Pour valider une commande, il faut frapper sur la touche Entrée.

Pour vous déplacer dans un répertoire, il suffit de frapper la commande cd suivie du dossier où vous souhaitez vous rendre.

Ainsi la commande cd projet-latex vous fait pénétrer dans le répertoire projet-latex, ce que vous pouvez vérifier avec la commande dir. Pour vous déplacer dans un répertoire parent, frappez simplement cd ..

Plutôt que de remonter de dossier en dossier avec la commande cd jusqu'au répertoire courant, on peut aussi taper cd suivi directement du chemin complet (☞ Comment indiquer le chemin du fichierComment indiquer le chemin du fichier) du dossier où l'on veut se rendre. Sous Mac ou sous Linux, si l'on n'est pas sûr du chemin, on peut le vérifier en faisant simplement glisser l'icône du dossier sur la fenêtre du Terminal : le chemin s'affiche alors.

Lorsque vous êtes dans le répertoire où vous souhaitez exécuter une commande, vous pouvez la lancer de la même manière :

xelatex nomdufichieràcompiler.tex
biber nomduficheràcompiler
makeindex nomdufichieràcompiler
etc.

Enfin la commande ls vous permet d'afficher le contenu du dossier dans lequel vous vous trouvez.

Sous Windows, le terminal s'appelle « Invite de commandes ». Le langage est différent de celui que l'on trouve dans les systèmes de type Unix comme Linux et Mac OS X. On trouve cependant quelques similarités.

Pour démarrer une invite de commande, pressez simultanément la touche Windows de votre clavier et la touche R. Dans l'invite qui s'ouvre frappez cmd puis Entrée. Vous voilà face à une console.

Toute commande, une fois frappée, est validée par une pression sur la touche Entrée.

Le répertoire courant est indiqué à gauche du curseur clignotant. La commande dir vous indique ce qui se trouve dans le répertoire courant.

Pour vous déplacer dans un répertoire, il suffit de frapper la commande cd suivie du dossier où vous souhaitez vous rendre.

Ainsi la commande cd projet-latex vous fait pénétrer dans le répertoire projet-latex, ce que vous pouvez vérifier avec la commande dir. Pour vous déplacer dans un répertoire parent, frappez simplement cd ..

Lorsque vous êtes dans le répertoire où vous souhaitez exécuter une commande, vous pouvez la lancer de la même manière :

xelatex nomdufichieràcompiler.tex

La commande dir affiche enfin le contenu du répertoire dans lequel vous êtes actuellement.

Pour pouvoir personnaliser le comportement standard de LaTeX ou d'un package, par exemple les styles de biblatex, il est en général nécessaire de regarder les fichiers standards pour redéfinir telle ou telle commande ou macro bibliographique.

Il faut donc trouver leurs emplacements. Dans le fichier .log produit lors de la compilation est listé l'ensemble des fichiers chargés par le compilateur. Il est général aisé de connaître le nom du fichier : il s'agit souvent de celui du package ou de la classe. Une recherche dans le fichier permet donc de trouver le chemin, par exemple :

        /usr/local/texlive/2012/texmf-dist/tex/latex/biblatex/cbx/verbose-trad2.cbx.

En général les fichiers se trouvent dans des répertoires invisibles via l'interface standard du système d'exploitation. Pour les ouvrir, il faut donc utiliser la ligne de commande, et frapper

Il ne faut jamais modifier les fichiers standards. En effet, en cas de mise à jour de ces fichiers, vous perdriez toutes vos modifications. Il vaut mieux en général redéfinir les commandes, quitte à grouper ces redéfinitions dans un fichier.

Latexmk est un script installé avec toutes les distributions LaTeX. Il s'utilise via la ligne de commande (☞ Annexe CAnnexe C - Introduction à la ligne de commande). Latexmk consulte les fichiers de compilation (.log) pour savoir quels sont les scripts à exécuter, et dans quel ordre.

Très simple d'utilisation, il nécessite toutefois quelques adaptations pour être compatible avec XeLaTeX. Nous les présentons ici, mais le programme propose beaucoup plus de réglages : nous renvoyons au manuel(210).

Pour configurer le script, il vous faut créer un fichier latexmkrc à côté du fichier à compiler. Dans ce fichier, écrivez les lignes suivantes, en prêtant attention aux points-virgules de fins de ligne :

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

La première ligne signifie que vous demandez à Latexmk de vous produire des fichiers .pdf et non pas .dvi, qui est le format « historique » produit par LaTeX.

La seconde ligne signifie que vous demandez à Latexmk d'utiliser XeLaTeX et non pas LaTeX pour produire ces .pdf.

Rendez-vous avec le terminal (☞ Annexe CAnnexe C - Introduction à la ligne de commande) dans le dossier du fichier à compiler. Frappez ensuite la commande suivante :

latexmk fichier

où fichier est le nom de votre fichier principal. Vous voyez alors défiler les différentes compilations. Latexmk se charge de faire autant de compilations que nécessaire, en tenant compte des éventuels déplacements d'étiquettes. À la fin de ces différentes compilations, vous trouverez le fichier .pdf désiré.

Toutefois, si vous appelez une entrée bibliographique non définie (☞ Chapitre 10Chapitre 10 - Remplir sa base de données bibliographique) ou une étiquette de renvoi interne (☞ Chapitre 16Chapitre 16 - Renvois internes) non définie, Latexmk ne procède qu'à cinq séries de compilations(211). Il vous indique cependant les entrées ou étiquettes problématiques, par des lignes ayant cette forme :

Latexmk : Citation 'XXX' on page YYY undefined
Latexmk : Reference 'XXX' on page YYY undefined

Il vous est donc aisé de retrouver les entrées bibliographiques (=« Citation ») et les étiquettes (=« Reference ») non définies.

Si vous utilisez le script de gestion de l'index des sources primaires (☞ Compilation et concaténation des indexCompilation et concaténation des index), il vous faudra également ajouter la ligne suivante :

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

Cette ligne indique à latexmk d'exécuter le script python avant la commande makeindex, le code %S désignant le fichier pour lequel makeindex doit être exécuté.

LaTeX étant d'origine anglophone, le séparateur des décimales doit être un point et non pas une virgule. Ainsi pour préciser une taille de 1,5 cm, il faut écrire : 1.5cm et non pas 1,5cm.

Les unités de mesure peuvent être divisées en deux catégories : unités absolues et unités relatives à la taille de la police courante. Nous ne présentons ici que les unités les plus courantes.

Il est également possible d'indiquer des longueurs relatives à certains éléments.

Il suffit d'indiquer un nombre décimal devant une commande de longueur.

Ainsi pour un trait horizontal d'une moitié de largeur de la ligne :

\noindent\rule{0.5\linewidth}{1pt}

Voici les principales commandes de longueur :

Il est possible de définir une certaine élasticité pour les longueurs, qui permet de s'adapter à l'espace disponible et aux contraintes de mise en page(212). On utilise pour cela les mots-clefs minus et plus. Ainsi, si nous souhaitons afficher un espace blanc (☞ EspacementsEspacements) vertical d'une longueur comprise entre 1 cm et 3 cm, mais tournant idéalement autour de 2,5 cm, nous écrivons :

\vspace{2.5cm minus 1.5cm plus 0.5cm}

Cette syntaxe est utilisée dans les commandes de définitions des en-têtes de section (☞ Définir l'apparence : sections et niveaux inférieursDéfinir l'apparence : sections et niveaux inférieurs), sous une forme légèrement différente : \@plus et \@minus ne sont que des alias LaTeX des mots-clefs TeX plus et minus.

Plus globalement, avec une syntaxe de longueur a minus b plus c la longueur finale m est telle que(213) a ≤ b ≤ m ≤ a + c.

Imaginons que Bob et Alice travaillent ensemble sur un projet(214). Ils souhaitent pouvoir échanger facilement leurs modifications.

Ils déposent pour cela les fichiers initiaux sur un serveur (un ordinateur distant). Puis chacun récupère ces fichiers sur son propre ordinateur, à l'aide de commandes spécifiques au logiciel utilisé.

Bob fait des modifications (1) : il envoie ces modifications sur le serveur, en les accompagnant d'un petit message les résumant. Alice peut alors récupérer ces modifications en local (2). Si Bob n'a modifié qu'un seul fichier, seul ce fichier sera récupéré par Alice : cela permet à Alice de modifier d'autres fichiers pendant ce temps. Une fois ses modifications faites, Alice les envoie sur le serveur, en les accompagnant d'un petit message les résumant (3), et Bob peut ainsi les récupérer. Ces étapes sont représentées dans ce schéma.

Il est aussi possible de faire d'autres opérations : renommer, déplacer, dupliquer les fichiers sur le serveur distant. En outre, ces logiciels permettent, si deux personnes ont fait des modifications en même temps sur le même fichier, de proposer de ne garder que certaines de ces modifications(215).

Un tel système présente de nombreux intérêts :

• il est aisé de s'assurer que l'on possède bien la dernière version du projet, contrairement aux échanges classiques par courriels qui peuvent rapidement semer la confusion ;
• on dispose d'un historique des versions permettant de revenir en arrière, le cas échéant(216) ;
• contrairement aux systèmes des logiciels de traitement de texte, l'historique des versions ne se situe pas à l'intérieur du fichier de travail, ce qui évite une prise de poids et un certain nombre de problèmes (notamment ralentissement et corruption du fichier).

Il existe de nombreux logiciels de suivi des révisions : citons SVN, Git et Mercurial. Le premier est sans doute plus simple en première approche, mais les deux autres possèdent des fonctionnalités plus souples, notamment parce qu'il n'y a pas un serveur unique, comme sur notre schéma, mais plusieurs serveurs qui peuvent être synchronisés.

Un certain nombre d'hébergeurs proposent des services SVN, Git ou Mercurial(217).

Git et Mercurial ne fonctionnent pas nécessairement avec un serveur distant.

C'est pourquoi on peut facilement s'en servir pour gérer un historique de modifications sur un projet monorédacteur.

La manipulation de ces outils peut se faire en ligne de commande, mais il existe également des logiciels graphiques.

Nous invitons le lecteur curieux à se renseigner sur Internet pour plus d'informations : il y trouvera aisément documentations et tutoriels(218).

Les forums Internet sur LaTeX sont pléthore. En anglais, on peut utiliser celui de « LaTeX Community » : http://www.latex-community.org/forum/. En français, on peut utiliser celui du site « Developpez.net » https://www.developpez.net/forums/f149/autres-langages/autres-langages/latex/.

Il est possible de demander de l'aide sur différents salons de messagerie instantanée fonctionnant par IRC(220). En général on peut y trouver de l'aide assez rapidement.

Pour se connecter à un salon de discussion IRC, on peut utiliser le plugin Chatzilla du logiciel libre Firefox.

En français, l'adresse est irc://irc.rezosup.org/latex; en anglais irc://irc.freenode.net/latex.

En français, celles de l'association Gutemberg : http://www.gutenberg.eu.org/?Listes-de-diffusion-gerees-par ; en anglais, la liste suivante : http://groups.google.com/group/comp.text.tex/topics, dont il est possible de se servir via un logiciel de gestion de « Newsgroups », par exemple Mozilla Thunderbird.

Nous ne listons pas ici l'ensemble des manuels des divers packages abordés.

Toutefois une question peut se poser : où trouver ces manuels ?

La solution la plus simple est d'ouvrir le terminal :

• sous Mac, ouvrir l'application « Terminal » dans le dossier « Utilitaires » ;
• sous Windows, ouvrir « l'invite des commandes » dans « Démarrer » : « Tous les programmes » : « Accessoires » ;
• sous GNU/Linux, appuyer sur la touche « Windows » et taper terminal.

Puis de frapper dans la fenêtre qui apparaît :

texdoc nomdupackage

Par exemple pour le package biblatex :

texdoc biblatex

Frapper un retour à la ligne : le manuel du package devrait s'ouvrir avec le logiciel adéquat (généralement le manuel est au format PDF).

Les livres sur LaTeX sont pléthore. Cependant rares sont ceux qui abordent XeLaTeX, polyglossia et biblatex. C'est pourquoi nous conseillons de les utiliser essentiellement pour les besoins les plus avancés de mise en page.

CHEVALIER, Céline dir., LaTeX pour l'impatient, H&K, 2009, URL : http://www.h-k.fr/liens/tp/latex_pour_l_impatient.html.

LOZANO, Vincent, Tout ce que vous avez toujours voulu savoir sur LaTeX sans jamais oser le demander, In Libro Veritas, 2008, URL : http://framabook.org/tag/latex/.

MITTELBACH, Franck et Michel GOOSSENS, LaTeX Companion, 2^e éd., Paris : Pearson, 2006, URL : http://www.pearson.fr/livre/?GCOI=27440100048330.

Mella, P. (1997). Dai sistemi al pensiero sistemico. Per capire i sistemi e pensare con i sistemi (Vol. 28). FrancoAngeli. Guida alla composizione con il proprio computer.

COLLILIEUX, Marie-Claude, Découverte de Beamer, 2007, URL : http://mcclinews.free.fr/latex/introbeamer.php.

MITTELBACH, Franck et Michel GOOSSENS, « Détecter et résoudre les problèmes », dans : LaTeX Companion, 2^e éd., Paris : Pearson, 2006, URL : http://www.pearson.fr/livre/?GCOI=27440100048330, l'éditeur met gracieusement ce chapitre à disposition.

- The LaTeX Graphics Companion, Boston : Addison Wesley, 2007.

TISSEAU, Gérard et Jacques DUMA, TikZ pour l'impatient, URL : http://math.et.info.free.fr/TikZ/.

Comme pour les livres généralistes, l'intérêt en termes de contenu, par rapport à la problématique de ce livre, peut être très variable.

MASSON, Bertrand, Les fiches de Bébert : pour une véritable Publication Assistée par Ordinateur, URL : http://bertrandmasson.free.fr/.

ROUQUETTE, Maïeul, Geekographie Maïeulesque : LaTeX, URL : http://geekographie.maieul.net/-LaTeX-.

TeXample.net, URL : http://www.texample.net/.

TeXample.net : TikZ and PGF, URL : http://www.texample.net/tikz/.

Ne sont pas référencées les commandes situées dans les exemples colorés. En règle générale ces commandes sont expliquées avant ou après ces exemples.

Les entrées en gras renvoient à la définition de la commande.