[pygtk] pygtk.org mockup

[Andi Albrecht]

> - somebody with good XSLT skills should have a look at how the pdf 
> versions of the tutorial and reference are generated from sources. Andi? 
> If I recall correctly, someone did some really impressive work to get 
> PDF output for some other gnome documentation, and that work is probably 
> in the desktop-devel-list or in the gtk-devel-list archives. Something 
> in those lines would be amazing.
My XSLT skills are not that good, I try to do some modifications where 
it's possible. Any help would be appreciated.

Generating the HTML pages (reference & tutorial) is not that difficult. 
Wrapping the existing parts in the new header and footer and including 
the new CSS should do it. Maybe a few modifications are necessary (i.e, 
the headers are too large for a reference...).

We should just decide on what's on the left hand menu. In my opinion 
we've got two possibilities:
a) leaving the menu items (LHM) unchanged on all pages, this would be 
consistent,
b) replacing the "standard" menu items with some kind of quick links
to the reference sections (atk, gobject, gtk and so on).

The latter would make it possible to navigate between the reference 
sections without using the back button or the references index page.

Another thing to decide is, if we need a "Back to top" link on the 
bottom of each method; is this user-friendly?

Producing the PDFs is not that easy. Today I've tried to generate them, 
but it results in a bunch of error messages, esp. about TeX's internal 
memory and so on. It's fixable, but if anyone has some experiences in 
converting (huge) DocBook files to PDF would make things easier. John, 
I'm not sure about it, was there a PDF version before? FAQ 1.7 says no, 
but the Makefile does a good job, until a certain point.

Andi