Download everything from the project homepage at
SourceForge.
RefactorDW
1. General Information
1.1 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.
RefactorDW is administrated by the DigitalCure.org development crew.
2. 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.
2.1 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).
2.2 Refactoring
In most cases, before migration to Confluence, the Dokuwiki name space layout
must be refactored so that if fits the Confluence´s space philosophy which
does not permit interlaced spaces. Therefore RefactorDW provides some
useful refactoring and restructuring operations for Dokuwiki article assets
like moving/renaming name spaces, merging them or flattening their internal
hierarchy.
RefactorDW preserves all back links to the refactored elements.
3. RefactorDW Features
Resolve all naming conflicts by renaming the conflicting Dokuwiki elements into generated unique names:
articles/articles,
articles/name spaces,
name spaces/name spaces.
Provide batch operations (configured via XML config file) for refactoring and restructuring Dokuwiki´s name space structure:
rename/move a name space,
merge name spaces (move name space A into name space B),
flatten a name space (removes the interlaced name space hierarchy of a given name space).
Define batch operations by XML configuration file.
