[Grok-dev] community documentation deployed on grok.zope.org
uli at gnufix.de
Mon Jan 10 10:49:31 EST 2011
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.
> >> * 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
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Size: 189 bytes
Desc: Dies ist ein digital signierter Nachrichtenteil
Url : http://mail.zope.org/pipermail/grok-dev/attachments/20110110/fc3ec517/attachment.bin
More information about the Grok-dev