[Grok-dev] thoughts while writing a tutorial

Darryl Cousins darryl at darrylcousins.net.nz
Sun Aug 19 08:06:18 EDT 2007


On Fri, 2007-08-17 at 16:54 +1200, Darryl Cousins wrote:
> >  - Tutorial authors might like having a way to test-render their
> >    tutorials before they submit them to see what they would look
> like
> >    on the Grok site; that way, we can debug the refactored text and
> >    see if our markup makes sense.
> Your grok buildout should contain bin/grok2html (cretainly it will
> from
> svn checkout of grok trunk). This executes doc/grok2html.py, add your
> new tutorial to the files that are built near bottom of that script.
> And
> then run:
> bin/grok2html path/to/html
> This html directory may be the checkout from svn.zope.org/grok/www
> which
> you could update with new html if you wish.

To add. Using a svn.zope.org/grok/www checkout is perfect because then
you have the ``resources`` directory (i.e. images|css etc).


More information about the Grok-dev mailing list