Random Stuff: Software Documentation with DocBook, Part 3

, Jul 19, 2003

Continuing from part 2, a test of XMLWriter (suggested by Lars Trieloff) did not really convince me. I gave IDEA, which I use for Java development, a try, but it went berserk when I asked it to validate against the DocBook DTD. So at the moment, I'm back at oXygen, which is not the fastest, but still the best of the lot so far.
BTW, I don't have any problems with using Java desktop apps in general; but unless they're really well done, one area that they have huge problems is text editing. So my next try will be XMLmind XML Editor to see how usable it is ...

On July 19, 2003 11:18 PM, Mark Derricutt said:

I use XMLMind’s XXE quite alot for my DocBook authoring, and love it. Its fast to use, easy to operate, and once you learn some of the quick keys very nice to use. ( ctrl-click and shift-click on a node type in the document path at the top to insert before/after the current section ).

It’s also extentable via scripting, and plugins ( although I’ve not yet tacked that side ).

The professional verion has a FOP plugin built in for PDF generation, but I have my PDFs built server side with Saxon/FOP running from the Anthill build server.

Now I just have to convince the others at work that DocBook is good.

On July 19, 2003 11:20 PM, Mark Derricutt said:

Also - one thing to be aware of with XXE is that it doesnt handle external entity includes. When it loads and parses the XML file, it will include them in memory, and when saving, write out one large file without said entities.

The forthcoming version is supposed to have XInclude support thou.