« What belongs on a... | Main | Recent Wiki spam... »

Weblog to DocBook.

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?

Comments:

Hi,
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 #

[Trackback] In his weblog to docbook post, Dave Johnson asks ...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 coul...

Posted by Random bits from the digital ether on May 10, 2004 at 06:31 PM EDT #

Take a look at LyX. It defaults to using LaTeX as the document format, but can use DocBook just as easily.

Posted by Sérgio Carvalho on May 10, 2004 at 11:59 PM EDT #

Dave, that lead me into the question, when we will see a blog export in Roller?

Posted by eu on May 12, 2004 at 03:04 AM EDT #

We are working on that for Roller 0.9.9. I'll be announcing something soon,

Posted by Dave Johnson on May 12, 2004 at 10:16 AM EDT #

You might also look at Norm Walsh's site weblog site. His "how" is at: http://norman.walsh.name/2003/05/14/how brad

Posted by Brad Smith on May 13, 2004 at 01:59 PM EDT #

Post a Comment:
  • HTML Syntax: NOT allowed

« What belongs on a... | Main | Recent Wiki spam... »

Welcome

This is just one entry in the weblog Blogging Roller. You may want to visit the main page of the weblog

Related entries

Below are the most recent entries in the category Blogging, some may be related to this entry.