WoodWing Help Center

Translating the Elvis 4 client applications

 

Translating the Elvis 4 client applications

Most texts in the client interface can be translated or customized into different languages or with other words, including menu items, context menus and buttons.

Download the Microsoft Excel sheet with messages for the latest version from the following link:

messages_5.21.xlsx (March 2017, 210KB)

To translate the Elvis client into your own language or change the current translations:

  • Use the Excel file to translate messages to your own language or change existing translations
  • E-mail your new .xlsx file to WoodWing: support@woodwing.com
  • In the e-mail, please let us know which language you have added or modified, so we know which files to send to you.
  • We will e-mail you your translation as soon as possible

Keep the following in mind:

  • Make sure to keep an eye on the client and the way certain words and terms are used
  • Do not remove any trailing spaces or special characters ( like : or , )
  • Do not add spaces or special characters at the end of a line ( including . or ; )
  • The characters \n are used to add a line break in a message
  • The numbers inside curly brackets ( {0} ) are replaced by live data from the server, for example check out counts.

Notes:

  • When opening the messages in Excel not all characters may be supported. Try different kinds of fonts if there is any problem with rendering characters. For example the font for Chinese is set to 'Arial Unicode MS'.
  • While translating messages keep in mind that certain words in certain locations can have a variety of meanings, and that some messages are part of a sentence. Review the new translation before putting them on a production server.

After you send us a new language or updated messages, we will create three files and e-mail them back to you. To use the new messages in the client, put the files in the Config/messages/ folder.

If you want to add a completely new and officially unsupported language, after adding the file to the Config/messages/ folder, add the following line to your server configuration and add your language:

supportedLocales=en_US, fr_FR, de_DE, nl_NL, it_IT, pl_PL, ru_RU

Custom e-mail message

You can customize any messages by placing a acm_languagecode_COUNTRYCODE.properties file in the Config/messages/ folder. A sample to customize English messages is already there.

To replace the default e-mail message when e-mailing links to assets, you can add the following keys in your own custom messages.

email.Share.email_subject=Elvis link: {0}

email.Share.email_body.part1.description=Description: {0}\n\n

email.Share.email_body.part2.links_normal=Open the following URL in your web browser to view files in Elvis. This link will remain valid until {0} ({1}):\n\n{2}\n\nIf you have a user account and have the Elvis desktop client installed on your machine, click the following link:\n\n{3}

email.Share.email_body.part2.links_upload=Open the following URL in your web browser to view files in Elvis and to upload new ones. This link will remain valid until {0} ({1}):\n\n{2}\n\nIf you have a user account and the Elvis client is installed in your machine, click the following link:\n\n{3}

email.Share.email_body.part2.links_approval=Open the following URL in your web browser to view the files in Elvis to add your approval or rejection. This link will remain valid until {0} ({1}):\n\n{2}\n\nIf you have a user account and the Elvis client is installed in your machine, click the following link:\n\n{3}

Custom date and number formatting

There are a few special fields in the translation file to deal with several localization options, to deal with special formatting in different countries and languages.

  • Date formatter: fields to change the way dates are displayed in the metadata panel in the local format.
  • Number formatter: to make sure numbers are displayed in the right format.

To modify the formatting of dates and times as displayed in the metadata, you can add the following keys to your custom messages and modify them to your needs:

dateFormatter.formatString=EEE D MMMM YYYY

datetimeFormatter.formatString=EEE D MMMM YYYY J\:NN\:SS

timeFormatter.formatString=J\:NN\:SS

You compose a pattern string using specific uppercase letters, for example: YYYY/MM. The pattern can contain other text in addition to pattern letters. The following table from Adobe's documentation shows you the different possibilities.

Pattern letter Description
Y

Year. If the number of pattern letters is two, the year is truncated to two digits; otherwise, it appears as four digits. The year can be zero-padded, as the third example shows in the following set of examples:

  • YY = 05
  • YYYY = 2005
  • YYYYY = 02005
M

Month in year. The format depends on the following criteria:

  • If the number of pattern letters is one, the format is interpreted as numeric in one or two digits.
  • If the number of pattern letters is two, the format is interpreted as numeric in two digits.
  • If the number of pattern letters is three, the format is interpreted as short text.
  • If the number of pattern letters is four, the format is interpreted as full text.

Examples:

  • M = 7
  • MM= 07
  • MMM=Jul
  • MMMM= July
D

Day in month. While a single-letter pattern string for day is valid, you typically use a two-letter pattern string.

Examples:

  • D=4
  • DD=04
  • DD=10
E

Day in week. The format depends on the following criteria:

If the number of pattern letters is one, the format is interpreted as numeric in one or two digits.

If the number of pattern letters is two, the format is interpreted as numeric in two digits.

If the number of pattern letters is three, the format is interpreted as short text.

If the number of pattern letters is four, the format is interpreted as full text.

Examples:

  • E = 1
  • EE = 01
  • EEE = Mon
  • EEEE = Monday
A am/pm indicator.
J Hour in day (0-23).
H Hour in day (1-24).
K Hour in am/pm (0-11).
L Hour in am/pm (1-12).
N

Minute in hour.

Examples:

  • N = 3
  • NN = 03
S

Second in minute.

Example:

  • SS = 30
Q

Millisecond in seconds

Example:

QQ = 78

QQQ = 078

Other text

You can add other text into the pattern string to further format the string. You can use punctuation, numbers, and all lowercase letters. You should avoid uppercase letters because they may be interpreted as pattern letters.

Example:

  • EEEE, MMM. D, YYYY at L:NN:QQQ A = Tuesday, Sept. 8, 2005 at 1:26:012 PM

To modify the formatting of numbers as displayed in the metadata, you can add the following keys to your custom messages and modify them to your needs:

decimalFormatter.decimalSeparator=,

decimalFormatter.useThousandsSeparator=false

decimalFormatter.thousandsSeparator=.

Document history

  • 9 March 2017: added the message file for Elvis 5.21.
Was this article helpful?
0 out of 0 found this helpful / Created: / Updated:
Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.