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édentesRévision précédente
1_generalites:documentation:documents:documents_extensions:documentation_des_packages [2021/03/14 15:58] – Ajout de l'information sur les distributions. yannick.tanguy1_generalites:documentation:documents:documents_extensions:documentation_des_packages [2021/03/14 16:03] (Version actuelle) – Ajout d'un lien. yannick.tanguy
Ligne 1: Ligne 1:
-====== Où trouver la documentation des extensions ? ======+====== Où trouver la documentation des extensions? ======
  
 Cette FAQ vous suggère régulièrement des extensions qui pourront résoudre des problèmes particuliers. Dans certains cas, la réponse fournit toute la méthode pour y arriver. Dans d'autres (souvent ceux où la solution s'avère très spécifique), comment pouvez-vous vous y prendre ? Le recours à la documentation sera nécessaire et voici les différentes méthodes de la plus générale à la moins conseillée pour trouver cette documentation. Cette FAQ vous suggère régulièrement des extensions qui pourront résoudre des problèmes particuliers. Dans certains cas, la réponse fournit toute la méthode pour y arriver. Dans d'autres (souvent ceux où la solution s'avère très spécifique), comment pouvez-vous vous y prendre ? Le recours à la documentation sera nécessaire et voici les différentes méthodes de la plus générale à la moins conseillée pour trouver cette documentation.
Ligne 34: Ligne 34:
  
 La forme la plus courante de documentation des extensions <latex>\LaTeX</latex> se trouve dans le fichier ''dtx'' avec lequel le code est distribué (voir la question « [[1_generalites:documentation:documents:documents_extensions:fichiers_sources_dtx|Que sont les fichiers de source documentée (ou fichiers « dtx ») ?]] »). De tels fichiers sont censés être traités par <latex>\LaTeX</latex> lui-même mais il peut y avoir des problèmes occasionnels pour obtenir une documentation lisible. Les problèmes courants sont que l'extension elle-même est nécessaire pour traiter sa propre documentation (elle doit donc être décompressée avant le traitement) ou  que le fichier ''dtx'' ne sera pas traité avec <latex>\LaTeX</latex>. Dans ce dernier cas, le fichier ''ins'' produira généralement un fichier ''drv'' (ou de nom similaire), que vous traitez à la place avec <latex>\LaTeX</latex> (il arrive que l'auteur de l'extension pense à préciser cela dans un fichier ''README''.)  La forme la plus courante de documentation des extensions <latex>\LaTeX</latex> se trouve dans le fichier ''dtx'' avec lequel le code est distribué (voir la question « [[1_generalites:documentation:documents:documents_extensions:fichiers_sources_dtx|Que sont les fichiers de source documentée (ou fichiers « dtx ») ?]] »). De tels fichiers sont censés être traités par <latex>\LaTeX</latex> lui-même mais il peut y avoir des problèmes occasionnels pour obtenir une documentation lisible. Les problèmes courants sont que l'extension elle-même est nécessaire pour traiter sa propre documentation (elle doit donc être décompressée avant le traitement) ou  que le fichier ''dtx'' ne sera pas traité avec <latex>\LaTeX</latex>. Dans ce dernier cas, le fichier ''ins'' produira généralement un fichier ''drv'' (ou de nom similaire), que vous traitez à la place avec <latex>\LaTeX</latex> (il arrive que l'auteur de l'extension pense à préciser cela dans un fichier ''README''.) 
 +
 +Pour plus d'information sur ce point, lisez la question : « [[1_generalites:documentation:documents:documents_extensions:documentation_des_packages3|Comment générer la documentation d'une extension ?]] ».
 +
  
 ===== Avec la documentation séparée ===== ===== Avec la documentation séparée =====
Ligne 69: Ligne 72:
 metatag-og:site_name=(FAQ LaTeX francophone) metatag-og:site_name=(FAQ LaTeX francophone)
 }} }}
 +
1_generalites/documentation/documents/documents_extensions/documentation_des_packages.1615737520.txt.gz · Dernière modification : 2021/03/14 15:58 de yannick.tanguy
CC Attribution-Share Alike 4.0 International
Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0