]> sipb.mit.edu Git - ikiwiki.git/blob - doc/tips/convert_MoinMoin_and_TWiki_to_ikiwiki.mdwn
some answers
[ikiwiki.git] / doc / tips / convert_MoinMoin_and_TWiki_to_ikiwiki.mdwn
1 [[JoshTriplett]] has developed scripts to convert MoinMoin and TWiki wikis
2 to ikiwikis backed by a git repository, including full history. For
3 details, see [[his_user_page|JoshTriplett]].
4
5 > I have worked on porting this to more recent MoinMoin versions, optimising it and making sure it works reliably even on big wikis with funky things.
6
7 >     git clone git://src.anarcat.ath.cx/moin2iki
8 >
9 > List of improvements:
10 >
11 >* full rewrite of git migration tool to support latest MoinMoin versions (tested with 1.9.x)
12 >* uses `git fast-import` to improve performance (10 minutes and 200M of ram for a 7 years old 2GB Moinmoin wiki)
13 >* more reliable as it uses the per-page edit log
14 >* consistent: multiple runs will generate the same repository
15 >* re-entrant: can be run multiple times to import new changes
16 >
17 > Look at the `moin2git2` script for most of my work, which really consisted on importing the MoinMoin pages into git reliably. Now I am rewriting the MoinMoin parser to generate markdown directly instead of going through HTML, because I want to support translating the macros too.
18 >
19 > Big things missing:
20 >
21 > * lots of macros are not translated
22 > * a bunch of markup and exotic uses of parsers will probably fail? 
23 > * [[todo/internal_definition_list_support/]]
24 > * [[todo/do_not_make_links_backwards/]]
25 > * fix up documentation and make sure all the pieces go into place
26 >
27 > Comments and feedback always welcome! --[[anarcat]]