VanguardReMaster/docs/translation-rules.md

# Правила перевода текстов карт

Версия 0.6 — терминология карт закрыта.
Правки в этом файле делаются только после подтверждения на реальных картах.

---

## 1. Что переводим

- Переводится **только текст эффекта** (`textRu`).
- **Имена карт не переводятся** — остаются английскими в обеих локалях.
- Имена карт внутри эффектов тоже остаются английскими, в кавычках:
  `карты с именем "Blaster Blade"`.
- Названия кланов — токен `{clan:...}`, переводится справочником, не в тексте.
- Названия зон — токены `{vc}`, `{rc}`, `{gc}`, `{hand}`, `{drop}`.

## 2. Жёсткие правила

1. **Токены не трогать.** `{auto}`, `{cb:2}`, `{vcrc}`, `{clan:kagero}` и прочие
   переносятся как есть, в том же количестве и в том же порядке.
2. **Числа не менять.** `+3000`, `-2000`, `{sb:8}`, `до трёх` — всё из источника.
3. **Количество строк совпадает с источником.** Одна способность — одна строка.
4. **Порядок способностей не меняется.**
5. **`&` в стоимости остаётся `&`.** Это разделитель, а не союз «и».
6. **Синонимы запрещены.** Если термин есть в таблице — используется только он.
   «Юнит», «отряд», «существо», «рейргард», «оседлать» в текстах не встречаются.

## 3. Термины

| Английский | Русский | Примечание |
|---|---|---|
| this unit | **эта карта** | карта — женского рода: «она», «выбранная карта» |
| a unit named X | **карта с именем X** | |
| the chosen unit | **выбранная карта** | |
| all of your units | **все ваши карты** | |
| vanguard | **Авангард** | с заглавной в любом месте предложения |
| rear-guard | **Арьергард** | с заглавной в любом месте предложения |
| boosted unit | **усиленная карта** | не «атакующий» |
| deck | колода | |
| hand | рука | |
| soul | душа | «в душу», «из души» |
| drop zone | зона сброса | |
| damage zone | зона урона | |
| guardian circle | круг Стража | токен `{gc}` |
| grade | **ранг** | «2-го ранга» |
| drive check | **проверка** | «в проверке оказывается» |
| power | сила | токен `{power}` |
| critical | критический | токен `{critical}` |
| clan | клан | |
| ride | **смена** | см. шаблоны ниже |
| call | призвать | «призвать её», а не «призвать эту карту» |
| retire | уничтожить | |
| boost | **поддерживать** | «эта карта поддерживает» |
| stand | встать | токен `{stand}` |
| rest | повернуть | токен `{rest}` |
| draw | взять | «возьмите карту» |
| discard | сбросить | |
| reveal | показать | |
| search | найти | «найдите в колоде» |
| shuffle | перемешать | |
| return to deck | вернуть в колоду | |
| put into | поместить в | |
| place on (VC/RC/GC) | **помещается в** | предлог «в», не «на» |
| attack hits | **атака проходит** | |
| close step | **завершающий шаг** | не «шаг завершения» |
| opponent | противник | «противника», «противнику» |
| choose | выбрать | |
| up to N | до N | «до одной карты» |
| or less / or greater | или ниже / или выше | про ранг |
| if you do | если вы это сделали | |
| Restraint | **Сдерживание** | переведённый ключевой термин |

### Фазы

| Английский | Русский | Статус |
|---|---|---|
| Stand Phase | **Фаза Подъёма** | подтверждено |
| Draw Phase | **Фаза Добора** | подтверждено |
| Ride Phase | **Фаза Смены** | подтверждено |
| Main Phase | **Основная фаза** | подтверждено |
| Battle Phase | **Боевая фаза** | подтверждено |
| End Phase | **Завершающая фаза** | подтверждено |

В текстах карт: «В начале вашей Основной фазы», «в начале Завершающей фазы
этого хода», «в следующую фазу Подъёма противника».

## 4. Синтаксические шаблоны

| Источник | Перевод |
|---|---|
| `When A, B` | `Когда A, B` |
| `If A, B` | `Если A, B` |
| `When this unit is placed on (RC)` | `Когда эта карта помещается в {rc}` |
| `When another <clan> rides this unit` | `Когда другой <клан> сменяет эту карту` |
| `ride this card` | `совершите смену на эту карту` |
| `ride it` | `совершите на неё смену` |
| `When this unit boosts` | `Когда эта карта поддерживает` |
| `When this unit is boosted by <clan>` | `Когда эту карту поддерживает <клан>` |
| `battle that this unit boosted` | `бою, в котором эта карта поддерживала` |
| `When this unit's attack hits` | `Когда атака этой карты проходит` |
| `When an attack hits` | `Когда атака проходит` |
| `When this unit's drive check reveals X` | `Когда в проверке оказывается X` |
| `put into the drop zone from (RC)` | `помещается в зону сброса из {rc}` |
| `you may pay the cost. If you do, X` | `вы можете оплатить стоимость. Если вы это сделали, X` |
| `At the beginning of your main phase` | `В начале вашей главной фазы` |
| `During your turn` | `В свой ход` |
| `until end of that battle` | `до конца этого боя` |
| `until end of turn` | `до конца хода` |
| `for each of your X` | `за каждый ваш X` |
| `if the number of cards in your hand is four or greater` | `если в вашей руке четыре или больше карт` |
| `opponent chooses a card from his or her hand, and discards it` | `противник выбирает карту из своей руки и сбрасывает её` |

## 5. Оформление

- Строчная буква после двоеточия: `{auto}:когда…`.
- «вы» — со строчной буквы, без заглавной.
- Точка в конце каждой способности.
- Запятая перед «и» по правилам русского языка, а не по английскому оригиналу.
- **Авангард** и **Арьергард** — всегда с заглавной, даже в середине предложения.
  Остальные термины — со строчной.
- Предлог направления: **из** зоны, а не «с». «С верха колоды» — исключение.
- Буква **ё** используется: «поражён», «четырёх», «всё».
- Длинный хвост через «, и …» разбивается на отдельное предложение:
  `…который подвергается атаке. Он не может быть поражён до конца этого боя.`
- Повтор «эта карта» в соседних фразах заменяется местоимением:
  «призвать **её**», «верните **её** в колоду».

## 6. Спорные места — нужно подтверждение

1. **Обращение к игроку** — «вы» или безличное «необходимо».

Подтверждено и вынесено из спорных: `retire` → «уничтожить», `boosted unit` →
«усиленная карта», буква «ё», все шесть фаз, `close step` → «завершающий шаг»,
`call` → «призвать», названия зон («Круг Авангарда» / «Круг Арьергарда»).

## 7. Как править

1. Правьте `textRu` в `content/translations/ru.yaml`.
2. Проверка: `dotnet run --project server/src/Vanguard.Cli -- translations check`.
3. Если изменили термин — обновите таблицу в этом файле.
4. Если термин стал токеном — добавьте его в `content/keywords.yaml`
   и в правила токенизации, затем пересоберите шаблоны командой
   `translations build` (существующие переводы сохранятся).

## 8. Что будет дальше

Проверка `translations check` уже ловит нарушения стиля: запрещённые термины
(`юнит`, `размещается на`, `райд`, `попадает`, `драйвек`, `усиливает`, `HEAL`,
`Restraint`, `рир-гард`, `вэнгард`, `грейд`, `поражен`) и расхождения по токенам.

Дальше по вашим правкам:
1. Сравниваю вашу версию с текущей и выписываю расхождения по категориям.
2. Обновляю таблицы терминов и шаблонов.
3. Добавляю в проверку новые автоматизируемые правила.

## 9. Журнал правок

| Версия | Что изменилось |
|---|---|
| 0.6 | `close step` → «завершающий шаг», `call` → «призвать», названия зон подтверждены. Заменено в текстах, добавлена проверка на «шаг завершения». |
| 0.5 | Все шесть фаз: Подъёма, Добора, Смены, Основная, Боевая, Завершающая. Обновлены тексты карт и проверка на старые формулировки. |
| 0.4 | Подтверждено: `retire` → «уничтожить», `boosted unit` → «усиленная карта», буква «ё» разрешена («поражён», «четырёх»). Заменено во всех текстах. |
| 0.3 | `unit` → **карта** (и «эта карта», «выбранная карта», «все ваши карты»); `place on` → «помещается **в**»; `ride` → **смена**; `boost` → **поддерживать**, `boosted unit` → «атакующий»; `attack hits` → «атака проходит»; `drive check` → «проверка»; `Restraint` → «Сдерживание»; `{heal} HEAL` → `{heal}`; длинные хвосты через «, и» разбиваются на предложения; «призвать эту карту» → «призвать её». Применено ко всем 66 текстам. |
| 0.2 | `vanguard` → Авангард, `rear-guard` → Арьергард (с заглавной), `grade` → ранг, `from (RC/GC)` → «из». |
| 0.1 | Первый проход по 66 текстам, терминология-черновик. |