Languages

Using our translator tool

We've developed a tool which will make it easy to create translations straight from the web. A developer account is required (sign-up at http://developer.mindtouch.com/) in order to use this tool. It is available at: 

http://translate.developer.mindtouch.com/

Manually translating from MindTouch source

For those who mock GUIs and want to do manual translations.

Multiple localizations can exist side-by-side.  The active language is selected through Site Settings in the Control Panel.  To add another localized resources.txt file:

• Create a new text document with a name of the form resources.xxxx.txt, where xxxx is <languagecode2>-<country/regioncode2>.  For example, use resources.en-us.txt to contain the resources for English US, resources.en.txt to contain for all English localizations. See table below for language codes.
• Alternatively, download and rename the English translation to use as a starting point for translation: download English resources.txt
• Use resources.custom.txt as a custom resources file. 
• Resources are determined by first checking in custom resources, then in region specific resources (e.g. resources.en-us.txt), then in language specific resources (e.g. resources.en.txt), and finally the neutral resources file (i.e. resources.txt) 
• Place one resource per line in the form name=value with no spaces before or after the equal sign (=).
  IMPORTANT: make sure all values are terminated with a newline character, including the last line!
• Use $1, $2, etc to specify string parameters.
• Use ';' to include comments.
• To test your translation, put the file in the /resources/ folder of your wiki and then select it from the Site Settings language menu.