Hi Jerome, On Fri, 2010-07-30 at 13:26 +0200, Jerome Renard wrote:
> You can check it out here : > > - http://jrenard.info/utils/zetacomponentsdoc-sphinx/ > > There are multilple versions of the doc, the contents is the same I > just used different templates so you can see different results. That looks interesting, but the rendering of the RST stuff is done by WCV and that would basically require us replacing the whole website engine. I saw that Sphinx also uses docutils + pygments - which I could try to use, too, for highlighting the source code. (Docutils are used anyways for now) The major issue with the doc generation are not the tutorials, but the API documentation - and afaik Sphinx cannot really help here. The source code highlighting in the generated HTML inside WCV is only a minor issue (XPath + php_highlight_source + regexp to link class names) and already implemented by Derick for the "old" website. The tutorials rendered by Sphinx look really nice, though. We might want to borrow some styling ideas from there for the tutorials ;). -- Kore Nordmann (GPG 0xDDC70BBB) - What I do: http://kore-nordmann.de/portfolio.html - Motivate me: http://wishlist.kore-nordmann.de/ - Hire me: http://qafoo.com/
signature.asc
Description: This is a digitally signed message part
