Tobias, On Fri, Jul 30, 2010 at 10:37 AM, Tobias Schlitt <[email protected]>wrote:
> -----BEGIN PGP SIGNED MESSAGE----- > Hash: SHA1 > > Hi guys, > > On 07/30/2010 10:05 AM, Jerome Renard wrote: > > On Fri, Jul 30, 2010 at 9:05 AM, Kore Nordmann <[email protected] > >wrote: > >> On Fri, 2010-07-30 at 08:33 +0200, Maxime Thomas wrote: > > >>> Else, I ve looked to Sphynx, is it only for Python ? > > >> Looked like it to me … Jerome? :) > > > I am currently writing a book using Sphinx and I also deliver my customer > > documentation > > using SPhinx as well. Basically, Sphinx uses RST + some cool stuff around > it > > so migrating > > ZC tutorials from plain RST to Sphinx is a matter of around 2 hours of > work, > > just to add the correct > > Sphinx instructions to get syntax coloring for example. > > > > However Sphinx is initially built for Python project which means it know > > absolutely nothing about > > PHP Doc, but coupling the documentation generated by Sphinx and the PHP > Doc > > should not be that > > difficult actually. > > So using Sphinx in favor of plain docutils yields you only some > enhancements regarding the code markup, if I get that correct? > Yep, I am actually working on writing a system that could at least prepare the whole directory structure automatically for Sphinx. I'll keep you posted :) Cheers, -- Jérôme Renard http://39web.fr | http://jrenard.info
