OVH Cloud OVH Cloud

conversion de doc

4 réponses
Avatar
gerbier
bonjour

j'ai une doc perl au format pod. j'utilise déjà pod2man et pod2html.

Mais pour me conformer au standard gnu, je voudrais fabriquer un fichier
au format "texinfo". Quel module/commande utiliser ?

4 réponses

Avatar
Paul Gaborit
À (at) Wed, 27 Sep 2006 09:41:46 +0200,
gerbier écrivait (wrote):
j'ai une doc perl au format pod. j'utilise déjà pod2man et pod2html.

Mais pour me conformer au standard gnu, je voudrais fabriquer un fichier
au format "texinfo". Quel module/commande utiliser ?


Je ne connais pas d'outil permettant de faire cela. Il y a bien un
'pod2info' qui est évoqué au détour de quelques documents (par exemple
'perlamiga') mais impossible de mettre la main dessus.

J'ai quand même l'impression que ce ne sera pas facile à faire. Un
document info est très hiérarchisé alors qu'un document Pod est plutôt
linéaire. Le résultat risque d'être pauvre.

Ceci étant, il existe des outils pour produire de nombreux formats à
partir de Pod (HTML, text, man, LaTeX, DocBook, etc.). Peut-être
existe-t-il un convertisseur partant de l'un de ces formats pour aller
vers le format info (par exempl un DocBook -> info).

Tenez-nous au courant si vous trouvez une solution...

--
Paul Gaborit - <http://perso.enstimac.fr/~gaborit/>
Perl en français - <http://perl.enstimac.fr/>

Avatar
gerbier
Paul Gaborit wrote:
À (at) Wed, 27 Sep 2006 09:41:46 +0200,
gerbier écrivait (wrote):
j'ai une doc perl au format pod. j'utilise déjà pod2man et pod2html.

Mais pour me conformer au standard gnu, je voudrais fabriquer un fichier
au format "texinfo". Quel module/commande utiliser ?


Je ne connais pas d'outil permettant de faire cela. Il y a bien un
'pod2info' qui est évoqué au détour de quelques documents (par exemple
'perlamiga') mais impossible de mettre la main dessus.


j'en étais arrivé au même point : introuvable

j'ai ensuite essayé pod2texinfo
(http://search.cpan.org/~randym/pod2texinfo-1.0/), mais le code généré
ne passe pas la fabrication du fichier info (par makefinfo)

J'ai quand même l'impression que ce ne sera pas facile à faire. Un
document info est très hiérarchisé alors qu'un document Pod est plutôt
linéaire. Le résultat risque d'être pauvre.

Ceci étant, il existe des outils pour produire de nombreux formats à
partir de Pod (HTML, text, man, LaTeX, DocBook, etc.). Peut-être
existe-t-il un convertisseur partant de l'un de ces formats pour aller
vers le format info (par exempl un DocBook -> info).


je suis en train d'essayer pod2docbook puis docbook2texi qui me semble
prometteur, mais j'ai des problèmes de dtd.


Avatar
espie
In article ,
Paul Gaborit <Paul.Gaborit+ wrote:

À (at) Wed, 27 Sep 2006 09:41:46 +0200,
gerbier écrivait (wrote):
j'ai une doc perl au format pod. j'utilise déjà pod2man et pod2html.

Mais pour me conformer au standard gnu, je voudrais fabriquer un fichier
au format "texinfo". Quel module/commande utiliser ?


Je ne connais pas d'outil permettant de faire cela. Il y a bien un
'pod2info' qui est évoqué au détour de quelques documents (par exemple
'perlamiga') mais impossible de mettre la main dessus.


C'est pas la meme chose, de toute facon. Amiga avait un format hypertexte
de doc qui n'avait que peu de choses en commun avec info.

J'ai quand même l'impression que ce ne sera pas facile à faire. Un
document info est très hiérarchisé alors qu'un document Pod est plutôt
linéaire. Le résultat risque d'être pauvre.

Ceci étant, il existe des outils pour produire de nombreux formats à
partir de Pod (HTML, text, man, LaTeX, DocBook, etc.). Peut-être
existe-t-il un convertisseur partant de l'un de ces formats pour aller
vers le format info (par exempl un DocBook -> info).


Le format source des fichiers info, c'est .tex. Il y a un pod2texi sur
cpan, apres, il ne reste plus qu'a utiliser makeinfo. C'est pas tout perl,
mais tant pis.

Se conformer au format gnu info, a mon avis, est une grosse connerie.
L'enorme majorite des documents info que j'ai vus sont nuls. Entre autres
parce que la plupart des gens qui les redigent s'imaginent que la
convivialite des liens hypertexte permet de ne pas avoir a ecrire une doc
coherente, synthetique et concise. Il est souvent super-dur d'avoir une
vision d'ensemble d'un logiciel a partir de la page info (bonne chance pour
savoir ce qui est standard et ce qui est une extension dans gnu-make, par
exemple).

En plus, ca fait un deuxieme index, separe des pages de man. Et
les outils de visualisation ne sont pas franchement geniaux (sauf si on
est aussi adorateur d'emacs). En plus, certaines caracteristiques du
format changent tout le temps. Bref, autant jeter directement .texi
a la poubelle... Mais ca, c'est mon opinion...


Avatar
Paul Gaborit
À (at) Thu, 28 Sep 2006 10:41:16 +0000 (UTC),
(Marc Espie) écrivait (wrote):
In article ,
Paul Gaborit <Paul.Gaborit+ wrote:
Je ne connais pas d'outil permettant de faire cela. Il y a bien un
'pod2info' qui est évoqué au détour de quelques documents (par exemple
'perlamiga') mais impossible de mettre la main dessus.


C'est pas la meme chose, de toute facon. Amiga avait un format hypertexte
de doc qui n'avait que peu de choses en commun avec info.


Je ne connais pas le format hypertexte des docs Amiga. Mais pod2info
est évoqué dans une section portant le titre "Perl GNU Info Files on
AmigaOS" et le texte fait bien référence à Emacs.

Le format source des fichiers info, c'est .tex. Il y a un pod2texi sur
cpan, apres, il ne reste plus qu'a utiliser makeinfo. C'est pas tout perl,
mais tant pis.


pod2texi n'est qu'une collection de document déjà convertis. De plus,
elle date de 1996... Par contre, on trouve sur CPAN un script
pod2texinfo en version 1.0 datant de 1998.

Je suis presque d'accord avec vous sur l'intérêt de 'info'. Ceci
étant, lorsqu'on utilise (X)Emacs, c'est très pratique (bien plus que
les pages de man).

--
Paul Gaborit - <http://perso.enstimac.fr/~gaborit/>
Perl en français - <http://perl.enstimac.fr/>