[Grok-dev] thoughts while writing a tutorial
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
> > 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
> 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.
> then run:
> bin/grok2html path/to/html
> This html directory may be the checkout from svn.zope.org/grok/www
> 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