aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorhttps://id.koumbit.net/anarcat <https://id.koumbit.net/anarcat@web>2012-04-02 22:34:04 -0400
committeradmin <admin@branchable.com>2012-04-02 22:34:04 -0400
commite626bc977974f1915cc954d56b93b949a215a4ca (patch)
tree8bc0b7cc80efe9bdd006e3e654e30893fe81de24 /doc
parent795f7af7e6d7eb48002f6cd5e62af9e18f98be88 (diff)
downloadikiwiki-e626bc977974f1915cc954d56b93b949a215a4ca.tar
ikiwiki-e626bc977974f1915cc954d56b93b949a215a4ca.tar.gz
expand on current status
Diffstat (limited to 'doc')
-rw-r--r--doc/tips/convert_MoinMoin_to_ikiwiki.mdwn45
1 files changed, 42 insertions, 3 deletions
diff --git a/doc/tips/convert_MoinMoin_to_ikiwiki.mdwn b/doc/tips/convert_MoinMoin_to_ikiwiki.mdwn
index ead95678c..51129a67d 100644
--- a/doc/tips/convert_MoinMoin_to_ikiwiki.mdwn
+++ b/doc/tips/convert_MoinMoin_to_ikiwiki.mdwn
@@ -25,8 +25,43 @@ The software is made of two pieces:
## MoinMoin converter features
- * lots of macros are not translated
- * a bunch of markup and exotic uses of parsers will probably fail?
+ * most of the inline markup
+ * links
+ * attachment links
+ * smileys
+ * images (not well tested), into [[ikiwiki/directive/img]]
+ * preformatted and code areas, including [[ikiwiki/directive/format]]
+ * ordered, unordered and definition lists
+ * tables (although only with HTML and no styles)
+
+Supported macros:
+
+ * TableOfContents, through [[ikiwiki/directive/toc]]
+ * Navigation, partially, through [[ikiwiki/directive/inline]]
+ * MonthCalendar, partially, through [[ikiwiki/directive/calendar]]
+ * FootNote, through markdown
+ * Anchor, through markdown and plain HTML
+ * `<<BR>>`, through the weird line ending thing
+ * 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]]
+
+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
+
+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:
+
+ * 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
+ * finish a full converter run on the Koumbitwiki
+ * improve the output of the converter (too much debugging)
## MoinMoin features missing from ikiwiki
@@ -35,6 +70,10 @@ The importer is pretty much complete, but the converter can only go so far as wh
* [[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
+ * [MailTo](http://moinmo.in/HelpOnMacros/MailTo) macro spam protection
+ * 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)
Comments and feedback always welcome! --[[anarcat]]