Skip to content

Latest commit

 

History

History
56 lines (43 loc) · 3.33 KB

README.md

File metadata and controls

56 lines (43 loc) · 3.33 KB
Raw

Build Status

Summary

Run twiki2mediawiki.pl to convert a TWiki web to MediaWiki.

  • Process individual TWiki .txt files, or trawl through entire data directory
    • Special TWiki pages are ignored (TWikiPreferences, WebStatistics, etc.)
  • Save the MediaWiki files locally, or import them using importTextFiles.php
    • Optionally delete pages from database (e.g. to undo previous import) using deleteBatch.php
    • Optionally rename to Mediawiki-style links using moveBatch.php
  • Optionally import attachments using importImages.php
    • Optionally delete old versions first using deleteBatch.php
    • Attachments from other pages & webs are automatically included
  • Optionally import all your InterWiki links (uses the bundled addInterwiki.php maintenance script)
  • Preserves timestamps (but not revision history) and usernames (but doesn't create users)
  • Converts most formatting including lists & tables
  • Converts some built-in TWiki variables including e.g. %TOPIC%, %INCLUDE%, %ICON%, %ATTACHURL%, %DATE%
  • Handles TWiki variables that are defined in the page, or in TWikiPreferences or WebPreferences
  • Includes some mappings from TWiki plugins to Mediawiki extensions:

For help/options: twiki2mediawiki.pl -h

Installation

Requires:

  • Perl

Run the tests: make test

License

This program (like the original twiki2mediawiki.pl source, and @rmcastil's derivative) are under the GPL license.

The original sources can be found here:

Disclaimers

There are no guarantees made about this software, and it will not be supported for free.

Use at your own risk, and be prepared for some rough edges. The conversion will almost certainly be flawed, and you may need to iterate a few times, fixing bugs as you go. I found it helpful to keep both TWiki and MediaWiki up in parallel during the migration, editing the TWiki pages to fix some glitches and editing this software to fix others.

This code should not be seen as a statement of wiki-engine advocacy. TWiki has given me great service over the years, and the community is helpful. However, sometimes you have to move. My hope is that the possibility of an easier migration to Mediawiki will ultimately make TWiki itself more appealing, as well as rescuing content from some TWikis that might otherwise be abandoned.