DocBook import for Confluence

Version 20


    "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.


    See our motivation video.


    Plugin was designed and tested to import DocBook 4 declared by DOCTYPE style in imported xml file originally. DocBook 5 declared by xml namespace works from version 1.1.0. DocBook compatibility:

    Plugin version
    DocBook 4
    DocBook 5


    In case of problems you may use comments under this article or forum available in this Space, but plugin is not oficially supported.



    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.



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

    Make sure "Attachment Maximum Size" in Confluenece's "General Configuration" is enough to import your DocBook zip file.

    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.

    All necessary notes/help to use this plugin are available directly on import page, and you may also look here



    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
    - improved handling of EOL - all EOL removed inside text parts
    - less escape characters in imported wiki markup
    - 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
    - first release with DocBook 4 support


    Source codes

    Source code for this plugin is available under LGPL v.2.1 license in GIT repository