- 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
_______________________________________________
pygtk mailing list   [email protected]
http://www.daa.com.au/mailman/listinfo/pygtk
Read the PyGTK FAQ: http://www.async.com.br/faq/pygtk/

Reply via email to