VanguardReMaster/docs/translation-rules.md

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

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

---

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

• Переводится только текст эффекта (textRu).
• Имена карт не переводятся — остаются английскими в обеих локалях. Поле nameRu при этом существует и заполняется английским названием: если позже решим переименовать карты, править будем его, а не структуру.
• Имена карт внутри эффектов тоже остаются английскими, в кавычках: карты с именем "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.7	Поле nameRu возвращено в файл переводов и заполнено английским именем. Имена по-прежнему не переводятся, но поле готово к переименованию.
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 текстам, терминология-черновик.