Перевод — отдельный пакет той же формы, что оригинал: те же страницы, те же имена разделов, те же примеры по ссылке, на другом языке. Эта страница создаёт такой пакет и объясняет, что делает его официальным.
Агент копирует дерево страниц источника и переводит прозу каждого блока на месте, не добавляя и не удаляя блоков. Каждый `example` он заменяет на `example ref="<id>"`, указывающий на пример источника. Он задаёт язык пакета, называет источник в `[translates]` и тот же [предмет](../glossary/index.xml#subject) в `[[documents]]`. `vibe doc check --translations` затем сравнивает два дерева: те же пути, те же [якоря](../glossary/index.xml#anchor), то же число и виды блоков; отличие — ошибка. Сайт, видя ребро `translates` от пакета в группе источника с именем `<source>-ru`, показывает перевод как официальный и предлагает его в переключателе языков.
Язык пакета — существующее поле `[i18n] canonical`, тег BCP-47 в нижнем регистре; отдельного поля языка нет. `[translates]` называет источник и диапазон версий; `[[documents]]` повторяет предмет источника, и vibe проверяет, что они согласуются.
Имя `<source>-<lang>` в группе источника — то, что делает перевод официальным по умолчанию. Перевод из другой группы находится и показывается как перевод сообщества, с его издателем.
Имя перевода по умолчанию — имя документации с тегом языка в нижнем регистре, `vibevm-docs-ru` или `vibevm-docs-pt-br`, в той же группе.
Перевод следует источнику блок за блоком, а не предложение за предложением: внутри блока переводчик пишет то, что написал бы редактор-носитель, заменяет шутку той, что работает на его языке, или убирает её и следует глоссарию перевода. Он никогда не сочиняет примеры: вывод примера проверяется один раз, на источнике, а перевод на него указывает. Он никогда не добавляет якорь, потому что ссылка в источник должна попадать на тот же блок на каждом языке; благодаря этому же читатель переключает язык, не теряя места.
Правила, процитированные из [спецификации](../glossary/index.xml#specification), остаются на языке спецификации и помечены как таковые; перевод нормативного текста не входит в перевод документации.
Перевод не записывает ни ревизию, ни хеш источника. Когда источник меняется, структурная проверка проходит, пока совпадает форма, а отстал ли смысл перевода, решает человек: на это отвечают при периодической сверке, и ответ показывается на странице как дата, когда её читали в последний раз. Страницу, у которой перевода ещё нет, сайт показывает на языке источника по адресу перевода, с пометкой, и никогда как отсутствующую.
Файлы-спутники внутри исходного пакета, `README.ru.md` рядом с `README.md`, — так переводы носят спецификации; документация ими не пользуется, потому что у перевода руководства свой автор и свой ритм.
Перевод наследует изображения источника, если не объявляет собственных.