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

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

---

## 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. **`Restraint`, `Sentinel`, `Twin Drive!!`** — ключевые слова. `Sentinel` и
   `Twin Drive!!` уже вынесены в токены, `Restraint` пока остаётся английским.

## 3. Термины

| Английский | Русский | Примечание |
|---|---|---|
| unit | юнит | не «отряд», не «существо»; со строчной |
| vanguard | **Авангард** | с заглавной, в любом месте предложения |
| rear-guard | **Арьергард** | с заглавной, в любом месте предложения |
| 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 | разместить на | |
| attack hits | атака попадает | |
| opponent | противник | «противника», «противнику» |
| choose | выбрать | |
| up to N | до N | «до одной карты» |
| or less / or greater | или ниже / или выше | про грейд |
| if you do | если вы это сделали | |

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

| Источник | Перевод |
|---|---|
| `When A, B` | `Когда A, B` |
| `If A, B` | `Если A, B` |
| `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}:когда…`.
- «вы» — со строчной буквы, без заглавной.
- Точка в конце каждой способности.
- Запятая перед «и» по правилам русского языка, а не по английскому оригиналу.
- Тире и дефисы: `-2000` — минус без пробела, как в источнике.
- **Авангард** и **Арьергард** — всегда с заглавной, даже в середине предложения.
  Остальные термины (юнит, колода, рука, душа, зона сброса) — со строчной.
- Предлог направления: **из** зоны, а не «с». «С верха колоды» — исключение,
  там речь о положении, а не о выходе из зоны.

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

Это места, где я выбрал вариант, но он не единственный:

1. **`stand phase`** → «фаза стойки». Альтернатива: «фаза восстановления».
2. **`close step`** → «шаг завершения». Альтернатива: «шаг закрытия».
3. **`end phase`** → «конечная фаза». Альтернатива: «фаза завершения».
4. **`ride`** → «совершить райд». Альтернатива: «оседлать».
5. **`retire`** → «уничтожить». Альтернатива: «отправить в зону сброса».
6. **`call`** → «призвать». Альтернатива: «вызвать».
7. **`Restraint`** — оставить английским или перевести как «Ограничение».
8. **`HEAL`** в напоминании про лимит — оставить капсом или писать «лечение».
9. **Обращение к игроку** — «вы» или безличное «необходимо».
10. **Названия зон в подсказках** — «Круг Авангарда» / «Круг Арьергарда»
    уже обновлены под новую терминологию; подтвердить, что так и надо.

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

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

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

После ваших правок:
1. Сравню свою версию с вашей и выпишу расхождения по категориям
   (термины, порядок слов, пунктуация, идиомы).
2. Обновлю таблицы терминов и шаблонов.
3. Добавлю в проверку новые правила, которые можно автоматизировать
   (например, запрет «Вы» с заглавной, обязательный «если вы это сделали»).

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

| Версия | Что изменилось |
|---|---|
| 0.2 | По правкам заказчика: `vanguard` → **Авангард**, `rear-guard` → **Арьергард** (с заглавной), `grade` → **ранг**, `drive check reveals` → «в драйвеке оказывается», `from (RC/GC)` → «из», а не «с». Применено ко всем 66 текстам. |
| 0.1 | Первый проход по 66 текстам, терминология-черновик. |