While I try to convert a twiki into Confluence (on Linux Redhat) using UWC (version 3.12), I'm facing the issue that UWC is not handling foreign characters correctly, e.g. German Umlaute, French accents and such.

The twiki file has its special characters encoded to iso88591, and I have set the $LANG of the Linux shell environment to en_US.iso88591 accordingly.

The local shell tools (like vi) display the special characters correctly.

The UWC output, though, (both, the local output files as well as the uploaded files in Confluence) show these special characters unreadable. (even in vi)

(I have also attempted to set it to de_DE.iso88591 without getting any change in results)

How to make uwc to consider the language-specific characters? Is there anything I can do by exporting the appropritate environment variable (or similiar), or is UWC simply not supporting these characters?

2 answers

1 accepted

This widget could not be displayed.

The UWC is definitely capable of handling ISO-8859-1. I've tested it against the common encodings that don't overlap nicely with UTF-8, including ISO-8859-1, ISO-8859-15and Cp1252. To start, you should make certain you have set the encoding property in your converter.twiki.properties file. Here's some doc on that:

UWC Character Encoding Feature

That will probably handle the problem, but here are some other ideas, if the above is insufficient:

  • check your confluence encoding setting in your admin console, also your confluence database settings
  • you can also use a tool like iconv to transform the encoding of your pages into UTF-8 before using the UWC on them. Some examples on that idea can be found in the UWC FAQ on encoding

Good luck!


Thank you! I got it to work.

This widget could not be displayed.

Hi Laura,

I tried to convert a SharePoint wiki and have the same "german umlaut problem". But entering Sharepoint.1234.encoding.property=iso-8859-1 at the end of the file converter.sharepoint.properties doesn't work. Even Sharepoint.1234-encoding.property=iso-8859-1 is not working.

Any other idea? I am working with version 3.13.0

Best regards,


Suggest an answer

Log in or Sign up to answer
Atlassian Summit 2018

Meet the community IRL

Atlassian Summit is an excellent opportunity for in-person support, training, and networking.

Learn more
Community showcase
Posted Wednesday in Teamwork

What teamwork quotes inspire you?

Hey everyone! My name is Natalie and I'm an editor of the Atlassian Blog and I've got a question for you: What's your favorite quote about teamwork?  We've compiled a list here, along with...

140 views 16 7
Join discussion

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you