Confluence XML
Filter stream extension to parse a Confluence XML package |
Type | JAR |
Category | |
Developed by | |
Active Installs | 62 |
Rating | |
License | GNU Lesser General Public License 2.1 |
Table of contents
Description
Filter module used to read a Confluence XML package. Allow for example to import it into an XWiki instance.
In an XWiki instance it's generally used through Filter Streams Converter Application which needs to be installed separately. Select it as input module and select the output module you want (the instance module to import the confluence package in the current instance for example).
Tutorial
To get started with the Confluence Import, you will need to install the Filter Streams Converter Application and this Filter Confluence XML module. You can install these apps using the Extension Manager.
You then need to export your confluence data from the Confluence administration and upload the zip file to the XWiki server. Make sure you make it accessible to the user running your java process.
After you have installed the two extensions, click on the Filter Stream Converter entry from the Applications panel.
Follow these steps on the screenshot below:
- Choose the "Confluence XML input stream (confluence+xml)" input type
- Fill in the source field which contains "file:" followed by the path of the Confluence zip file, located on the machine where XWiki is running
- Choose the "XWiki instance output stream (xwiki+instance)" output type to import the Confluence pages in your wiki
After you have completed these steps, click the "Convert" button. After that, you will see the conversion progress. For example:
For example with the following initial page from Confluence:
You'll get the following page in XWiki after you've made the import:
You're all set!
Release notes
Release notes can be found on Confluence project page.
Prerequisites & Installation Instructions
We recommend using the Extension Manager to install this extension (Make sure that the text "Installable with the Extension Manager" is displayed at the top right location on this page to know if this extension can be installed with the Extension Manager).
You can also use the manual method which involves dropping the JAR file and all its dependencies into the WEB-INF/lib folder and restarting XWiki.
Dependencies
Dependencies for this extension (org.xwiki.contrib.confluence:confluence-xml 9.2.2):
- org.apache.commons:commons-compress 1.12
- commons-configuration:commons-configuration 1.10
- org.xwiki.commons:xwiki-commons-filter-xml 8.4
- org.xwiki.platform:xwiki-platform-filter-event-model 8.4
- org.xwiki.platform:xwiki-platform-filter-event-user 8.4
- org.xwiki.platform:xwiki-platform-model 8.4
- org.xwiki.contrib.confluence:confluence-syntax-xhtml 9.2.2
- org.xwiki.contrib.confluence:confluence-syntax-confluence 9.2.2