URL:     https://linuxfr.org/forums/general-general/posts/texinfo-et-le-noeud-top
Title:   texinfo et le noeud @top ?
Authors: Linuxator
Date:    2016-05-24T07:04:28+02:00
License: CC By-SA
Tags:    revealjs et texinfo
Score:   1


Salut les Linuxiens,

J'ai une question concernant le format de fichiers **texinfo** (_\*.texi_): vous savez les inévitables **info** pages ou bouquins entier dans les terminaux.

Mais le format **texinfo** ne se limitant pas a cela et peut être convertis par les utilitaires natif en:

* HTML

* PDF

* PS, XML, DOCBOOK, PS ...  

Mais bon j'ai voulus faire mieux et offrir dans mon projet d'autres formats de sortie plus modernes comme _epub_, _man_ ou autres...

Je pensais pouvoir utiliser le programme **pandoc**, qui par d'ailleurs est un excellent programme de conversion de formats, mais le HIC étant que **pandoc** peut produire un fichier **texinfo** en sortie mais pas en prendre un en entrée...

De la découle mon dilemme j'ai freaker le truc an passant par un format de **docbook** temporaire que **pandoc** peut prendre en entrée afin de pouvoir générer tous les formats de sortie de pandoc:

```
pandoc -h
Input formats:  docbook, haddock, html, json, latex, markdown, markdown_github,
                markdown_mmd, markdown_phpextra, markdown_strict, mediawiki,
                native, opml, rst, textile
Output formats: asciidoc, beamer, context, docbook, docx, dzslides, epub, epub3,
                fb2, html, html5, json, latex, man, markdown, markdown_github,
                markdown_mmd, markdown_phpextra, markdown_strict, mediawiki,
                native, odt, opendocument, opml, org, pdf*, plain, revealjs,
                rst, rtf, s5, slideous, slidy, texinfo, textile
                [*for pdf output, use latex or beamer and -o FILENAME.pdf]

[...]

```

La conversion se passe bien mis a part le détail qui me gène:

les fichiers de sortie comprennent tous le mot _"_**top**_"_ qui découle du "_top node_ (**@top**)" du format de fichier **texinfo** (_\*.texi_).

Personnellement je ne connais pas la syntaxe du format **texinfo** (_*.texi_) et je voudrai savoir si quelqu'un pourrait me dire si l'on peut se passer de la "_top node_ (**@top**)" ou pas (est-ce une partie essentiel du format **texinfo** ou pas ?) dans le code source d'un fichier_ \*.texi_ ?

Car vous l'aurez compris un fichier **epub** qui commence sur la première page blanche avec le mot top écrit ça fait tache dans le fichier de sortie.

Merci de bien vouloir m'informer sur la nécessité de ce nœud (**@top**) et si quelqu'un qui écrit un fichier texinfo doit absolument passer par ce fameux nœud **@top**.

Ou est-ce la conversion de **ReST** en **texinfo** qui fait apparaître ce nœud ?

```
pandoc -r rst -w texinfo test.rst -o test.texi 
```

Merci pour vos réponses éclairées illuminant les ténèbres de ignorance en matière de **texinfo**.