Original page files
It should be noted that the TWiki converter does not convert page history and doesn't deal with RCS files (how TWiki stores page history). Rather you should only convert the current version of the TWiki pages which are represented as text files.
Attachments
You should point your 'attachments dir' at the TWiki pub dir which is part of the TWiki standard install.
So it should looke something like this:
Also the UWC depends on the TWiki directory structure for finding attachments. So if you're copying files around the attachments need to be in the same relative location as they are to the files when they reside in TWiki.
Status
In it's current state this converter will work pretty darn well EXCEPT it doesn't handle multiple TWiki webs at present.
Here is a potentially helpful thread discussion with Eric Sorenson who has converted multiple TWiki webs to Confluence
> > Initially when the TWiki converter was written only the single TWiki
> > default 'web' was being converted. So I'm not entirely aware of the
> > nuances involved when converting a TWiki server with multiple 'webs'.
> >
> > Though not perfect (because you have to run a separate conversion for
> > each Confluence space) I believe you can choose to either convert all
> > of your webs to a single Confluence space or multiple spaces or
> > whatever combination you choose. I think things ARE flexible in that
> > way.
Right, you could do this by doing a run for each target confluence
space. You can mix source files from different twiki spaces on the same
conversion run, but there's only support for one destination space at a
time.
> > Eric, since you've got as much experience using the TWiki converter as
> > anyone would you mind commenting with some more detail about how to
> > best use the UWC with multiple TWiki webs? What are the caveats?
> > Other learning from your experience?
> >
> > Could you also talk about how the UWC could be improved to better
> > handle multiple TWiki webs?
I assume our site is pretty typical in that people generally want to
mirror the organisation of their old TWiki into Confluence, so I don't
think the '1 web:1 space' is terribly onerous. One thing I found to be
helpful was to make a temporary target space (in addition to the real
destination space), and convert into that, do some sanity checking and
turn things over to the space owner if it looks copacetic.
The space owner then moves the pages into their final resting place, so
page hierarchy gets created properly and they don't start straight off
cluttering up their new space with crufty pages that nobody cares about.
This worked pretty well for two medium-size projects (~100 pages) but
might not scale much beyond that.
Really the biggest problems I'm having right now with converting my last
few Twiki holdouts are that they have gotten used to some "lazy" things that
TWiki lets you get away with and confluence does not. Specifically:
- there are four or five ways Twiki does link syntax and not all of them
are handled right (UWC-35 on d.a.c) - people got used to mixing freeform HTML in with their wiki syntax,
which doesnt work in confluence, e.g.
[[Fullsize-Linktarget.png][<img src="thumbnail.png">]] - Table formatting in Confluence is really poor compared to Twiki, so
power-table-users have to go to the
macro from Adaptivist; its
understandable that these are not converted by UWC but it can make a lot
of annoying work for page authors.
I had to write a couple of scripts to parse TWikiUsers.txt and replace all
of the "-- Main.WikiName" signatures with links to their confluence
profile/personal space as there's no generic way to convert these; I can
upload them somewhere if there's interest but it relies upon external
auth w/ consistent usernames between your twiki and confluence so the
appeal may be limited.
> > I'll incorporate your comments into the documentation crediting you of
> > course 
> >
> > Thanks a bunch!
OK, well, hope that helps somebody - and please don't take it as
criticism of the fine work you've done on UWC! There are just a lot
of tough corner case nuts to crack.
-=Eric