Синтаксис повідомлень ICU

Crowdin supports ICU Message syntax, which is used to help express the subtleties of language-specific spelling, grammar, and formatting in translations.

Strings formatted in the ICU Message syntax can have different types of replacements called arguments. Кожен аргумент укладений у фігурні дужки і відноситься до значення у вхідних даних. У Crowdin підтримуються наступні типи аргументів: number, date, time, select і plural.

ICU Message Syntax in the Editor

Аргументи синтаксису ICU завжди виділяються в редакторі, тому перекладач відразу бачить, яку частину пропозиції не треба перекладати. При цьому можна змінювати місце аргументу в реченні; це допоможе зберегти природний порядок слів у перекладі на цільовій мові. Також доступний режим перегляду, який дозволяє побачити кінцевий варіант відображення перекладів в інтерфейсі; це дозволить точно перевірити, що всі перекладні елементи перекладені.

Синтаксис повідомлень ICU в редакторі

Аргумент множини

Plural type is used to handle plural category variations, as each language has its own set of plural categories (for example, English has “one” and “other”, while Ukrainian has “one”, “few”, “many”, and “other”).

Категорії множини визначаються за допомогою наступних коротких тегів:

  • нуль
  • one (однина)
  • two (подвійне число)
  • few (кілька)
  • many (також використовується для часток і дрібних чисел, якщо вони виділяються в окремий клас)
  • other (загальна форма множини, цей аргумент обов’язково повинен бути присутнім в синтаксисі рядка, навіть якщо в мові використовується тільки форма однини)

In the Editor, you don’t have to manually add or delete plural categories to the translations you are making. Just click Copy Source, and the source string will be copied to the translation field with the number of plural categories right for the current target language.

Read more about Language Plural Rules.

Plural type

Select Ordinal

The purpose of the select ordinal type is to choose output based on the ordinal pluralization rules (1st, 2nd, 3rd, etc.) of the current target language. It is very similar to the plural type, except the value is mapped to an ordinal plural category.

Select Ordinal type

Аргумент вибору

Select type is mostly used to represent the right gender-based inflections in the message.

Select type

Аргумент числа

The purpose of the number type is to display different number values such as percentage, currency, and decimal numbers independently from the locale conventions for those. This enables adjustment of the message output to the number formats used in different locales. ICU Number Skeletons are also supported.

Number type

Аргумент дати і часу

Date and time types show date and time values according to the formats preferred in the specified locales. These types can also have a style – extra information on how the value will be formatted. The following four styles can be used: short, medium, long, and full.

Date, Time types

Синтаксичні помилки

Syntax error detection significantly reduces confusion when translating strings with ICU Message syntax, as the platform automatically detects potential translation errors. If a syntax error is found, you’ll see a notice with a suggestion of what needs to be fixed.

Syntax error detected

Дивись також

Ця стаття була корисною?