VanguardReMaster/docs/translation-rules.md

121 lines
7.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Правила перевода текстов карт
Версия 0.1 — черновик, выведенный из первого прохода по 66 текстам.
Правки в этом файле делаются только после подтверждения на реальных картах.
---
## 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-го грейда» |
| 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` |
| `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. **`rear-guard`** → «рир-гард». Альтернатива: «рейргард».
8. **`Restraint`** — оставить английским или перевести как «Ограничение».
9. **`HEAL`** в напоминании про лимит — оставить капсом или писать «лечение».
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. Добавлю в проверку новые правила, которые можно автоматизировать
(например, запрет «Вы» с заглавной, обязательный «если вы это сделали»).