[Mailman-Developers] Wiki woes
paul at boddie.org.uk
Fri Dec 21 00:22:35 CET 2012
Here's a quick update on the ConfluenceConverter effort. A few issues were
raised after I let you know about the work originally done, and I have
investigated them to yield the following results.
* The availability of XML exports does not seem to be a problem. It doesn't
look like my access to the export tools is any different from registered
users, and the tools seem to give me enough to work with anyway.
* The nature of Confluence 4 markup appears to be an XHTML variant which is in
some ways easier to parse than the previous markup (in that the tokenisation
is at least done by an XML parser), although the normalisation of whitespace
is a bit tricky (as is often the case with XML dialects). Possibly the bulk
of the work with this is to assess the use and nature of the markup and to
write reasonable translations.
* The notion of child pages does not exist in MoinMoin, but it is possible to
construct lists of them and to add them to parent pages so that the
relationships are at least recorded.
* Similarly, MoinMoin does not have comment items on pages in the way
Confluence does, but comments can be represented as subpages and then these
pages can be included in the owner page.
* I noticed that pages with question marks in their names weren't being
correctly served, but this is actually a mod_rewrite issue specific to the
way I am currently hosting the test site. My own local site does not exhibit
the problem, nor should any decent way of hosting the site.
The current state of the conversion can be seen here:
The principal updates to this test site are that revisions migrated to
Confluence 4 markup are translated, child pages are referenced from owner
pages, and comments are included. However...
* Some pages will look very wrong because things like tables are not yet
translated. I also have to fine-tune the translation of links and combine the
logic for both markup types.
* Some child pages don't seem to be available, but this is a combination of
the question mark issue (see above) and probably my lack of page name quoting
when incorporating child page information.
* Comments are not well presented at the moment, and I aim to investigate a
few ways of improving their appearance.
For now, this will have to be all the work I am able to do on this project,
but I will resume my efforts again in January. I hope that everyone feels
reassured that this project is no longer forgotten. :-)
P.S. Some resources:
More information about the Mailman-Developers