On 2013-11-05, Steven Murdoch wrote: > Is it possible to use Sphinx to convert a single doctest text file into > HTML?
> I've got some documentation with inline examples in a text file, along the > lines of: > > http://docs.python.org/2/library/doctest.html#simple-usage-checking-examples-in-a-text-file > The file is in reST so is reasonably easy to read, but Sphinx has very nice > formatting for both documentation text and example code, so I would like to > convert the text file into HTML. > Is there some way to do this? I couldn't see how to make the command line > tools do this, and I wasn't sure whether it would be feasible to somehow > hook into Sphinx's reST parser and HTML renderer to do what I want. For a single rst file, you can try Docutils. http://docutils.sf.net For "literate doctests", I can also recommend PyLit http://pylit.berlios.de Günter -- You received this message because you are subscribed to the Google Groups "sphinx-users" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/sphinx-users. For more options, visit https://groups.google.com/groups/opt_out.
