Filter stream extension to parse a MediaWiki XML package

Description

Filter stream extension to parse a MediaWiki XML package

Supported input

XML export

The Filter take in input a XML file as defined in https://www.mediawiki.org/wiki/Help:Export#Export_format.

Files

The XML file contain the wiki pages but MediaWiki also store files on the filesystem. You can directly use the folder in which MediaWiki store its files.

Import a MediaWiki export in an XWiki instance

• Install Filter Streams Converter Application
  
• Install MediaWiki XML
• After you have installed the two extensions, click on the Filter Stream Converter entry from the Applications panel
  
• Choose the "XWiki instance output stream (xwiki+instance)" output type
• Choose the "MediaWiki XML input stream (mediawiki+xml)" input type
  • Indicate in the "Source" field the XML file you exported
  • Indicate in the "Files" field the folder containing the MediaWiki files

After you have completed these steps, click the "Convert" button. After that, you will see the conversion progress.

Advanced use

Import everything in a specific wiki/space

By default the importer try convert as much as possible MediaWiki naming into XWiki naming. That means that all the page located in default MediaWiki namespace will end up in XWiki Main space for example.

If you make all the imported pages go in a specific wiki or space you  can use the property "Parent". Indicate the reference of the entity. For example for the wiki with the id mywiki use wiki:mywiki and for the space MediaWiki in wiki with id mywiki you can use space:MediaWiki:MediaWiki. It does not need to already exist.

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.mediawiki:mediawiki-xml 1.7.7):

• org.apache.commons:commons-compress 1.10
• commons-configuration:commons-configuration 1.10
• org.xwiki.commons:xwiki-commons-filter-xml 7.4
• org.xwiki.platform:xwiki-platform-filter-event-model 7.4
• org.xwiki.platform:xwiki-platform-filter-event-user 7.4
• org.xwiki.platform:xwiki-platform-model 7.4
• org.xwiki.contrib.mediawiki:mediawiki-syntax 1.7.7
• org.xwiki.rendering:xwiki-rendering-syntax-xwiki21 7.4