Différences

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

--- 1_generalites:glossaire:qu_est_ce_que_texinfo [2021/04/11 02:04] – Lien vers Wikipedia. jejust
+++ 1_generalites:glossaire:qu_est_ce_que_texinfo [2021/06/22 21:09] (Version actuelle) – Explication sur l'usage de "texinfo" en pratique, avec l'exemple de la documentation de DVIPS. jejust
@@ Ligne 1: / Ligne 1: @@
 ====== Qu'est-ce que Texinfo? ======
-Texinfo est un système de documentation qui utilise un fichier source pour produire à la fois des informations en ligne et une sortie imprimée. Ainsi, au lieu d'écrire deux documents différents, l'un pour l'aide en ligne et l'autre pour un manuel composé, vous n'avez besoin d'écrire qu'un seul fichier source de document. Aussi, lorsque vous souhaitez modifier un document, vous n'avez besoin de réviser qu'un seul fichier. Par convention, les noms de fichiers source Texinfo se terminent par une extension « texi » ou « texinfo ».
+Texinfo est un système de documentation qui utilise un fichier source pour produire à la fois des informations consultables de façon interactive et une sortie imprimée. Ainsi, au lieu d'écrire deux documents différents, l'un pour l'aide en ligne et l'autre pour un manuel composé, vous n'avez besoin d'écrire qu'un seul fichier source de document. Aussi, lorsque vous souhaitez modifier un document, vous n'avez besoin de réviser qu'un seul fichier. Par convention, les noms de fichiers source Texinfo se terminent par une extension « texi » ou « texinfo ».
 Texinfo est un langage à commandes, ressemblant un peu à <latex>\LaTeX</latex> en étant moins expressif que ce dernier. Son code est assez similaire à celui de n'importe quel langage à commandes basé sur <latex>\TeX</latex>, à ceci près que ses commandes commencent par « @ » plutôt que par « \ » (couramment utilisé dans les systèmes <latex>\TeX</latex>).
@@ Ligne 8: / Ligne 8: @@
 Enfin, bien sûr, vous pouvez également imprimer les fichiers, ou les convertir en PDF à l'aide de ''pdfTeX''.
+====== Comment lire une documentation au format Texinfo? ======
+Peut-être avez-vous déjà consulté la documentation de ''dvips'' en tapant (sous Linux):
+<code bash>
+man dvips
+</code>
+et la page d'aide affichée vous a dit :-(:
+<WRAP column 61ex>
+<code text>
+NOM
+       dvips - convertit un fichier TeX DVI en PostScript
+DESCRIPTION
+       CETTE PAGE DE MANUEL EST OBSOLÈTE! Consultez plutôt
+       la documentation Texinfo.  Vous pouvez la lire soit
+       avec Emacs soit avec le programme info fournit dans
+       la distribution GNU texinfo à cette adresse:
+       ftp.gnu.org:pub/gnu/texinfo/texinfo*.tar.gz.
+</code>
+</WRAP>
+<WRAP column 61ex>
+<code text>
+NAME
+       dvips - convert a TeX DVI file to PostScript
+DESCRIPTION
+       THIS  MAN  PAGE IS OBSOLETE!  See the Texinfo docu-
+       mentation instead.  You can read it either in Emacs
+       or  with  the  standalone  info program which comes
+       with    the    GNU    texinfo    distribution    as
+       ftp.gnu.org:pub/gnu/texinfo/texinfo*.tar.gz.
+</code>
+</WRAP>
+<WRAP clear />
+$\Reponse$  Pour consulter l'aide en question dans sa version à jour, il vous suffit de taper dans un terminal:
+<code bash>
+info dvips
+</code>
+La documentation demandée s'affiche dans le terminal, et il est possible de naviguer
+avec les touches du clavier, comme dans un document hypertexte. Dans le vocabulaire
+de Texinfo, chaque sous-page de la documentation est un « nœud ».
+Pour avoir de l'aide sur les possibilités de navigation entre les nœuds, tapez ''H''.
+Ceci devrait afficher:
+<code text>
+Raccourcis Info de base:
+H           Ferme cette fenêtre d'aide.
+q           Quitte complètement Info.
+h           Appel du tutoriel Info.
+Up          Monte d'une ligne.
+Down        Descend d'une ligne.
+PgUp        Recule d'une page.
+PgDn        Avance d'une page.
+Home        Va au début de ce nœud.
+End         Va à la fin de ce nœud.
+TAB         Saute au prochain hyperlien.
+RET         Suit l'hyperlien sous le curseur.
+l           Retourne au dernier nœud vu dans cette fenêtre.
+[           Va au nœud précédent de ce document.
+]           Va au nœud suivant de ce document.
+p           Va au nœud précédent de ce niveau.
+n           Va au nœud suivant de ce niveau.
+u           Remonte d'un niveau.
+t           Va au premier nœud (« top ») de ce document.
+d           Va au nœud répertoire (« dir ») principal.
+...9       Choisit la première...neuvième entrée du menu de ce nœud.
+           Choisit la dernière entrée du menu de ce nœud.
+m           Sélectionne une entrée de menu par son nom.
+f           Suit le renvoi spécifié par son nom.
+g           Va au nœud spécifié par son nom.
+/           Recherche la chaîne indiquée vers l'avant.
+{           Recherche l'occurrence précédente.
+}           Recherche l'occurrence suivante.
+i           Recherche la chaîne indiquée dans l'index et
+              sélectionne le nœud correspondant à la première entrée.
+I           Présente un menu des entrées d'index correspondantes.
+C-g         Annule l'opération en cours.
+</code>
 -----
@@ Ligne 14: / Ligne 106: @@
   * [[wpfr>Texinfo]].
-{{htmlmetatags>metatag-keywords=(LaTeX,documentation,GNU)
+{{htmlmetatags>metatag-keywords=(LaTeX,documentation,GNU,page de man,manuel de référence,fichier texi)
 metatag-og:title=(Qu'est-ce que Texinfo)
 metatag-og:site_name=(FAQ LaTeX francophone)
 }}