X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/795f7af7e6d7eb48002f6cd5e62af9e18f98be88..e626bc977974f1915cc954d56b93b949a215a4ca:/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 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 + * `<
>`, 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]]