
OOo2DBK: Generating DocBook from OpenOffice.org

Presentation
============

OOo2DBK is an OpenOffice.org document to DocBook XML converter. It can produce
both DocBook "article" and DocBook "book" documents.

The online reference presenting all the available DocBook elements is
http://docbook.org/tdg/en/html/

The original version of ooo2dbk is ooo2sdbk, written by Eric Bellot. This
version can still be found at http://www.chez.com/ebellot/ooo2sdbk/

A modified version of ooo2sdbk has also be done in 2003 by Stefan Rinke and can
be found at http://www.stefan-rinke.de/articles/publish/en/

Use the "template.stw" OpenOffice.org template file to create your own OOo
documents from which DocBook documents will be generated.

Features and changes over ooo2sdbk
==================================

  * DocBook support
    o Generating "DocBook XML V4.3".
    o Generating DocBook "article" or DocBook "book" documents based on user
      choice, generated documents have the corresponding structure.
    o Added new generic support for both DocBook preface and 
      appendix elements.
    o Added support for superscript and subscript elements.
    o Adding support for cell alignment in tables.
    o Added support for "border" styles of table cells. The 
      border information is passed as processing instructions that the 
      following XSLT stylesheets are able to process.
    o Added support for "font-name" from OOo that could be used 
      to mark fonts with symbols.

  * OpenOffice.org interactions
    o Added support for meta-information set via 
      text:user-field-decl OOo elements.
    o Do not display not visible sections (text:display="none").
    
  * Options and configuration
    o Added -zFILE/--zipfile=FILE option for generating zipped archive of output
      Docbook document with subobjecs (if any).
    o Augmented the config.xml configuration file so that each "xslt-command"
      element has now a "param-syntax" attribute. This is done because XSLT
      processors have different command line options. ooo2dbk now deals better
      with the different available XSLT processors.
    o Added an -xFILE/--xslt=FILE option to specify an alternative XSLT
      stylesheet to be able to simply customize ooo2dbk.xsl by importing it from
      another stylesheet.
    o Added a "-v/--verbose" option to the ooo2dbk script.

Download
========

Get latest ooo2dbk snapshot from Nuxeo CVS (select "Download tarball")
http://cvs.nuxeo.org/cgi-bin/viewcvs.cgi/Indesko/ooo2dbk/

Bugs can be reported at http://bugs.nuxeo.com/bugzilla/
Reports must include the output of ooo2sdbk with the "--verbose" option.

