# HG changeset patch # User Paul Boddie # Date 1407683109 -7200 # Node ID 8608b8370a2a5f99c8972e3cac939168fc1d9079 # Parent 1b0783ee86731d34f65b0b1f91163ecad1e7d1f0 Added notes about how namespaces are actually exported from Confluence. diff -r 1b0783ee8673 -r 8608b8370a2a README.txt --- a/README.txt Sun Nov 03 22:33:56 2013 +0100 +++ b/README.txt Sun Aug 10 17:05:09 2014 +0200 @@ -116,6 +116,18 @@ Quick Start ----------- +To obtain XML export archives from a Confluence wiki instance, the +exportspacexml.action resource is visited and the "Export" button selected. +For example, for the Mailman Wiki, the appropriate resource (with the COM +namespace selected) is as follows: + +http://wiki.list.org/spaces/exportspacexml.action?key=COM + +For your own instance, adjust the above URL accordingly. Alternatively, you +can find your way to the export page by selecting a namespace, then choosing +"Advanced" from the "Browse" menu, and then choosing "XML Export" from the +"Export" sidebar. + Given an XML export archive file for a Confluence wiki instance (in the example below, the file is called COM-123456-789012.zip), the following command can be used to prepare a page package for MoinMoin: @@ -133,14 +145,15 @@ contents. Thus, the above command would produce a directory called COM and an archive called COM.zip. -To import the result, use moinsetup as follows: +To import the result (although you may wish to process other namespaces +first), use moinsetup as follows: python moinsetup.py -m install_page_package COM.zip This requires a suitable moinsetup.cfg file in the working directory. -Importing Many Workspaces -------------------------- +Importing Many Workspaces/Namespaces +------------------------------------ Where more than one namespace is to be imported, the page packages should be merged so that the resulting history information is ordered correctly.