Added a comment

[git.ikiwiki.info.git] / doc / tips / convert_MoinMoin_to_ikiwiki.mdwn

diff --git a/doc/tips/convert_MoinMoin_to_ikiwiki.mdwn b/doc/tips/convert_MoinMoin_to_ikiwiki.mdwn
index 51129a67d2c5986b6f7bed521160ee9affaa54b8..3ebde552fc0aac187c764870e53b34df1b884268 100644 (file)
--- a/doc/tips/convert_MoinMoin_to_ikiwiki.mdwn
+++ b/doc/tips/convert_MoinMoin_to_ikiwiki.mdwn
@@ -8,6 +8,8 @@ The MoinMoin side of things was completely re-written by [[anarcat]] and is curr
 
 It doesn't feature support to migrate from Tikiwiki anymore and focuses on MoinMoin support.
 
+[[!toc levels=2]]
+
 The software is made of two pieces:
 
  * the importer (`moin2git`) - which converts the wiki pages into a git repository with full history
@@ -34,10 +36,12 @@ The software is made of two pieces:
  * ordered, unordered and definition lists
  * tables (although only with HTML and no styles)
 
-Supported macros:
+### Supported macros
 
  * TableOfContents, through [[ikiwiki/directive/toc]]
- * Navigation, partially, through [[ikiwiki/directive/inline]]
+ * Navigation, through [[ikiwiki/directive/map]] (so as a nested
+   vertical list instead of an horizontal list)
+ * PageList, through [[ikiwiki/directive/map]]
  * MonthCalendar, partially, through [[ikiwiki/directive/calendar]]
  * FootNote, through markdown
  * Anchor, through markdown and plain HTML
@@ -45,18 +49,25 @@ Supported macros:
  * AttachList, through a weird [[ikiwiki/directive/inline]]
  * FullSearch, partially, only through [[ikiwiki/directive/inline]] (so no textual search)
  * Include, partially through [[ikiwiki/directive/inline]] (so missing boundary extraction and heading level generation)
- * PageList, throuhg [[ikiwiki/directive/inline]]
+ * PageCount, same name even :)
+ * OrphanedPages, through [[ikiwiki/directive/oprhans]]
 
-Supported parsers:
+### Supported parsers
 
  * the main "moin wiki" markup
  * highlight parser, through the [[plugins/format]] plugin
  * other parsers may be supported if an equivalent plugin exists in Ikiwiki (example: [[plugin/rst]])
 
-## Current blocker and todos
+## Current blocker
 
 This script is being used to test the conversion of the venerable [Koumbit wiki](https://wiki.koumbit.net/) into Ikiwiki, and so far progress is steady but difficult. The current blocker is:
 
+ * figuring out exactly which pages should exist and which should not, as there is ambiguity in the internal datastructures of MoinMoin, which become apparent when running the conversion script, as files a missing
+
+## Todos
+
+There are also significant pieces missing:
+
  * inline parsers and hackish styled tables
  * turn categories into tags
  * name converted page to the right name depending on the `#format` parameter on top of page
@@ -74,6 +85,21 @@ The importer is pretty much complete, but the converter can only go so far as wh
  * list pages based on full text page search
  * extract part of other pages with the inline macro
  * specifying a template when creating a page (as opposed to matching a pagespec)
- * specifying a style for a sub-section (MoinMoin's inline parsers allow the user to specify a CSS class - very useful see [the documentation](http://moinmo.in/HelpOnMoinWikiSyntax#Using_the_wiki_parser_with_css_classes) to get an idea)
+ * specifying a style for a sub-section (MoinMoin's inline parsers
+   allow the user to specify a CSS class - very useful see
+   [the documentation](http://moinmo.in/HelpOnMoinWikiSyntax#Using_the_wiki_parser_with_css_classes)
+   to get an idea)
+ * the above also keeps the SectionParser from being properly supported
+ * regex matching all over the place: pagespec, basically, but all
+   full text search (which is missing anyways, see above)
+
+### Missing macros
+
+ * RandomPage(N) - lists N random pages, skipped
+ * Gallery() - skipped
+ * Gettext - translates the string accordign to internal translation
+   system, ignored
+ * AdvancedSearch - an elaborate search form provided by MoinMoin
+ * Goto - a simple "jump to page" macro
 
 Comments and feedback always welcome! --[[anarcat]]