Comment installer un package LaTeX ? [FAQ]

**Le Barde** · 04/03/2008, 14h30

La communauté des utilisateurs de LaTeX a développé une grande quantité de packages. La plupart de ceux-ci se trouvent sur le site http://www.ctan.org. Certaines distributions LaTeX, comme MikTeX, permettent l'installation automatique de packages, mais la plupart ne proposent pas cette fonctionnalité.

Voici la marche à suivre pour installer un package manuellement (dans le cas classique) :

1. Télécharger & décompresser le paquet (sur http://www.ctan.org par exemple) ;

2.a Sous Linux, faire :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

sudo cp -r mon_répertoire_paquet/ $LOCALTEXMF/tex/latex/

2.b. Sous Windows, copier le paquet dans le répertoire :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

LOCALTEXMF/tex/latex/

3. Aller dans ce répertoire ; s'il y a un makefile, entrer la commande

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

make

4.a. Sous Linux, taper ensuite :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

sudo texhash

4.b. Sous Windows :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

texhash

Le paquet est alors installé et est utilisable par la commande \usepackage{}.

Remarque :
Parfois les packages sont donnés sans makefiles et contiennent sont accompagnés uniquement de deux fichiers fichier.ins et fichier.dtx.
Dans ce cas, des étapes de compilation supplémentaires sont nécessaires (elles doivent être faites avant la copie vers l'arborescence de la distribution) :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

$ latex fichier.ins

pour créer le fichier fichier.sty, puis :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

$ latex fichier.dtx

pour générer la documentation (plus éventuellement création d'index et glossaire... voir la page dédiée sur la FAQ Grappa).

La documentation ainsi créée doit être déplacée ainsi : pour un ifplatform.sty placé dans LOCALTEXMF/tex/latex/ifplatform/, il faut placer les ifplatform.dvi et ifplatform.pdf générés dans LOCALTEXMF/doc/latex/ifplatform/ pour y avoir accès grâce à la commande texdoc (mthelp sous MiKTeX).

NOTE : LOCALTEXMF correspond au chemin de votre distribution LaTeX. Sous GNU/Linux, par exemple, ce sera peut-être /usr/share/texmf-texlive/ tandis que sous Windows, ce sera peut-être C:/Program Files/MiKTeX/.

**Le Barde** · 06/03/2008, 11h00

On pourrait mettre ceci sur la FAQ éventuellement, non ?

**Faith's Fall** · 09/03/2008, 00h06

Oui elle va être mis dans la FAQ surement debut de la semaine prochaine.

Merci pour la participation

**pitipoisson** · 10/03/2008, 14h31

Bonjour,

Envoyé par Le Barde

...
1. Télécharger & décompresser le paquet (sur http://www.ctan.org par exemple) ;

2.a Sous Linux, faire :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

sudo cp -r mon_répertoire_paquet/ /usr/share/ma_distribution_latex/tex/latex/

2.b. Sous Windows, copier le paquet dans le répertoire :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

C:/Program Files/ma_distribution_latex/tex/latex/

...

Il serait bon de préciser que lorsqu'un package vient sous la forme d'un fichier.ins et un fichier.dtx des étapes de compilation supplémentaires sont nécessaires (elles peuvent être faites avant la copie vers l'arborescence de la distribution):

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

latex fichier.ins

pour créer le(s) fichier(s).sty, puis

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

latex fichier.dtx

pour générer la documentation (plus éventuellement création d'index et glossaire... voir la page dédiée sur la FAQ Grappa).

Tous les fichiers temporaires peuvent (et devraient) bien évidemment être supprimés avant de copier le répertoire sur la partie système.
Petite remarque à ma remarque : je ne sais pas s'il est nécessaire de placer la documentation générée ailleurs que le .sty...?

Voilà pour ma modeste contribution.

**pitipoisson** · 10/03/2008, 15h07

Envoyé par pitipoisson

...
Petite remarque à ma remarque : je ne sais pas s'il est nécessaire de placer la documentation générée ailleurs que le .sty...?
...

Après expérimentation sur un package installé il y a peu de temps sous mon arborescence locale - alternative qui vaudrait peut-être aussi le coup d'être proposée sur la FAQ - je m'auto-réponds : Oui, la doc ainsi générée doit être placée ailleurs !

Par exemple pour un ifplatform.sty placé dans LOCALTEXMF/tex/latex/ifplatform/, j'ai du placer les ifplatform.dvi et ifplatform.pdf générés dans LOCALTEXMF/doc/latex/ifplatform/ pour y avoir accès grâce à la commande texdoc (mthelp sous MiKTeX).

Évidemment, ça devrait fonctionner strictement de la même façon dans l'arborescence commune pour être cohérent...

**Le Barde** · 13/03/2008, 14h17

Post mis à jour

(c'est bien formulé ?)

**pitipoisson** · 14/03/2008, 09h50

Envoyé par Le Barde

Post mis à jour

(c'est bien formulé ?)

Oui, bon travail !

Il serait peut-être bien de préciser - ce que je n'ai pas non plus fait de façon explicite - que LOCALTEXMF représente un chemin vers l'arborescence locale - Y:/LaTeX/localtexmf par ex. pour moi sous Windows, Y: étant une partition pour les documents perso. Que sous MiKTeX ça se définit avec l'utilitaire Settings > onglet Root où l'on peut ajouter le répertoire de son choix.
Je n'ai pas Linux sous la main pour voir où se met habituellement l'arborescence locale et encore moins pour donner le mode opératoire pour la rendre visible à LaTeX. Si quelqu'un pouvait compléter.

D'une façon générale, je trouve qu'il serait bien de préciser ici le rôle des arborescences locales et système (modifications mono- versus multi-utilisateur) ainsi que les pérennités respectives des modifications faites (je pense notamment à la fâcheuse tendance de l'arborescence système de MiKTeX à changer par défaut de répertoire d'une version à l'autre, annihilant ainsi les ajouts qui auraient put y être fait). Ensuite, l'installation de package diffère peu.

La façon d'ajouter/configurer l'arborescence locale sous différents OS pourrait faire l'objet d'une rubrique à part dans la FAQ, non ?

**Le Barde** · 14/03/2008, 11h57

Héhé, bientôt ça va prendre la dimension d'un véritable tuto

J'essaie de modifier cela cet après-midi

**Le Barde** · 14/03/2008, 16h53

Mis à jour. Si vous avez quelque remarque que ce soit, n'hésitez pas ! (il faut que ce soit clair, et peut-être que ça devient illisible pour le néophyte (ou l'averti))

**pitipoisson** · 17/03/2008, 11h49

Envoyé par Le Barde

...
NOTE : LOCALTEXMF correspond au chemin de votre distribution LaTeX. Sous GNU/Linux, par exemple, ce sera peut-être /usr/share/texmf-texlive/ tandis que sous Windows, ce sera peut-être C:/Program Files/MiKTeX/.

Sans vouloir passer pour le mec tatillon: pour clarifier les rôles respectifs des arborescences utilisateur (LOCALTEXMF, mono-utilisateur) et système (TEXMF, potentiellement multi-utilisateur)

NOTE : Une distribution LaTeX peut (doit ?) généralement comporter 2 arborescences distinctes:

arborescences système - que nous pouvons appeler TEXMF - qui correspond au chemin de votre distribution LaTeX. Sous GNU/Linux, par exemple, ce sera peut-être /usr/share/texmf-texlive/ tandis que sous Windows, ce sera peut-être C:/Program Files/MiKTeX/. Les fichier qu'elle contient sont utilisables par plusieurs utilisateurs de la machine.
arborescences utilisateur - LOCALTEXMF - mono-utilisateur. Elle permet notamment aux utilisateurs ayant des droits d'écriture restreints, d'installer des packages personnels. Elle doit donc se situer dans un répertoire où l'utilisateur a le droit d'écrire. Càd sous Windows avec MiKTeX, n'importe quel répertoire ajouté avec l'utilitaire Settings > onglet Root, et dans le home de l'utilisateur (typiquement /home/<nom d'utilisateur>/texmf) sous GNU-Linux.

Dans les exemple qui précèdent, TEXMF et LOCALTEXMF sont interchangeables. Pour des extensions personnelles (et/ou packages modifiés) il est préférable d'utiliser LOCALTEXMF (évite les pertes de fichiers personnalisés lors de changement/mises à jour de la distribution).

Si des membres plus expérimentés pouvaient vérifier que je ne bafoue pas les conventions en matière de notation.
En particulier, je ne sais plus d'où j'avais sorti ce nom "LOCALTEXMF", qui avec du recule me semble moins approprié que $TEXMFHOME, du nom de la variable désignant l'arborescence utilisateur sous GNU-Linux (TeXLive). A changer peut-être sur toute la notice !?

Courage

[edit: ne modifie pas tout de suite, j'ai du nouveau. Mais je posterai ça un peu plus tard dans la journée]

**pitipoisson** · 17/03/2008, 14h22

Bon, suite et - j'espère - fin de mes remarques sur les différentes arborescences...

Après une rapide lecture en diagonale de Administration d’un système TEX et un petit tour sur l'aide de MiKTeX 2.7, je peux vous livrer ces quelques constatations:

Avec une distribution TeXLive, il y a en réalité 3 arborescences distinctes importantes:
- celle de la distribution, TEXFMDIST (il y a également TEXMFMAIN, qui - semble-t-il - contient TEXMFDIST, mais je ne pense pas que ce soit important ici).
  Ce sera par exemple sous GNU-Linux : /usr/share/texmf-texlive/. L'utilisateur, même administrateur, ne devrait rien y modifier manuellement (maintenue par les gestionnaires de paquets et consorts).
- l'arborescence local multi-utilisateur : TEXMFLOCAL=/usr/local/share/texmf . Là où un administrateur peut installer manuellement des packages et classes personnalisés/non fournis avec la distribution.
- et celle de l'utilisateur : TEXMFHOME=$HOME/texmf . Maintenu par et pour l'utilisateur individuel.
MiKTeX semble n'utiliser que TEXMFDIST (e.g. C:/Program Files/MiKTeX 2.7/) et TEXMFLOCAL (d'où ma méprise !). Il me semble en revanche qu'il peut y avoir plusieurs TEXMFLOCAL, probablement dans des dossiers avec des droits d'écriture/lecture divers.
Ce doit être une conséquence de gestions de droits différentes sous Windows et GNU-Linux.
Dites le moi si je me trompe concernant la portée multi-utilisateur des répertoires ajoutés à l'aide de l'utilitaire settings de MiKTeX...

TEXMF, quant-à elle, est une variable d'environnement qui liste les différents chemins des arborescences dans leur ordre de priorité pour la recherche des packages/classes de documents (TEXMF={$TEXMFHOME,!!$TEXMFSYSVAR,!!$TEXMFLOCAL,!!$TEXMFMAIN,!!$TEXMFDIST}).

Je m'essayes donc à une n-ième reformulation:

NOTE : Les packages peuvent être ajoutés manuellement - au choix - dans 2 arborescences distinctes:

TEXMFLOCAL : l'arborescence locale multi-utilisateurs. Les fichier qu'elle contient sont utilisables par plusieurs utilisateurs de la machine.
Sous GNU-Linux, c'est généralement /usr/local/share/texmf .
Sous Windows, avec MiKTeX, il peut s'agir de n'importe quel répertoire ajouté avec l'utilitaire Settings > onglet Root
TEXMFHOME : l'arborescences utilisateur (apparemment pas disponible sous MiKTeX).
Elle permet notamment aux utilisateurs ayant des droits d'écriture restreints, d'installer des packages personnels. Elle doit donc se situer dans un répertoire où l'utilisateur a le droit d'écrire, typiquement $HOME/texmf sous GNU-Linux.

Dans les exemple qui précèdent, TEXMFHOME et TEXMFLOCAL sont interchangeables en fonction de la porté - mono- ou multi-utilisateur(s) - souhaitée.
Pour une installation dans $TEXMFHOME, ne pas précéder la commande de copie (cp) par sudo.

L'installation dans l'arboresence de la distribution (e.g. TEXMFDIST=/usr/share/texmf-{texlive,tetex} ou "C:/Program Files/MiKTeX 2.7") est elle à proscrire. Les ajouts/modification peuvent être perdus lors de màj !

Il suffirait donc dans ton premier post, de changer LOCALTEXMF par ($)TEXMFLOCAL, et de changer la note de fin.

Voilà, j'espère que mes explications sont suffisamment claires.
N'hésitez pas à vous plaindre si pour vous ça ne veut rien dire !

**Le Barde** · 21/03/2008, 22h18

Coucou !

Désolé pitipoisson, j'ai été très pris ces temps-ci (concerts itou itou...)

C'est cool l'explication sur les chemins ! Par contre, en le lisant je me dis du coup que ça donne un nota bene pratiquement aussi grand que la réponse véritable à la question.

Alors justement (j'ai l'impression que ces temps-ci il y a une recrudescence de l'engouement pour la FAQ

), pourquoi est-que ceci ne ferait pas l'objet d'une question de la FAQ du style "Qu'est-ce que LOCALTEXMF ?" Ainsi la question sur les packages pointerait sur celle-là.

Qu'en dis-tu ?

**pitipoisson** · 25/03/2008, 10h47

Envoyé par Le Barde

C'est cool l'explication sur les chemins ! Par contre, en le lisant je me dis du coup que ça donne un nota bene pratiquement aussi grand que la réponse véritable à la question.

Alors justement (j'ai l'impression que ces temps-ci il y a une recrudescence de l'engouement pour la FAQ

), pourquoi est-que ceci ne ferait pas l'objet d'une question de la FAQ du style "Qu'est-ce que LOCALTEXMF ?" Ainsi la question sur les packages pointerait sur celle-là.

Qu'en dis-tu ?

Eh bien pourquoi pas ?!
Faut simplement qu'on travaille bien la connection entre les deux problématiques, histoire que le novice s'y retrouve et ne soit pas tenté de zapper l'importante question du "où installer les packages ?"

**Le Barde** · 25/03/2008, 11h32

Envoyé par pitipoisson

[...] histoire que le novice s'y retrouve et ne soit pas tenté de zapper l'importante question du "où installer les packages ?"

Exact ! D'ailleurs, effectivement "ce qu'est LOCALTEXMF", on s'en fiche : c'est bien "où installer mes packages"

Enfin, pour répondre à ta question, il suffit juste à mon sens de rajouter à la fin dans la note une petite remarque, non ?

(Sinon, et ça n'a rien à voir : j'adore passer par ici pour voir les problèmes des gens, on apprend toujours un peu plus sur (La)TeX ; j'ai bien aimé ta dernière remarque avec le \addcontentsline, justement je ne m'y connais pas du tout ne TOC

)

**Erlen** · 31/03/2008, 20h32

Bonjour, je désire installer mciteplus qui est dispo sur le site ctan le dossier compressé contient des .bst et un .sty donc ce n'est pas un package à proprement parler, mais voila quand je copie le .sty dans mon arborescence (miktex\tex\latex\mciteplus) et que j'utilise le package il me dit texniccenter me dit que ce package n'est pas installé que puis je faire ?

**Le Barde** · 31/03/2008, 22h06

Tu as bien tapé la commande texhash dans un terminal ?

**Erlen** · 31/03/2008, 22h12

Négatif j'ai juste fait un copier collé c'est tout, il y a autre chose à faire ? si oui sois précis avec les commandes à taper et ou avoir accès à la console pour les taper merci

**Le Barde** · 31/03/2008, 23h47

ok, alors il faut que je réécrive la question de la FAQ, si comme ça m'a tout l'air d'être le cas ce n'est pas clair. Tu as bien suivi toutes les étapes de l'installation du package, même ce qui se trouve en bas (cf. mon premier post) ?

Si tu ne sais pas ce qu'est un terminal, j'imagine que tu es sous Windose. Dans Menu Démarrer -> Exécuter...

Tu tapes texhash

Puis ENTRÉE. Ensuite ton package devrait être utilisable. Voilà

**Aramis** · 01/04/2008, 12h27

Bonjour,

Dans la distribution MikTeX il existe une fonctionalite pour faire cela directement a partir du manager (MikTeX Settings). En effet, dans l'onglet "General" il y a le bouton "Refresh FNDB".

Toujours est-il que je trouve approprie de mentionner que la commande "texhash" fonctionne sous Linux comme sous Windows

A.