Différences

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

--- 2_programmation:extensions:installer_un_package [2002/10/07 12:30]
benjamin
+++ 2_programmation:extensions:installer_un_package [2021/01/17 21:43]
dbitouze Suppression d'un signe de ponctuation inutile
@@ Ligne 1: / Ligne 1: @@
-\question{Comment installer un nouveau package ?}%29.19
+====== Comment installer un nouveau package? ======
-\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 Quand on a besoin d'un nouveau package, on le trouvera sur le
+On pourra aussi se reporter au thème~\vref{th=TDS}.
-\CTAN Navigator à \url{http://ctan.loria.fr/index_fr.html}
-\reponse Lorsqu'il s'agit d'un package conçu pour \LaTeXe et utilisant
+$\Reponse$  Quand on a besoin d'un nouveau package, on le trouve sur le
+CTAN Navigator à http://ctan.loria.fr/index_fr.html
+FIXME Obsolète
+$\Reponse$  Lorsqu'il s'agit d'un package conçu pour <latex>\LaTeXe</latex> 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}.
+complexes) fichiers : ''pack.ins'' et ''pack.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
+Il faut commencer par exécuter le script d'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
+<code bash>
-documentation, avec si besoin construction d'un index :\\
+latex pack.ins
-\texttt{makeindex -s gind.ist -o package.ind package.idx}\\
+</code>
-et d'un glossaire :\\
-\texttt{makeindex -s gglo.ist -o package.gls package.glo}
+pour créer le(s) fichier(s) de commandes lui(eux)-même(s) (typiquement ''pack.sty'') puis
+<code bash>
+latex pack.dtx
+</code>
+pour générer la documentation, avec si besoin construction d'un index :
+<code bash>
+makeindex -s gind.ist -o pack.ind pack.idx
+</code>
+et d'un glossaire :
+<code bash>
+makeindex -s gglo.ist -o pack.gls pack.glo
+</code>
 Puis il faut déplacer ces fichiers dans un répertoire visible par
-\LaTeX{}, qui peut être commun à tous les utilisateurs ou local ou
+<latex>\LaTeX</latex>, qui peut être commun à tous les utilisateurs ou local ou
-personnel. (Voir~\ref{TDS} pour plus de précisions sur l'organisation des
+personnel. (Voir~\vref{th=TDS} pour plus de précisions sur l'organisation des
 fichiers.)
-Enfin, il faudra reconstruire la base de données des packages
+Enfin, il faudra reconstruire la base de données des packages avec, suivant
- \texttt{texhash} ou \texttt{rebuild ls-R filenames databases } ou \texttt{refresh
+la distribution ''texhash'', ''mktexlsr'' ou bien l'une des deux commandes :
-  filename database} suivant la distribution.
-\begin{Rq}
+<code bash>
-On ne peut évidemment générer la documentation en premier,
+rebuild ls-R filenames databases
-parce qu'elle aura souvent besoin du fichier des commandes;
+# ou
+refresh filename database
+</code>
+<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 montrer des exemples.
+Si l'on ne veut obtenir que la documentation « utilisateur », il faut
+ajouter la ligne ''OnlyDescription'' dans le fichier
+''pack.dtx'', avant la ligne ''\DocInput{pack.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.
+</note>
-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
+$\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
+développement de <latex>\LaTeX</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
+bien avec Plain <latex>\TeX</latex> qu'avec <latex>\LaTeX</latex>, « vieux » packages écrits
-pour \LaTeX2.09, packages écrits par des personnes qui veulent
+pour <latex>\LaTeX</latex> 2.09, packages écrits par des personnes qui veulent
-faire <<~comme ça leur plaît~>>, etc.). Dans ces différents
+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
+C'est par exemple le cas pour [[ctanpkg>slashbox|slashbox]] pour lequel sont fournis le
-fichier \fichier{slahbox.sty} et un fichier de documentation à part,
+fichier ''slahbox.sty'' et un fichier de documentation
-\fichier{slashbox.tex}.
+''slashbox.tex''.  Le tout est réuni dans une archive pour les
-Le tout est réuni dans une archive pour les distributions sous Windows.
+distributions sous Windows.
+{{htmlmetatags>metatag-keywords=(LaTeX,TeX directory structure,installation de LaTeX)
+metatag-og:title=(Comment installer un nouveau package?)
+metatag-og:site_name=(FAQ LaTeX francophone)
+}}