Import DokuWiki into XWiki Application

Last modified by Thomas Mortagne on 2022/02/28 00:24

cogAllows to import and convert DokuWiki pages into XWiki
TypeXAR
Category
Developed by

Oana Florea

Active Installs8
Rating
0 Votes
LicenseGNU Lesser General Public License 3
Compatibility

Tested on XE/XEM 2.7+

Installable with the Extension Manager

Description

This extension is not maintained anymore. It's recommended to use DokuWiki Filter instead.

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)
    selectImport.png
    importedDocs.png

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)
    configuration.png
  • 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>/
  • next it will run the Dokuwiki to XWiki extension on the server on the selected files to generate the XWiki files
  • pages will be created by the extension for the XWiki txt files
  • 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:

  1. Log in the wiki with a user having Administration rights
  2. Go to the Administration page and select the Import category
  3. Follow the on-screen instructions to upload the downloaded XAR
  4. Click on the uploaded XAR and follow the instructions
  5. You'll also need to install all dependent Extensions that are not already installed in your wiki
Tags: migration
    

Get Connected