Локализация
Источник истины
Русские файлы являются нормативным оригиналом. Переводы не вводят новые правила и не исправляют смысл независимо от русского текста. Сначала меняется оригинал, затем все поддерживаемые локали.
Инварианты
- структура каталогов и имена Markdown-файлов совпадают;
- идентификаторы документов и явные anchors не переводятся;
- относительные ссылки указывают на те же логические документы;
- кодовые идентификаторы примеров сохраняются;
- текст Mermaid-схем переводится, структура узлов и рёбер совпадает;
- названия типов переводятся в соответствии с каталогом объектов.
Добавление языка
- Добавить локаль в конфигурацию Docusaurus.
- Сгенерировать служебные строки
write-translations. - Скопировать дерево каждой поддерживаемой версии в каталог локали.
- Перевести Markdown, главную страницу и интерфейсные строки.
- Проверить паритет файлов, ссылки, схемы и поиск промышленной сборкой.
Неполная локаль не публикуется как поддерживаемая: отсутствие перевода не должно незаметно подменяться русским текстом.