Hi,<br><br>I added my script in grok-doc/buildout.cfg<br>bin/buildout generates a bin/build.sh script that build the html and pdf file and copy it to ~/public_html/grokdocs (configurable via the document_root option in buildout.cfg)<br>

I added a link to the pdf in the docindex.template file. I saved the logo.gif to png to include it in the pdf, but we need a HD version.<br>The buildout add a cronjob to the user crontab and run every hour.<br>Somebody now need to run the buildout on the server and serve the  ~/public_html/grokdocs via apache.<br>

<br clear="all">Vincent<br>
<br><br><div class="gmail_quote">On Mon, Jan 3, 2011 at 1:05 PM, Uli Fouquet <span dir="ltr">&lt;<a href="mailto:uli@gnufix.de">uli@gnufix.de</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">

Hi there,<br>
<div class="im"><br>
Jan-Wijbrand Kolman wrote:<br>
&gt; On 1/3/11 12:28 PM, Uli Fouquet wrote:<br>
<br>
</div><div class="im">&gt; Yes I have. I&#39;ll look into this (I know I promised before, twice...<br>
&gt; sorry about the &quot;latency&quot;).<br>
<br>
</div>No worries, please! Another problem that might arise with the build.sh<br>
script in the grok trunk:<br>
<br>
I meanwhile updated major parts of the reference documentation in<br>
grok/trunk/doc/reference. I think these reference docs should go apart<br>
from community docs, so the &#39;reference&#39; link in the community docs<br>
should go to some foreseeable but external URL (maybe:<br>
<a href="http://packages.python.org/grok" target="_blank">http://packages.python.org/grok</a>?)<br>
<br>
These reference docs now also depend on Sphinx (and grok, due to lots of<br>
auto-documenting) only. The build process therefore has changed and can<br>
be triggered by the usual `sphinx-build` command (or `grokdoc2html|<br>
latex` which are wrappers around `sphinx-build`). This `sphinx-build`<br>
command, however, which can be buildout-generated, can change over time<br>
with new versions of Sphinx. So I&#39;d rather love to see a script that<br>
also generates the `sphinx-build` command freshly when run, especially,<br>
when it comes to cron-triggered nightly builds. For single-time use one<br>
could trigger the command manually (for instance when releasing a new<br>
Grok version).<br>
<br>
The reference docs now also provide some doctests to make sure the given<br>
examples really work. This, however, is still some work to do, as test<br>
setup can become hairy in Sphinx envs, but most simple examples can be<br>
tested already running the sphinx doctest builder. Maybe we want to run<br>
the doctest-builder as well in the long run?<br>
<br>
Just my 2c.<br>
<br>
Best regards,<br>
<br>
--<br>
<font color="#888888">Uli<br>
<br>
</font><br>_______________________________________________<br>
grok-doc mailing list<br>
<a href="mailto:grok-doc@zope.org">grok-doc@zope.org</a><br>
<a href="https://mail.zope.org/mailman/listinfo/grok-doc" target="_blank">https://mail.zope.org/mailman/listinfo/grok-doc</a><br>
<br></blockquote></div><br>