On 2011-09-10, at 11:45 , Stephan Diehl wrote: > > How far are we in getting things ready at the ReadTheDocs end? I'd say, the > earlier we can switch the DNS entry, the better. Everything was ported (as of August 28 anyway)[0], except for the specifications: from what I can tell, Sphinx does not support PEP-RST[1] (it does not understand the PEP header directives, so they are not displayed in the output), I did not get any answer when I asked about it on the pocoo IRC channel and google searches have failed to yield any information.
Way forward I'd see would be adding a target to Sphinx's makefile to use Docutils directly to compile the PEPs, and linking to them as if they were static HTML documents, but I do not know if RTD supports that. You'd have to ask someone more knowledgeable (Graham has already ported the mod_wsgi docs so he might know). From RTD's documentation, it seems accounts can be whitelisted for code execution[2], Graham probably wouldn't have any issue getting flagged for a pair of bilding commands (and barring that, the compiled PEPs could always be committed to the repo). In the long run, having a pep sphinx extension might be nice. [0] https://github.com/GrahamDumpleton/wsgiorg [1] https://github.com/GrahamDumpleton/wsgiorg/issues/11 [2] http://read-the-docs.readthedocs.org/en/latest/faq.html _______________________________________________ Web-SIG mailing list Web-SIG@python.org Web SIG: http://www.python.org/sigs/web-sig Unsubscribe: http://mail.python.org/mailman/options/web-sig/archive%40mail-archive.com
