Description

This application allows you to import and convert DokuWiki pages into XWiki.

How to use it

the user will attach a ZIP archive to the import page (size: max 30MB)

the application will read the archive content and will list the available files for import only from the following folders: <dokuwiki dir>/data/pages/ and optionally <dokuwiki dir>/data/media/

the user will select if he wants to import the content as an existing version or as a new wiki page

next he will select the files he wants to import from the available list and he will confirm the import action

a list of all files and their status is displayed at the end (with a message if they were imported or not)

Details

Configuration options are available in the XWiki administration section for: script path (path to the Dokuwiki to XWiki extension script on the server), root folder (import pages from the DokuWiki archive after this folder), default root space name (create pages after the root folder in this space)

some folders are ignored: <dokuwiki dir>/data/pages/playground/ and <dokuwiki dir>/data/pages/wiki/

the script will read the archive files and save them temporary on the server in <server path>/output<datetime>/

space homepages will be created to map the dokuwiki hierarchy folders and parents are set for the imported files

display the text from the bienvenue.txt file (if available) as homepage of the spaces created above (use the include macro)

the images from the media folder are optionally imported as attachments for wiki pages

the files on the server are cleaned up: <server path>/output<datetime>/

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). Note that installing Extensions when being offline is currently not supported and you'd need to use some complex manual method.

You can also use the following manual method, which is useful if this extension cannot be installed with the Extension Manager or if you're using an old version of XWiki that doesn't have the Extension Manager: