Différences

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

Lien vers cette vue comparative

Prochaine révision
Révision précédente
Dernière révision Les deux révisions suivantes
2_programmation:extensions:installer_un_package [2002/02/08 18:59]
eric créée
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? ​====== 
 On donne ici la procédure générale en sachant que chaque distribution 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 peut avoir une organisation spécifique que l'on trouvera dans sa propre
 documentation. documentation.
-On pourra aussi se reporter au thème~\ref{TDS}. 
  
-\reponse ​Lorsqu'​il s'agit d'un package conçu pour \LaTeX2e ​et utilisant+On pourra aussi se reporter au thème~\vref{th=TDS}. 
 + 
 + 
 +$\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 : 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 un package est fourni avec deux (ou plus, pour les packages plus
-complexes) fichiers: ​\fichier{package.inset \fichier{package.dtx}.+complexes) fichiers : ''​pack.ins'' ​et ''​pack.dtx''​.
  
 Il est conseillé de travailler dans un répertoire temporaire dans lequel Il est conseillé de travailler dans un répertoire temporaire dans lequel
 on copiera ces fichiers. on copiera ces fichiers.
  
-Il faut commencer par exécuter ​\texttt{latex package.inspour 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.dtxpour 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}, et d'un +</​code>​ 
-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 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.) ​ 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{texhashou \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 toujours besoin du fichier des commandes ;+# ou 
 +refresh filename database 
 +</​code>​
  
-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+ 
 +<​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>​ 
 + 
 + 
 + 
 +$\Reponse$  ​Néanmoins, il est clair que ce mode d'​organisation et de
 distribution n'est que le mode encouragé par l'​équipe 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 (!), nombre de packages disponibles ne le suit d'​ailleurs pas (!),
 pour diverses raisons (packages qui se veulent utilisables aussi 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+cas, il faut aller y voir de plus près pour comprendre
 l'​organisation choisie. l'​organisation choisie.
  
-C'est par exemple le cas pour slashbox ​: il est fourni seulement ​le +C'est par exemple le cas pour [[ctanpkg>​slashbox|slashbox]] pour lequel sont fournis ​le 
-fichier ​\fichier{slahbox.styet 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) 
 +}}
  
2_programmation/extensions/installer_un_package.txt · Dernière modification: 2021/04/18 14:36 par yannick.tanguy
CC Attribution-Share Alike 4.0 International
Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0