--- myst: html_meta: keywords: LaTeX,documentation,GNU,page de man,manuel de référence,fichier texi --- # 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 est un langage à commandes, ressemblant un peu à LaTeX en étant moins expressif que ce dernier. Son code est assez similaire à celui de n'importe quel langage à commandes basé sur TeX, à ceci près que ses commandes commencent par « @ » plutôt que par « \\ » (couramment utilisé dans les systèmes TeX). 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, de sorte que les frayeurs de la [conversion de LaTeX en HTML](/5_fichiers/formats/xml/convertir_du_latex_en_html) sont largement évitées. 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) : ```bash man dvips ``` et la page d'aide affichée vous a dit ☹️ : ```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. ``` ```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. ``` Pour consulter l'aide en question dans sa version à jour, il vous suffit de taper dans un terminal : ```bash info dvips ``` 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 : ```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. 1...9 Choisit la première...neuvième entrée du menu de ce nœud. 0 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. ``` :::{sources} - [What is Texinfo?](faquk:FAQ-texinfo) - [Texinfo](wpfr:Texinfo). :::