Ever since Pro Web 2.0 Mashups came out, I've wanted to get the book on the web. Publishing PDFs was a start — but I have envisioned developing a full-blown web application, a book that would could interact with my readers, be self-correcting and self-updating. It's only appropriate that a book about APIs and mashups should itself embody the techniques that are describe in it!
Well, it's going to be a while until I get there — but I'm happy that I haven't taken the next step: publishing a (X)HTML version of the book.  The canonical version of the book ended up being a series of QuarkXPress files. I had written some Python appscript programs to convert the book to a simple homebrew XML representation but didn't have sufficient time to take it all the way to DocBook. I hired Liza Daly's Threepress Consulting to do the bulk of the conversion to DocBook, leaving me some labor intensive details to fit my budget. (BTW, Liza is a great person to work with, very smart and responsive to my queries. )
With the book in DocBook, I have been using oXygen 11 to edit the files and transform them into XHTML. I was hunting around for CSS files for DocBook-derived XHTML, but found surprisingly few options. The one I'm currently settling on to get me started is the stylesheet for FreeBSD documentation (see the style in action on the FreeBSD site).  I'll definitely want to customize the stylesheet for the book to reflect the look and feel I desire — but I'm happy with the starting point.
Post a Comment