Guenter Milde schrieb: > Dear Georg and Sphinx developers, > > for my PyLit project, I rewrote the conf.py configuration script to have > comments in RST format, so that it can be converted into a documentation:: > > #> pylit conf.py > > The resulting documentation can be seen at > http://pylit.berlios.de/conf.py.html > and the text-source at http://pylit.berlios.de/_sources/conf.py.txt > > It can be converted back to a Python script easily :: > > #> pylit conf.py.txt > > so that any modification can be passed on between Python code and > reStructuredText format.
Looks nice. > I wonder whether this could be done for the conf.py template in Sphinx, > so that the commented script can become part of the Sphinx documentation. > (If there is interest, I can offer to do the initial editing.) The conf.py settings are already documented well, and since the initial template contains only the most important settings, I don't think it would add much value. Georg --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [email protected] For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en -~----------~----~----~----~------~----~------~--~---
