Twiki Importer

Added by marvin greenberg, last edited by Jonathan Nolen on Sep 27, 2006  (view change)

Converts a Twiki web to a Confluence Space

Out of date, please use the Universal Wiki Converter instead.

This reads a TWiki site starting at some arbitrary page (typically a TWiki space home page, not the top level TWiki directory (which has no "real" content). It then extracts all TWiki camelcase (and explicit [[My Concept]]) content references from the starting page and loads those, too, etc...

Edit the script, give it a username/pass for access to your twiki and for confluence. Point it at a space/concept to start
like MySpace/WebHome.

Then it transforms the pages into Confluence syntax, and uses the XML-RPC api to create the pages.

This is not intended to be perfect. Most significantly and annoyingly, it does nothing with attachments. There is no xmlrpc interface for attachments.

It doesn't do anything with %VARS% like TWIKI supports although it would be simple enough to map them to user macros you could create. It doesn't do anything when it finds twiki %SEARCH% or similar, so if the only link you have to a page is through a %SEARCH% or %INCLUDE% it won't show up. Etc.

But it will get more content from TWiki into Confluence than a design meeting for an exporter, or the current capability provided by Atlassian (no criticism guys , just noting)

  Name Size Creator (Last Modifier) Creation Date Last Mod Date Comment  
Text File twikiToConfluence.py 16 kB David Roche Sep 22, 2005 Sep 22, 2005 Updated regex's to support more TWiki format (worked out most bugs for my import). Also catch exception during TWiki page connect so the script doesn't bomb if the page doesn't exist (happens if the script mistakes certain strings for a TWiki link).

Labels

contentconverter contentconverter Delete
wikiconverter wikiconverter Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.

Comments (4)

 

  1. Jul 11, 2005

    Daniel Ostermeier says:

    A quick note that will be of interest, we are looking to include adding attachme...

    A quick note that will be of interest, we are looking to include adding attachments to the Remote API in the next release or 2, depending upon scheduling.

  2. Jul 12, 2005

    marvin greenberg says:

    Cool. This may be done for my purposes... It gets the bulk of our content over, ...

    Cool. This may be done for my purposes... It gets the bulk of our content over, I may tweak some regex's to clean up the pages a bit and fix some other bugs. But it may serve as a useful starting point for others migrating from TWiki.

  3. Jan 31, 2006

    Ross Hayward says:

    Is there a way to set "Lables" for a page you are sending via RPC?  I want ...

    Is there a way to set "Lables" for a page you are sending via RPC?  I want to send various reports from multiple systems and lable them to make lable searching easy.  I do not want an admin to have to go in and lable them after the fact.

    1. Feb 02, 2006

      Jeremy Higgs says:

      Hi Ross, If you look at the Remote API Specification DOC:Remote API Specificati...

      Hi Ross,

      If you look at the Remote API Specification, there is a addLabelByName method, which should allow you to do what you want.

      Jeremy