Différences

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

--- generalites:glossaire:qu_est_ce_que_texinfo [2018/12/04 00:48] – 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: @@
-====== What is Texinfo? ======
+====== Qu'est-ce que 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 is a documentation system that uses one source file to produce
+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>).
-both on-line information and printed output.  So instead of writing
-two different documents, one for the on-line help and the other for a
-typeset manual, you need write only one document source file.  When
-the work is revised, you need only revise one document.  By convention,
-Texinfo source file names end with a ''texi'' or ''texinfo'' extension.
-Texinfo is a macro language, somewhat similar to LaTeX, but with
+Vous pouvez écrire et convertir des fichiers Texinfo en fichiers Info avec GNU Emacs et les lire en utilisant le lecteur Emacs Info. Vous pouvez également convertir les fichiers Texinfo en fichiers Info en utilisant le logiciel ''makeinfo'' et les lire en utilisant ''info'', de sorte que vous n'êtes pas dépendant d'Emacs. Toute distribution comprend un script Perl, ''texi2html'', qui convertira les sources Texinfo en HTML : le langage est en effet bien mieux adapté au HTML que ne l'est <latex>\LaTeX</latex>, de sorte que les frayeurs de la [[5_fichiers:xml:convertir_du_latex_en_html|conversion de LaTeX en HTML]] sont largement évitées.
-slightly less expressive power.  Its appearance is of course rather
-similar to any TeX-based macro language, except that its macros
-start with ''@'' rather than the ''\'' that's more commonly used in
-TeX systems.
-You can write and format Texinfo files into Info files within GNU
+Enfin, bien sûr, vous pouvez également imprimer les fichiers, ou les convertir en PDF à l'aide de ''pdfTeX''.
-Emacs, and read them using the Emacs Info reader.  You can also format
-Texinfo files into Info files using ''makeinfo'' and read them
-using ''info'', so you're not dependent on Emacs.
-The distribution includes a Perl script, ''texi2html'', that will
-convert Texinfo sources into HTML: the language is a far better fit
-to HTML than is LaTeX, so that the breast-beating agonies of
-[[FAQ-LaTeX2HTML|Converting LaTeX to HTML]] are largely avoided.
-Finally, of course, you can also print the files, or convert them to
+====== Comment lire une documentation au format Texinfo? ======
-PDF using pdfTeX.
+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 :-(:
-//Source:// [[faquk>FAQ-texinfo|What is Texinfo?]]
+<WRAP column 61ex>
+<code text>
+NOM
+       dvips - convertit un fichier TeX DVI en PostScript
-{{htmlmetatags>metatag-keywords=(LaTeX,documentation,GNU)
+DESCRIPTION
-metatag-og:title=(What is Texinfo?)
+       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>
+-----
+//Sources://
+  * [[faquk>FAQ-texinfo|What is Texinfo?]]
+  * [[wpfr>Texinfo]].
+{{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)
 }}