DocBook import for Confluence

Version 21

    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.

     

    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
    1.0.2cross-small.pngno_entry-small.png
    1.1.0+cross-small.pngcross-small.png

     

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

     

    Installation

    Plugin is available on Atlassian Marketplace, so you can install/update plugin directly from Confluence administration.

    Other important prerequisities:

    • Make sure your confluence's Maximal attachment size is configured to enough value for imported zip files
    • Make sure your confluence's http response timeout is enough not to break response when Import button is hit (as it is sync now)

     

    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.

    All necessary notes/help to use this plugin are available directly on import page, and you may also look here https://docs.jboss.org/author/display/AUTHGUIDE/How+to+import+DocBook+XML.

     

    Changelog

    https://github.com/jbossorg/docbook-import-for-confluence/blob/master/changelog.txt

     

    Source codes

    Source code for this plugin is available under LGPL v.2.1 license in GIT repository https://github.com/jbossorg/docbook-import-for-confluence