Import Export from any other Wiki

Last modified by Arun Reddy on 2018/10/19 11:41

Import Export from any other Wiki

The objective of this is to create an extensible framework to import export data between wikis from a rich UI. It includes converting and importing the data into XWiki from various supported export formats of other wikis. Mostly it will be a batch import along with text, metadata, links, attachments etc.. The export feature involves exporting the XWiki data into syntax free formats like XML (XDOM).

This feature will be of  great help to XWiki users who want to migrate their site from other wikis like Confluence, MediaWiki, JSPWiki, TWiki ... to XWiki with ease. 

Features

  1. A Rich User Interface ( Wizard Approach)
  2. Supports Multiple Syntaxes. Confluence, MediaWiki, TWiki, JSPWiki, Creole etc..
  3. Customizable import. Preserve metadata, links to other pages, attachements and spaces. 
  4. Content Specific warnings in case of  issues with conversion of scripts or macros from one Wiki to another.
  5. A complete step by step documentation for users on how to export the acceptable formats from other wikis and import the same into XWiki.

Design

ArchitectureDesign.png

Input Type : Takes  acceptable export formats as input and passes it to the respective parsers. It also takes other import settings like target space name, filters, preserver hierarchy and metadata.  

Parsers : Export type specific parsers takes all the input data along with import settings and create XDOM out of it. These make use of  the existing Syntax specific content parsers to get the job done.  

Customize Import : Customize the import by choosing the Spaces, macro transformations, attachments from the existing ones. In case of any errors during conversion in previous step warnings will be generated (Unable to parse the macro or some scripts) so that the user can respond to it and customize the way he wants which helps in a clean import process.

XWiki Renderer : Converts the XDOM' to XWiki Syntax 2.0 or native syntax and create the necessary files.

Final Import : The files created in the last step are used to import into the XWiki space using public api. A brief summary of the import process will be shown.