DocBook import for Confluence

Overview

"DocBook import for Confluence" is plugin for Atlassian Confluence allowing user to import DocBook xml formatted documentation into Confluence Space. It was originally created to import existing DocBook documentation for JBoss open source projects into newly introduced JBoss Community Project Documentation Editor, but we decided to give it to other users free of charge too.

Installation

Plugin is available on Atlassian plugin exchange, so you can install/update plugin directly from Confluence administration's "Plugin" page. Alternativelly you can download it from this page attachments and upload it into your Confluence instance manually.

Use

User needs "Space - Export" permission for given Confluence Space to use this plugin.

To import documentation select 'Import DocBook' item from the 'Tools' menu of confluence page (visible only for users with given permission). DocBook content is imported as subpage of given page then.

Changelog

2.0.0 (2015-01-13)
- updated to Confluence 5.0+
- special characters :@/\\|^#;[]{}<>$~ are not removed from page titles anymore
- menu item renamed to 'Import DocBook' and moved to secondary section of the page menu
- now it's possible to create new page for every DocBook section, not only for first level of sections
- DocBook XML remap attribute of section element is now stored as Label for relevant Confluence page
- try to load .ent file referenced in XML from parent folder if not present in same folder as XML file
- id attribute for chapter, section and appendix xml elements in imported DocBook is not mandatory anymore, but links can't target it in this case
- Data Center compatibility flag added
1.1.1
- improved handling of EOL - all EOL removed inside text parts
- less escape characters in imported wiki markup
1.1.0
- added support for DocBook 5 declared using xml namespace
- patched images import if one page used same image more times
- added validation for page title existence
1.0.2
- first release with DocBook 4 support