Semantic documentation markup languages: XDocs, DocBook, Dita

I’ve been using the Maven XDoc markup language for documenting design on a client project. Looking into editors for XDoc led me to taking a closer look at DocBook, and Dita, a relative newcomer. All of these formats allow you to write documentation in a semantic manner, separate from the presentation. You can then generate HTML, PDF, RTF, etc from your document using your choice of transformers. DocBook has been around the longest, but is still active, with the 5.0 version recently released.

The best editor for these formats I’ve found is XMLMind XMLEditor. Here is information on using XMLEditor to edit XDoc documents. The latest version of XMLEditor supports DocBook v4 and v5 out of the box, and support for Dita can be downloaded as a plugin. Currently I’m leaning towards using DocBook for technical documentation due to its wider support, although Dita sounds interesting.

This entry was posted in Tools. Bookmark the permalink.

Leave a Reply

Your email address will not be published. Required fields are marked *