MoinMoin: MigrationStrategy/FromTikiWiki

This was successfully done by DanielaNicklas with a TikiWiki v1.7, the scripts were running under Windows XP. The result is http://www.die-ketzer.de/wiki, a German rpg stuff - wiki.

Rather than converting the wiki markup, the approach is to convert the HTML, doing some specialized stuff with tiki-URLs.

What this approach does:

• get pages in html over http

• convert html to MoinMoin markup:

  • map category links to MoinMoin categories

  • rename specified pages (and all links)

  • convert -= titlebars =- to === title 3 ===

  • cleans up internal linking: [wiki:SomePage SomePage] to SomePage

What this approach does not:

• convert links to nonexisting pages that have no WikiName. Inserts FixMe/EditLink to retrieve them later

• convert image links
• everything that is just in the mysql-DB and not on the page
  • put pages in categories that have no link to them
  • obtain access control

• import information from forum, blogs, comments, shoutbox, and all the other additional features from TikiWiki

Get a list of pages

If you have access to the server, login to the mysql database and perform: select pagename from tiki_pages; Otherwise, you have to use http://hostname/tiki/tiki-listpages.php and copy&paste (avoid this).

Paste the plain pagenames into a textfile with one pagename per line.

Get the print-html-version of all pages

Use this script: gettiki_html.py

You have to adjust the config variables in the script:

   1 wikihost="hostnameofthewiki.org"
   2 wikipath="/tiki/tiki-print.php?page="
   3 targetdir="pages"
   4 pagelistfile = "pagelist"

The script gets the wiki pages from the pagelistfile and stores them in the targetdir.

Convert html to MoinMoin-Wikimarkup

Adopt

• tikihtml2moinmoin.py

It uses a modified version of

• HTML2MoinMoin.py

which can be placed in the same directory.

Note: The <i> tag is not converted in this version of the script. Look at the source and copy the syntax used for the <em> tag to fix that. --MarkStosberg

Adoptions:

TikiWiki uses numbers for categories. Hence, if you want to link in TikiWiki to a category, you have to type in [tiki-browse_categories.php?parentId=4 Category Stuff]. In MoinMoin, we want to have .

In the converter script, there are to lists that map tiki-categories:

In some wikis, all pages that belong to a category do start with the same prefix (like "Help" in MoinMoin). This can be done here:

   1 # Pages that start with key go to Category
   2 page2category = {
   3     'NameInTiki': 'CategoryNewName',
   4     'AnothernameInTiki': 'CategoryAnotherOrSameNewName'}

The actual mapping from tiki-categories to MoinMoin is done in the parser:

   1         self.tikicategory = {
   2             1 : 'NameInTiki',
   3             4 : 'AnotherNameIn'
   4             }

You may want to rename certain pages (and all links to them!) Configure this list:

   1         self.linkreplacements = {
   2             'HomePage': 'FrontPage',
   3             'UserPageYourPage': 'YourName'
   4             }

Install MoinMoin

• see HelpOnInstalling

Finishing

• Put the files from text to your wikiname/data/text -directory.

• Set up your categories: for each new category, make a new CategoryPage - see HelpOnCategories

• attach all pictures from the TikiWiki-Image-Gallery to a page named ImageGallery

• If you use FixMe/EditLink, make a page with this name where you describe what is to be done, when somebody discovers it.

• If you had pictures in the TikiWiki, you may like to make a FixMe/ImageLinks}} too, where you list the pages that are missing pictures, and describe how to insert them again (with {{{ImageGallery/filename.ext).

• Help the users to adopt: make a page with a table like that (sorry, it's only in German):

Have Fun