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: wayne, steve
Subject: Re: Documentation for Texinfo - Sphinx
Date: Tue, 9 May 2017 23:43:39 -0700

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> 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.

--
Dr Richard Stallman
President, Free Software Foundation (gnu.org, fsf.org)
Internet Hall-of-Famer (internethalloffame.org)
Skype: No way! See stallman.org/skype.html.


_______________________________________________
gnu-misc-discuss mailing list
gnu-misc-discuss@gnu.org
https://lists.gnu.org/mailman/listinfo/gnu-misc-discuss


reply via email to

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