VanguardReMaster/docs/translation-rules.md

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

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

---

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	атака проходит
opponent	противник	«противника», «противнику»
choose	выбрать
up to N	до N	«до одной карты»
or less / or greater	или ниже / или выше	про ранг
if you do	если вы это сделали
Restraint	Сдерживание	переведённый ключевой термин

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. stand phase → «фаза стойки». Альтернатива: «фаза восстановления».
2. close step → «шаг завершения». Альтернатива: «шаг закрытия».
3. end phase → «конечная фаза». Альтернатива: «фаза завершения».
4. retire → «уничтожить». Альтернатива: «отправить в зону сброса».
5. call → «призвать». Альтернатива: «вызвать».
6. Буква «ё»: вы пишете «поражен», но оставляете «четырёх». Зафиксировать единый вариант или оставить как есть?
7. boosted unit → «атакующий». Альтернатива: «усиленная карта».
8. Обращение к игроку — «вы» или безличное «необходимо».
9. Названия зон в подсказках — «Круг Авангарда» / «Круг Арьергарда»; подтвердить, что так и надо.

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.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 текстам, терминология-черновик.