General Information

Description

RefactorDW is a tool based on Java technology that provides several capabilities for re-structuring and re-factoring existing Dokuwiki article assets.
This enables the user to re-structure the name space layout of Dokuwiki (move, merge, rename, flatten) and to resolve naming conflicts between articles and/or name spaces.

A typical use case for using RefactorDW is preparing the migration from Dokuwiki to Confluence.

Hosting & License

• RefactorDW is published under MIT License
• RefactorDW is hosted on Sourceforge
• RefactorDW is administrated by the Digitalcure.org development crew

Use Case Scenario

Dokuwiki migrators might find using this tool helpful when preparing to migrate from Dokuwiki to Confluence Wiki using Atlassian's UWC Dokuwiki Converter, because there are some problems that have to be solved in order to migrate to Confluence successfully: UWC Dokuwiki Converter assumes that all articles have unique names. If not they will get overridden without warning.

Naming Conflicts

Therefore the migrator has to assert that there are no naming conflicts.

Possible naming conflicts are

• articles/articles
• articles/name spaces
• name spaces/name spaces

If one wants to preserve Dokuwikis name space hierarchy when using UWC Dokuwiki Converter, UWC will transform name spaces into articles. That might cause new naming conflicts that the migrator didn't notice before.

RefactorDW solves all types of possible naming conflicts by analyzing Dokuwiki's article assets and renaming the conflicting elements (preserving all back links of course).

Re-Fefactoring

In most cases, before migration to Confluence, the Dokuwiki name space layout must be re-factored so that if fits the Confluence's space philosophy which does not permit interlaced spaces. Therefore RefactorDW provides some useful re-factoring and restructuring operations for Dokuwiki article assets like moveing/renaming name spaces, merging them or flattening their internal hierarchy.

RefactorDW preserves all back links to the refactored elements.

RefactorDW Features

1.  Resolve all naming conflicts by renaming the conflicting Dokuwiki elements into generated unique names
   1. articles/articles
   2. articles/name spaces
   3. name spaces/name spaces
2. Provide batch operations (configured via XML config file) for refactoring and restructuring Dokuwiki's name space structure:
   1. Rename/Move a name space
   2. Merge name spaces (move name space a into name space b)
   3. Flatten a name space (removes the interlaced name space hierarchy of a given name space)
3. Define batch operations by XML configuration file.

Download

• Get RefactorDW from sourceforge

Installation

Requirements

Running RefactorDW requires ...:

• Linux as OS (not tested under Windows)
• at least 1GB RAM
• Java 6 or higher
• Ant and JUnit4 if you want to build RefactorDW

Configuration

RefactorDW is configured through XML configuration file. For more information please see

• /doc/manual.txt and
• /config/refactordw_config.xml

in the distribution package

Links

• Dokuwiki
• Confluence Wiki
  
  • Universal Wiki Converter (UWC)
• RefactorDW on Sourceforge.net