To convert from DocBook to HTML I just followed the LDP-AuthorGuide from linuxdoc.org. I am using the ldp.dsl and following everything else as they explain there, especially in this page <a href=
http://www.linuxdoc.org/LDP/LDP-Author-Guide/usingldpdsssl.html>
http://www.linuxdoc.org/LDP/LDP-Author-Guide/usingldpdsssl.html</a>.
<p>I had to slightly change my path on the command (/usr/lib/sgml/stylesheet instead of /usr/lib/sgml/stylesheets) but since Debian follows the Linux-FHS pretty closely, I had no other problems.
<p>I keep wanting to modify the PostgreSQL documentation tools and integrate them into a nicer system that can be reused (right now it's very PG-specific). The PG team made a set of makefiles that make generating the different formats a snap, but they use some styleshoots and paths that are very different from the FHS.
<p>I'd like to create a system (probably in Python or Tcl/Tk) where you can just pick the files and generate a book from that set of files, then it would generate the makefiles for you, so next time you could just do "make html" or "make pdf".
