incubator-zeta-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Jerome Renard <jerome.ren...@gmail.com>
Subject Re: [zeta-dev] Website
Date Fri, 30 Jul 2010 08:41:39 GMT
Tobias,

On Fri, Jul 30, 2010 at 10:37 AM, Tobias Schlitt <tobias@schlitt.info>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 <mail@kore-nordmann.de
> >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

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message