Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentes Révision précédente
Prochaine révision
Révision précédente
2_programmation:extensions:installer_un_package [2002/10/07 12:30]
benjamin
2_programmation:extensions:installer_un_package [2021/04/18 14:36] (Version actuelle)
yannick.tanguy Fusion de deux pages françaises et ajout de liens.
Ligne 1: Ligne 1:
-\question{Comment installer ​un nouveau package ​?}%29.19 +====== ​Comment installer ​une extension======
-\label{installpack}+
  
-On donne ici la procédure générale en sachant que chaque distribution +===== Installation semi-automatique =====
-peut avoir une organisation spécifique que l'on trouvera dans sa propre +
-documentation. +
-On pourra aussi se reporter au thème~\ref{TDS}.+
  
-\reponse Quand on a besoin ​d'un nouveau package, on le trouvera sur le +La plupart du temps, il suffit ​d'utiliser les mécanismes de gestion d'​extension de votre distribution <​latex>​\LaTeX</​latex>​ (et de penser ​à procéder aux mises à jour)
-\CTAN Navigator ​à \url{http://​ctan.loria.fr/​index_fr.html} +
  
-\reponse Lorsqu'​il s'agit d'un package conçu pour \LaTeXe et utilisant +===== Installation manuelle =====
-les procédures et outils définis dans ce cadre, c'est simple : +
-un package est fourni avec deux (ou plus, pour les packages plus +
-complexes) fichiers: \fichier{package.ins} et \fichier{package.dtx}.+
  
-Il est conseillé de travailler dans un répertoire temporaire dans lequel +Il peut cependant arriver que vous ayez à installer à la main une extension, soit pour avoir la version la plus récente, soit parce que vous n'avez pas accès au gestionnaire d'​extension (sur une machine où vous n'​êtes pas administrateur,​ par exemple).
-on copiera ces fichiers.+
  
-Il faut commencer par exécuter \texttt{latex package.ins} pour créer +==== Dossiers cibles ​de l'installation ====
-le(s) fichier(s) ​de commandes lui(eux)-même(s) (typiquement +
-\fichier{package.sty}) puis \texttt{latex package.dtx} pour générer la +
-documentation,​ avec si besoin construction d'un index :\\ +
-\texttt{makeindex -s gind.ist -o package.ind package.idx}\\ +
-et d'un glossaire :\\ +
-\texttt{makeindex -s gglo.ist -o package.gls package.glo}+
  
-Puis il faut déplacer ces fichiers dans un répertoire visible par +Il faut alors savoir qu'​existent sur votre machine plusieurs arborescences ''​texmf''​ (les répertoires où sont rangés, entre autres, les extensions)La plupart du temps, ce sont les trois suivantes : 
-\LaTeX{}qui peut être commun à tous les utilisateurs ou local ou +  * une arborescence ​de base ;  
-personnel(Voir~\ref{TDS} pour plus de précisions sur l'​organisation des +  * une arborescence « locale » ;  
-fichiers.+  * et une arborescence « utilisateur »
  
-Enfin, il faudra reconstruire la base de données des packages  +Ne touchez qu'aux deux dernièresSur une installation TeXlive/​linux typique, ces arborescences sont :
- ​\texttt{texhash} ou \texttt{rebuild ls-R filenames databases } ou \texttt{refresh +
-  filename database} suivant la distribution.+
  
-\begin{Rq} +<​code>​ 
-On ne peut évidemment générer la documentation en premier, +/​usr/​share/​texmf-texlive/​ 
-parce qu'​elle aura souvent besoin du fichier des commandes; +/​usr/​local/​share/​texmf 
-par exemple pour montrer des exemples.+$HOME/​texmf 
 +</​code>​
  
-Si l'on ne veut obtenir ​que la documentation <<​~utilisateur~>>,​ +Ces chemins peuvent varier et être modifiés. Leur valeur est déterminée par des variables d'environnement ​que vous pouvez afficher via la commande suivante sous TeXlive/​linux :
-il faut ajouter la ligne \cmd{OnlyDescription} dans le fichier +
-package.dtx,​ avant la ligne \cmd{DocInput\{package.dtx\}}. Sinon on +
-obtient aussi le listage commenté du code, ce dont on peut ne +
-pas vouloir se soucier et qui peut être volumineux pour les +
-packages importants. +
-\end{Rq}+
  
-\reponse Néanmoins, il est clair que ce mode d'​organisation et de +<code
-distribution n'est que le mode encouragé par l'​équipe de +texconfig conf 
-développement de \LaTeX{} et n'est en rien une obligation. Un bon +</code>
-nombre de packages disponibles ne le suit d'​ailleurs pas (!), +
-pour diverses raisons (packages qui se veulent utilisables aussi +
-bien avec Plain \TeX{} qu'​avec \LaTeX, ​<<~vieux~>> packages écrits +
-pour \LaTeX2.09, packages écrits par des personnes qui veulent +
-faire <<~comme ça leur plaît~>>, etc.). Dans ces différents +
-cas, il faut aller y voir de plus près pour comprendre +
-l'​organisation choisie.+
  
-C'est par exemple le cas pour \pack{slashbox} : il est fourni seulement le +Pour en savoir plus, lisez la documentation spécifique à votre distributionEn effet, les distributions sont toujours accompagnées ​de leur propre ​documentation, ​décrivant l'​organisation des fichiers, les outils de bases, variables d'​environnement,​ etcCette documentation se trouve sous plusieurs formes et/ou langues ​dans vos répertoires d'​installation mais aussi, plus simplement, sur le web, que ce soit pour [[https://​www.tug.org/​texlive/​doc/​texlive-fr/​texlive-fr.html|TeXlive]] ou [[https://​docs.miktex.org/​manual/​MiKTeX|MiKTeX]].
-fichier \fichier{slahbox.sty} et un fichier ​de documentation ​à part, +
-\fichier{slashbox.tex}. +
-Le tout est réuni ​dans une archive ​pour les distributions sous Windows.+
  
 +==== Cas simples ====
  
 +Ces cas sont ceux où il suffit de copier les fichiers (dont le fichier ''​.sty''​) depuis le [[1_generalites:​glossaire:​qu_est_ce_que_le_ctan|CTAN]] vers l'​endroit approprié de votre disque dur. Vous pouvez placer les fichiers au choix dans le même répertoire que votre document en cours (peu recommandé puisque seul les fichiers présents dans le même répertoire trouveront cette extension), ou dans un sous-répertoire adéquat (typiquement ''​tex/​latex/​package''​) de votre ''​texmf''​ personnel ou local.
 +
 +Dans ce dernier cas, il vous faudra reconstruire la base de données des extensions avec, suivant la distributionn ''​texhash'',​ ''​mktexlsr''​ ou bien l'une des deux commandes :
 +
 +<code bash>
 +rebuild ls-R filenames databases
 +# ou
 +refresh filename database
 +</​code>​
 +
 +La documentation de votre distribution devrait vous aider à savoir quelles sont les commandes utiles ici. Vous pourrez ensuite vérifier que votre nouveau fichier est bien trouvé par <​latex>​\LaTeX</​latex>​ avec la commande suivante :
 +
 +<​code>​
 +kpsewhich extension.sty
 +</​code>​
 +
 +Elle retourne la version qui sera effectivement utilisée dans le cas où il en existerait plusieurs.
 +
 +==== Cas un peu plus délicats (mais plus formels) ====
 +
 +Lorsqu'​il s'agit d'une extension conçue pour <​latex>​\LaTeXe</​latex>​ et utilisant les procédures et outils définis dans ce cadre, une extension est fournie avec deux fichiers (ou plus, pour les extensions plus complexes) : ''​extension.ins''​ et ''​extension.dtx''​ et non le fichier ''​extension.sty''​.
 +
 +Il est ici conseillé de travailler dans un répertoire temporaire dans lequel on copiera ces fichiers. Il faut commencer par exécuter le script d'​installation :
 +
 +<code bash>
 +latex extension.ins
 +</​code>​
 +
 +Cette action crée le ou les fichiers de commandes (typiquement ''​extension.sty''​). Cette extension est normalement accompagnée d'une documentation qui s'​obtient alors en exécutant :
 +
 +<code bash>
 +latex extension.dtx
 +</​code>​
 +
 +Il peut ici y avoir besoin de construire l'​index (si un fichier ''​extension.idx''​ existe) :
 +
 +<code bash>
 +makeindex -s gind.ist -o extension.ind extension.idx
 +</​code>​
 +
 +Il est possible également qu'il puisse y avoir à construire un glossaire (si un fichier ''​extension.glo''​ existe) :
 +
 +<code bash>
 +makeindex -s gglo.ist -o extension.gls extension.glo
 +</​code>​
 +
 +Il faut ensuite déplacer ces fichiers dans les répertoires présentés ci-dessus et, enfin, reconstruire la base de données des extensions comme dans le premier cas présenté ci-dessus.
 +
 +Pour information,​ cette méthode est également décrite dans la section 4.6 du document ​ //​[[ctanpkg>​lshort-french|Une courte (?) introduction à LaTeX2ε]]//​ (en français, la [[ctanpkg>​lshort|version originale]] étant en anglais).
 +
 +<​note>​
 +Il n'est évidemment pas possible de générer la documentation en premier, parce qu'​elle aura souvent besoin du fichier des commandes, par exemple pour illustrer le fonctionnement de l'​extension.
 +  ​
 +Si l'on ne veut obtenir que la documentation « utilisateur », il faut ajouter la ligne ''​OnlyDescription''​ dans le fichier ''​extension.dtx'',​ avant la ligne ''​\DocInput{extension.dtx}''​. Sinon, on obtient aussi le //listing// commenté du code, ce dont on peut ne pas vouloir se soucier et qui peut être volumineux pour les extensions importantes.
 +</​note>​
 +
 +==== Cas plus exotiques ====
 +
 +Le mode d'​organisation et de distribution des extensions décrit ici n'est que le mode encouragé par l'​équipe du [[1_generalites:​histoire:​c_est_quoi_latex3|Projet LaTeX]] et n'est en rien une obligation. Un bon nombre d'​extensions disponibles ne le suit d'​ailleurs pas, pour diverses raisons :
 +  * extensions qui se veulent utilisables aussi bien avec Plain <​latex>​\TeX</​latex>​ qu'​avec <​latex>​\LaTeX</​latex>​ ;
 +  * « vieilles » extensions écrites pour <​latex>​\LaTeX</​latex>​ 2.09 ;
 +  * extensions écrites par des personnes qui veulent faire « comme ça leur plaît »...
 + 
 +Dans ces différents cas, il faut aller y voir de plus près pour comprendre l'​organisation choisie. Les questions suivantes traitant de la [[1_generalites:​documentation:​documents:​documents_extensions:​start|documentation des extensions]] pourront vous donner des pistes :
 +  * « [[1_generalites:​documentation:​documents:​documents_extensions:​documentation_des_packages|Où trouver la documentation des extensions?​]] » ;
 +  * « [[1_generalites:​documentation:​documents:​documents_extensions:​documentation_des_packages3|Comment générer la documentation d'une extension?​]] ».
 +
 +-----
 +//Source :// https://​web.archive.org/​web/​20170314080827/​https://​elzevir.fr/​imj/​latex/​tips.html#​packages
 +
 +{{htmlmetatags>​metatag-keywords=(LaTeX,​TeX directory structure,​installation de LaTeX)
 +metatag-og:​title=(Comment installer une extension)
 +metatag-og:​site_name=(FAQ LaTeX francophone)
 +}}
2_programmation/extensions/installer_un_package.1033986608.txt.gz · Dernière modification: 2002/10/07 12:30 par benjamin
CC Attribution-Share Alike 4.0 International
Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0