I evaluated Docbook support for OpenOffice and the results are mixed.
* Multiple chapters is not supported. Our doc is split into separate chapters that are
included in the master.xml "book".
When I edit one of the individual chapter, OOo does not recognize it as a docbook subset
and display the source text (with xml tags)
=> We'd have to aggregate all our document in a single file to be able to use OOo
(this means more svn merge operations)
* OpenOffice Docbook support is not complete. If I add a toc tag to the file outside OOo
(to generate the table of contents in the output formats), OOo removes it when I save the
file.
=> Table of contents would have to be generated from OOo. This means the document
generation will no longer be automated
* Section ID. I've some issues to create permalink to sections. Either I have a
duplicated title (only 1 having the permalink ID) or none. I'm still figuring out how
it works
To sum up, using OOo and saving in docbook:
* does not allow to edit manually the file (changes will be lost next time the file is
saved by Ooo)
* prevents automatic generation of HTML/PDF (missing TOC)
I'm not an OOo expert and there may be ways to circumvent these limitations but I
haven't found them.
View the original post :
http://www.jboss.org/index.html?module=bb&op=viewtopic&p=4228676#...
Reply to the post :
http://www.jboss.org/index.html?module=bb&op=posting&mode=reply&a...