[Grok-dev] community documentation deployed on grok.zope.org

[Uli Fouquet]

Jan-Wijbrand Kolman wrote:
> On 1/10/11 15:42 PM, Uli Fouquet wrote:
> >> * Somehow the "generated on"-timestamp is missing from the index page.
> >>     I think it should be there, but I do not know why it isn't.
> >
> > That's really mysterious. The layout at least should insert the
> > `last_updated` value. I currently have no clue.
> 
> Maybe I'm doing something wrong here? Can someone reproduce not getting 
> an updated timestamp?

I don't get the timestamp neither.

[snip: template]

> >> * There's a navigation menu at the top in the form of several tabs. The
> >>     links in there are not correct, but I actually wonder whether we
> >>     should keep the links there in the first place.
> >
> > IMO all links except the last two ones ("What's changed" and "Grok
> > Community Documentation") should stay. One can discuss, however, whether
> > the tutorial and developer notes should be shipped with the reference
> > rather than with the the community docs.
> 
> I think these navigational links do belong in the 
> official-documentation-tree, that indeed contain the tutorial etc. 
> Actually, now I notice the little title above the tab bar says "Official 
> Grok Documentation", where I guess it should say "Grok Community 
> Documentation", right?

I think so too and tried to change that in the docs.

> >> * I removed the latex and PDF rendering parts from the build script.
> >>     They didn't seem to work at this moment. At least not on the
> >>     grok.zope.org host.
> >
> > Can you tell what went wrong? Most people with a more recent LaTeX
> > install should be able to build PDFs. At least it works here.
> 
> Hmmm, for the grok-doc checkout, the build script tries to call "make 
> all_pdf", a target that seems not to be defined in the Makefile. Again, 
> I might be doing something wrong here.

Usually there are two Makefiles. One (the 'usual one') to run `make
latex` which in turn generates a new Makefile in the build/latex/ subdir
which accepts `make all-pdf`. But I didn't look into the builder script
yet.

Best regards,

-- 
Uli

-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: Dies ist ein digital signierter Nachrichtenteil
Url : http://mail.zope.org/pipermail/grok-dev/attachments/20110110/fc3ec517/attachment.bin