Announce: DocBook DSSSL stylesheet to generate devhelp specs directly from Docbook

[José Fonseca <j_r_fonseca yahoo co uk>]

As promised, here is a DocBook DSSSL stylesheet to generate devhelp specs 
directly from Docbook. Although some ideas were taken from the existing 
Windows HTML Help DSSSL stylesheet by Norman Walsh this stylesheet was 
completely rewritten and has more features such as the generation of the 
index as well.

You can get it at 
http://mefriss1.swan.ac.uk/~jfonseca/devhelp/stylesheets/devhelp.dsl

It also doesn't affect the output style, besides disabling the generation 
of TOCs, so it's straightforward to use with other stylesheets. For 
example, to use with the GDP stylesheet just change:

<!ENTITY docbook.dsl PUBLIC "-//Norman Walsh//DOCUMENT DocBook HTML 
Stylesheet//EN" CDATA DSSSL>

to

<!ENTITY docbook.dsl SYSTEM "gtk-doc.dsl" CDATA DSSSL>

Notes:
 - So far it just handles the the primary term of the index. While this 
is a limitation of devhelp too I plan to change the stylesheet to use the 
secondary and terciary terms to give a more descriptive description of the 
index tree.
 - The 'name' attribute of the book must be added (manually) otherwise 
devhelp will refuse to load it.
 - You need the patch for devhelp parsing empty tags which I posted  on 
the list but, at the time this was written, still hadn't been committed to 
CVS...
 - I wasn't unable to test it with the gtk docs on CVS because my system 
lacks some automake macros, so I'm stuck there...

I decided to announce also on gnome-doc-list because I think that this can 
facilitate greatly the task of making devhelp specs as we move forward 
DocBook, so it can bring more material & users to devhelp. This stylesheet 
can also be easily adapted to other ends, such as for using Jade to cache 
a DocBook into a series of HTMLs + a describing XML for the new Yelp 
system. (This is just a wild suggestion, because I'm aware that Yelp is 
based upon XML and XLST).

Regards,

José Fonseca

_________________________________________________________
Do You Yahoo!?
Get your free @yahoo.com address at http://mail.yahoo.com