VanguardReMaster/docs/translation-rules.md

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

Версия 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. Добавлю в проверку новые правила, которые можно автоматизировать (например, запрет «Вы» с заглавной, обязательный «если вы это сделали»).