Fluent & Localization

​

Базовый обзор

​

Практические примеры

​

Пример 1 (Простое сообщение):

comp-stack-already-full = Stack is already full.

Loc.GetString("comp-stack-already-full")

​

Пример 2 (Сообщение с переменными):

traitor-user-was-a-traitor = {$user} was a traitor.

var text = "Bob" + Loc.GetString("traitor-user-was-a-traitor");

Loc.GetString("traitor-user-was-a-traitor", ("user", traitor.Mind.Session.Name));

Loc.GetString("traitor-user-was-a-traitor", ("user", "Bob"));

​

Пример 3 (Множественное число, род и другие языковые проблемы)

humanoid-character-profile-summary = 
    This is {$ent}. {GENDER($ent) ->
    [male] He is
    [female] She is
    *[other] They are
} {$age} years old. 

• Строковые переменные сопоставляются со строковыми ветвями [male], [female] и т.д.
• Числовые переменные сопоставляются с числами [1], [2] и т.д., а также специальными категориями [zero], [one], [two], [few], [many], которые представляют ‘категорию множественности CLDR’ для числа.
  • Это используется для обработки множественного числа:
    • 1 minute, 2+ minutes (английское множественное число)
    • 1 минута, 2-4 минуты и 5+ минут (чешское множественное число)

​

Пример 4 (Fluent Functions)

humanoid-character-profile-summary = This is {$ent}. {SUBJECT($ent)} {CONJUGATE-BE($ent)} {$age} years old.

Краткий обзор функций

hugging-success-generic = You hug {THE($target)}.
hugging-success-generic-others = { CAPITALIZE(THE($user)) } hugs {THE($target)}.

• SUBJECT($ent) — he, she, they, it
• OBJECT($ent) — him, her, them, it
• POSS-PRONOUN($ent) — his, hers, theirs, its
• POSS-ADJ($ent) — his, her, their, its
• REFLEXIVE($ent) — himself, herself, themselves, itself

• CONJUGATE-BE($ent) — (they) are, (he/she/it) is
• CONJUGATE-HAVE($ent) — (they) have, (he/she/it) has
• CONJUGATE-BASIC($ent, first, second) — (they) , (he/she/it) , например, CONJUGATE-BASIC($ent, "run", "runs") (they run, he/she/it runs)

# Examine text after when they're holding something (in-hand)
comp-hands-examine = { CAPITALIZE(THE(SUBJECT($user))) } { CONJUGATE-BE($user) } holding { INDEFINITE($item) } { $item }.

# Example output strings
Sarah Collins is holding a wrench.
The corgi is holding an apple.
The rats are holding a piece of cheese.

​

Локализация прототипов

- type: entity
  id: RedOxygenTank
  name: oxygen tank
  description: A tank of oxygen. This one is red.

  someYaml: some-message-id

- type: entity
  id: RedOxygenTank
  name: red-oxygen-tank-name
  description: red-oxygen-tank-desc

red-oxygen-tank-name = oxygen tank
red-oxygen-tank-desc = A tank of oxygen. This one is red.

​

Встречайте: Attributes

- type: entity
  id: RedOxygenTank

ent-RedOxygenTank = oxygen tank
  .desc = A tank of oxygen. This one is red.

​

Советы

• ОТСТУПЫ ПРОБЕЛАМИ, НЕ ТАБАМИ
  • Fluent воспринимает табы буквально, поэтому их нельзя использовать для отступов
• Чтобы начать строку сообщения с тега форматирования, такого как [bold], вам нужно экранировать открывающую квадратную скобку:
  my-formatted-message =
      {"["}bold]some bold text[/bold]
  
• Syntax Guide Fluent.
• Good Practices Fluent.
• Специфика SS14: мы рекомендуем добавлять префикс ко всем сообщениям, соответствующий контексту, в котором они используются. Это помогает сохранить уникальность messageId (требование) и также служит для создания “пространства имён” для сообщений. Например, сообщения, определённые для StackComponent, должны начинаться с comp-stack-
• Чтобы применить языковой пакет к игре, вам нужно отредактировать Shared/EntryPoint.cs.
• Мы рекомендуем искать Loc.GetString в коде, чтобы найти все переводимые тексты.