Smart Paste MSWord to DocBook Documentation?

[jbzech]

I absolutely love the smart paste capability when moving a document from MSWord into DocBook. Is there any documentation on how Oxygen processed the styles in MSWord? I still have to do a lot of cleanup on my DocBook doc, but if I had a better idea of how Oxygen handles the import, I can set up rules to start with cleaner manuscript.

For example, I had an author styling chapters titles with Word's default TITLE style. But Oxygen just set those titles as <para>. When I changed all the titles to the HEADING 1 style in Word, the <section> and <title> tags were applied correctly. When I bring in bulleted or numbered lists, they aren't correctly tagged unless I change the text style of the automated lists to Normal.

These things are all fine but if I had documentation on how to manage the Word document for cleaner import, it would be a huge help.

Thanks.

[sorin_ristache]

Hello,

Oxygen maps the elements of a MS Word document to the DocBook element names based on the following rules:

• a MS Word heading is mapped to the title child element of a new section
• the new section just created will contain all the MS Word paragraph, images, lists, subsections (sections started by a smaller heading, for example a Heading2 and Heading3 are smaller than a Heading1), etc that follow that MS Word heading
• an unordered list (non-numbered lists) is mapped to itemizedlist
• an ordered list is mapped to an orderedlist
• an image is mapped to a figure

etc. Basically you should not associate a custom style to the elements created by MS Word because Oxygen looks at the default styles set by MS Word. For example do not associate a strange list item marker or a strange style for a heading.


Regards,
Sorin