]> git.vanrenterghem.biz Git - git.ikiwiki.info.git/commitdiff
rename tips/convert_MoinMoin_and_TWiki_to_ikiwiki.mdwn to tips/convert_MoinMoin_to_ik...
authorhttps://id.koumbit.net/anarcat <https://id.koumbit.net/anarcat@web>
Tue, 3 Apr 2012 01:59:52 +0000 (21:59 -0400)
committeradmin <admin@branchable.com>
Tue, 3 Apr 2012 01:59:52 +0000 (21:59 -0400)
doc/tips/convert_MoinMoin_and_TWiki_to_ikiwiki.mdwn [deleted file]
doc/tips/convert_MoinMoin_and_TWiki_to_ikiwiki/discussion.mdwn [deleted file]
doc/tips/convert_MoinMoin_to_ikiwiki.mdwn [new file with mode: 0644]
doc/tips/convert_MoinMoin_to_ikiwiki/discussion.mdwn [new file with mode: 0644]

diff --git a/doc/tips/convert_MoinMoin_and_TWiki_to_ikiwiki.mdwn b/doc/tips/convert_MoinMoin_and_TWiki_to_ikiwiki.mdwn
deleted file mode 100644 (file)
index 50ac2fe..0000000
+++ /dev/null
@@ -1,44 +0,0 @@
-A MoinMoin and TWiki converter, which was originally written by [[JoshTriplett]] converts those wikis to ikiwikis backed by a git repository, including full history. It uses two techniques for conversion:
-
- * for MoinMoin, it parses the wiki pages into markdown using the MoinMoin engine
- * for Tikiwiki, it parses the wiki pages to HTML then back into markdown using the `libhtml-wikiconverter` Perl package
-
-The MoinMoin side of things was completely re-written by [[anarcat]] and is currently still in development. That version is available at:
-
-    git clone git://src.anarcat.ath.cx/moin2iki
-
-The original version from Josh is still available from [his wiki page](/users/JoshTriplett). [[anarcat]] will probably remove support from Tikiwiki eventually, as those two projects are really different...
-
-# MoinMoin scripts
-
-The MoinMoin part is made of two main pieces:
-
- * the importer (`moin2git`) - which converts the wiki pages into a git repository with full history
- * the converter (`moin2mdwn`) - which converts a set of moin-formatted text files into markdown + ikiwiki directives
-
-## MoinMoin importer features
-
- * supports 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)
- * multistep process allows bulk edit through git before markdown conversion, or staying with a 
- * imports attachments as subpages
- * 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
-
-## MoinMoin converter features
-
-
- * lots of macros are not translated
- * a bunch of markup and exotic uses of parsers will probably fail? 
-
-## MoinMoin features missing from ikiwiki
-
-The importer is pretty much complete, but the converter can only go so far as what features ikiwiki supports. Here are the MoinMoin features that are known to be missing from ikiwiki. Note that some of those features are available in MoinMoin only through third-party extensions.
-
- * [[todo/do_not_make_links_backwards/]] - MoinMoin and Creole use `\[[link|text]]`, while ikiwiki uses `\[[text|link]]` - for now the converter generates [[markdown]] links so this is not so much an issue, but will freak out users
- * [[todo/internal_definition_list_support/]] - includes tabling the results ([MoinMoin's DictColumns macro](http://moinmo.in/MacroMarket/DictColumns))
- * [[todo/per page ACLs]] - ([MoinMoin's ACLs](http://moinmo.in/HelpOnAccessControlLists))
- * more to be documented here
-
-Comments and feedback always welcome! --[[anarcat]]
diff --git a/doc/tips/convert_MoinMoin_and_TWiki_to_ikiwiki/discussion.mdwn b/doc/tips/convert_MoinMoin_and_TWiki_to_ikiwiki/discussion.mdwn
deleted file mode 100644 (file)
index cbe1084..0000000
+++ /dev/null
@@ -1,3 +0,0 @@
-I look forward to trying this.  I have a large (~10 year old) MoinMoin installation that has been migrated up to a 1.8.x version so far, and which is partially ACL'd away behind logins. — [[Jon]]
-
-> I'll make that clearer in the docs, but we do not deal with ACL (yet?), as ikiwiki doesn't support Moinmoin's level of ACL flexibility. See [[todo/per_page_ACLs]] for more information. --[[anarcat]]
diff --git a/doc/tips/convert_MoinMoin_to_ikiwiki.mdwn b/doc/tips/convert_MoinMoin_to_ikiwiki.mdwn
new file mode 100644 (file)
index 0000000..50ac2fe
--- /dev/null
@@ -0,0 +1,44 @@
+A MoinMoin and TWiki converter, which was originally written by [[JoshTriplett]] converts those wikis to ikiwikis backed by a git repository, including full history. It uses two techniques for conversion:
+
+ * for MoinMoin, it parses the wiki pages into markdown using the MoinMoin engine
+ * for Tikiwiki, it parses the wiki pages to HTML then back into markdown using the `libhtml-wikiconverter` Perl package
+
+The MoinMoin side of things was completely re-written by [[anarcat]] and is currently still in development. That version is available at:
+
+    git clone git://src.anarcat.ath.cx/moin2iki
+
+The original version from Josh is still available from [his wiki page](/users/JoshTriplett). [[anarcat]] will probably remove support from Tikiwiki eventually, as those two projects are really different...
+
+# MoinMoin scripts
+
+The MoinMoin part is made of two main pieces:
+
+ * the importer (`moin2git`) - which converts the wiki pages into a git repository with full history
+ * the converter (`moin2mdwn`) - which converts a set of moin-formatted text files into markdown + ikiwiki directives
+
+## MoinMoin importer features
+
+ * supports 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)
+ * multistep process allows bulk edit through git before markdown conversion, or staying with a 
+ * imports attachments as subpages
+ * 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
+
+## MoinMoin converter features
+
+
+ * lots of macros are not translated
+ * a bunch of markup and exotic uses of parsers will probably fail? 
+
+## MoinMoin features missing from ikiwiki
+
+The importer is pretty much complete, but the converter can only go so far as what features ikiwiki supports. Here are the MoinMoin features that are known to be missing from ikiwiki. Note that some of those features are available in MoinMoin only through third-party extensions.
+
+ * [[todo/do_not_make_links_backwards/]] - MoinMoin and Creole use `\[[link|text]]`, while ikiwiki uses `\[[text|link]]` - for now the converter generates [[markdown]] links so this is not so much an issue, but will freak out users
+ * [[todo/internal_definition_list_support/]] - includes tabling the results ([MoinMoin's DictColumns macro](http://moinmo.in/MacroMarket/DictColumns))
+ * [[todo/per page ACLs]] - ([MoinMoin's ACLs](http://moinmo.in/HelpOnAccessControlLists))
+ * more to be documented here
+
+Comments and feedback always welcome! --[[anarcat]]
diff --git a/doc/tips/convert_MoinMoin_to_ikiwiki/discussion.mdwn b/doc/tips/convert_MoinMoin_to_ikiwiki/discussion.mdwn
new file mode 100644 (file)
index 0000000..cbe1084
--- /dev/null
@@ -0,0 +1,3 @@
+I look forward to trying this.  I have a large (~10 year old) MoinMoin installation that has been migrated up to a 1.8.x version so far, and which is partially ACL'd away behind logins. — [[Jon]]
+
+> I'll make that clearer in the docs, but we do not deal with ACL (yet?), as ikiwiki doesn't support Moinmoin's level of ACL flexibility. See [[todo/per_page_ACLs]] for more information. --[[anarcat]]