Ceci est une ancienne révision du document !


\question{Comment installer un nouveau package ?}%29.19 \label{installpack}

On donne ici la procédure générale en sachant que chaque distribution 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 Lorsqu'il s'agit d'un package conçu pour \LaTeXe et utilisant 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 on copiera ces fichiers.

Il faut commencer par exécuter \texttt{latex package.ins} pour créer 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 \LaTeX{}, qui peut être commun à tous les utilisateurs ou local ou personnel. (Voir~\ref{TDS} pour plus de précisions sur l'organisation des fichiers.)

Enfin, il faudra reconstruire la base de données des packages \texttt{texhash} ou \texttt{rebuild ls-R filenames databases } ou \texttt{refresh

filename database} suivant la distribution.

\begin{Rq} On ne peut évidemment générer la documentation en premier, parce qu'elle aura souvent besoin du fichier des commandes; par exemple pour montrer des exemples.

Si l'on ne veut obtenir que la documentation «~utilisateur~», 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 distribution n'est que le mode encouragé par l'équipe de développement de \LaTeX{} et n'est en rien une obligation. Un bon 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 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.

2_programmation/extensions/installer_un_package.1013428584.txt.gz · Dernière modification: 2002/02/11 12:56 par benjamin
CC Attribution-Share Alike 4.0 International
Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0