[Grok-dev] Re: inaccurate documentation in grok book

[Brandon Craig Rhodes]

Martijn Faassen <faassen at startifact.com> writes:

> ... if only we had the Sphinx workflow worked out, then we could
> simply publish the book from SVN again. Right now it's a bit too much
> copy & paste into Plone for my tastes to actually do it...

I actually just transitioned my PyEphem project (whose source repository
is now publicly viewable through LaunchPad, if anyone wanted to see what
the Makefile and .conf files looked like) into using Sphinx for its
documentation, and, in fact, for its whole web site.

In my case, though, I just write the result into a "www" directory
that's a symlink that puts the files in the right directory to be
visible from my web server.

Is the "missing link" in this case (hah! a caveman reference! I didn't
catch that for a second) that we don't even have Sphinx set up and
working, or is the problem only that it doesn't have a way to push the
documents it generates up to the Plone instance that runs grok.zope.org?

-- 
Brandon Craig Rhodes   brandon at rhodesmill.org   http://rhodesmill.org/brandon