I've written a book (now in its second edition) using DocBook. The markup itself isn't any worse than doing straight HTML. Getting a working toolchain was painful. Once that was done, nxml-mode in emacs makes things livable. Using the docbook source to create the structure of a website was a nice bonus. We're using the SGML toolchain because the XML toolchain doesn't produce PDFs of good enough quality.
