Dave Johnson on open web technologies, social software and software development
« What belongs on a... | Main | Recent Wiki spam... »
I was seriously considering using DocBook for a big writing project. I backed out because my collaborators use the reviewer comment features of MS Word, but even if my collaborators could have accepted DocBook I'm not sure that I could have done so. DocBook is complex and climbing a big learning curve when I should be writing and working on example code does not appeal to me at all. Take a look at the XML files and the build scripts for Mark Pilgrim's DocBook-based Dive into Python if you don't believe me. I get the feeling that a DocBook project is a lot like a software project with a build-script and build-time error messages that require debugging. I don't want to miss a deadline because my manuscript won't compile.
The best way to work with DocBook would probably be a WYSIWYG editor that uses DocBook as it's native format or that can export in DocBook format. Otherwise, you'll be swimming in angle-brackets and cursing validation errors. DocBook provides a powerful set of tools, but DocBook XML is something that should be generated rather than written by hand.
Along those lines: what if you wanted to print your entire Weblog, including all of the entries in your archive, as a nicely formatted book, ready for printing. DocBook would be a great way to do that. You could write a utility to dump your Weblog to DocBook XML format and, if you've been writing your Weblog entries in valid XHTML, you could even transform the formatting information in your entries to DocBook XML. Then, you could easily transform your entire Weblog to PDF, RTF, or any of the dozens of formats supported by the DocBook transforms. Weblog to DocBook - has anybody tried that before?
Dave Johnson in Blogging
05:51PM May 10, 2004
Comments [6]
Tags:
Blogging
This is just one entry in the weblog Blogging Roller. You may want to visit the main page of the weblog
Below are the most recent entries in the category Blogging, some may be related to this entry.
I'm doing something like that for my blog. What I've decided to do is to only write long blog articles in Simplified DocBook (which is a spec focusing on articles instead of books).
I'm generating HTML using make, some Ruby scripts, and the DocBook XSLT suite (with some customization), and then I manually add the link to my blog through the blog web interface. Although it might sound complex, since the make scripts are done, the whole thing is really simple.
I'm using Authentic (from the makers of XMLSPY) which is a free (as in free beer) Wysiwyg editor, including spellchecking, and brackets can be disabled :-)
See my article about this (done through the same process): my docbook article
Posted by Balazs Fejes on May 10, 2004 at 06:07 PM EDT #
Posted by Random bits from the digital ether on May 10, 2004 at 06:31 PM EDT #
Posted by Sérgio Carvalho on May 10, 2004 at 11:59 PM EDT #
Posted by eu on May 12, 2004 at 03:04 AM EDT #
Posted by Dave Johnson on May 12, 2004 at 10:16 AM EDT #
Posted by Brad Smith on May 13, 2004 at 01:59 PM EDT #