gnu-misc-discuss
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Documentation for Texinfo - Sphinx


From: Amirouche
Subject: Re: Documentation for Texinfo - Sphinx
Date: Wed, 10 May 2017 20:09:58 +0200
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101 Thunderbird/45.8.0



Le 10/05/2017 à 08:43, wayne, steve a écrit :
I don't know anything about texinfo or sphinx but can probably figure it out.

Looking at the sphinx documentation, I see that it can generate texinfo documents--is there a similar conversion from texinfo to sphinx? Is that what you want documented?

If there's not already a conversion from texinfo to sphinx, would it be worth the effort to make one?

Looking at the Sphinx main page I see that as long as documentation can be converted to xhtml, it can then be converted to restructured text. http://docutils.sourceforge.net/sandbox/xhtml2rest/xhtml2rest.py seems to suggest that html can be converted to xhtml.

So it seems like it should be possible to perform the following transformations:

texinfo -> html [using texinfo tools presumably]
html -> xhtml [using iconv + tidy]
xhtml -> reST [using xhtml2rest]

Again, I'm writing almost 100% from ignorance here so feel free to slap me around with a large trout if you think it would help.

Solidarity,
 Wayne

On Tue, May 9, 2017 at 8:53 PM, Richard Stallman <rms@gnu.org <mailto:rms@gnu.org>> wrote:

    [I sent this message a month but did not get a response.]

    Would someone like to write an informal file of instructions for
    how to convert
    Texinfo into Sphinx, which would cover the unusual constructs
    as well as the usual ones?

    In Texinfo we have rules about when to use @samp, when @code, when
    @kbd, and when no markup. The rules for sphinx, to get equivalent
    results, might not be the same.  So this manual would need to explain
    what to do.

    We can't make Sphinx our choice unless we have this.


IMO it would be best to use something like http://www.nongnu.org/skribilo/




reply via email to

[Prev in Thread] Current Thread [Next in Thread]