Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Document how to use native2ascii

...

  • Check out the source code for the plugin you want to add a translation for.
  • Find the resource bundles that needs to be translated. They are often found in the src/main/resources folder.
  • Copy the basefile for the bundle, i.e. the one without a language extension. The copy should have the same name as the original file, except for the addition of a language extension. If, for example, you want to translate the Changes Plugin into Spanish, you would copy src/main/resources/scm-activity.properties to src/main/resources/scm-activity_es.properties.
  • Edit the new file and translate all the properties.
  • Convert the new file so that all non-US-ASCII characters are transformed into Unicode escapes, see below for tools that can help with this.
  • Create an issue in JIRA for the plugin in question, with a description like: "Add Spanish translation". Take note of the issue number.
  • Create a patch file that contains your new translation. svn diff > MYISSUE-123.patch

Tools

There is a command line tool called native2ascii that can be used to convert a text file to use Unicode escapes instead of accented characters. You use it like this:
native2ascii scm-activity_es.properties > scm-activity_es-escaped.properties
On unix-like systems this should be ready for you to use. On Windows you need to download and install it.