I don't know anything about texinfo or sphinx but can probably figure it

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

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.


On Tue, May 9, 2017 at 8:53 PM, Richard Stallman <r...@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
gnu-misc-discuss mailing list

Reply via email to