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 <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 gnu-misc-discuss@gnu.org https://lists.gnu.org/mailman/listinfo/gnu-misc-discuss
