document my work
authorhttps://id.koumbit.net/anarcat <https://id.koumbit.net/anarcat@web>
Sat, 31 Mar 2012 19:49:12 +0000 (15:49 -0400)
committeradmin <admin@branchable.com>
Sat, 31 Mar 2012 19:49:12 +0000 (15:49 -0400)
doc/tips/convert_MoinMoin_and_TWiki_to_ikiwiki.mdwn

index 5565dbd8a365a0f77e6d06dc60cac5d98c80285d..b9bad18bc9768d64ca468bc06fdc39db36311a03 100644 (file)
@@ -1,3 +1,25 @@
 [[JoshTriplett]] has developed scripts to convert MoinMoin and TWiki wikis
 to ikiwikis backed by a git repository, including full history. For
 details, see [[his_user_page|JoshTriplett]].
+
+> 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.
+> 
+>     git clone git://src.anarcat.ath.cx/moin2iki
+>
+> List of improvements:
+>
+>* full rewrite of git migration tool to support latest MoinMoin versions (tested with 1.9.x)
+>* uses `git fast-import` to improve performance (10 minutes and 200M of ram for a 7 years old 2GB Moinmoin wiki)
+>* more reliable as it uses the per-page edit log
+>* consistent: multiple runs will generate the same repository
+>* re-entrant: can be run multiple times to import new changes
+>
+> 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.
+>
+> Big things missing:
+>
+> * lots of macros are not translated
+> * a bunch of markup and exotic uses of parsers will probably fail? 
+> * [[todo/internal_definition_list_support/]]
+> * [[todo/do_not_make_links_backwards/]]
+> * fix up documentation and make sure all the pieces go into place