Переводы

DispatchAtlas обслуживает свою документацию в когорте из двенадцати локалей. Английский — источник; каждая другая локаль — цель перевода. Эта страница заявляет, что переведено сегодня, дисциплину, управляющую качеством перевода, и шаги для внесения перевода.

Когорта локалей

Сайт регистрирует двенадцать локалей — английский в корне сайта и одиннадцать префиксированных целей перевода:

Каждая страница объявляет свой lang, арабский дополнительно рендерится справа-налево, и симметричный набор hreflang плюс x-default, указывающий на английскую страницу, связывают когорту для поисковых систем. Локаль, ещё не переведшая данную страницу, опускает запись hreflang этой страницы вместо указания её на английский, так что отсутствие сообщается точно.

Текущее покрытие

Хром интерфейса — навигация, элементы управления, поиск, и подвал — переведён по всем двенадцати локалям. Страницы документации переводятся инкрементально; страница без перевода в запрошенной локали рендерит английский источник как запасной вариант, так что ни один маршрут никогда не ломается. Покрытие растёт страница-за-страницей под конвейером проверки ниже; переключатель языка всегда достигает каждой страницы по крайней мере в её английской форме.

Конвейер машинного-зерна плюс человеческой-проверки

Качество перевода — критерий выпуска, а не запоздалая мысль. Два этапа управляют каждой переведённой страницей:

1. Машинное зерно. Страница сначала набрасывается машинным переводом против глоссария по-локали, который фиксирует доменную лексику (планирование, dispatch, бенчмарк, решатель, цель, ограничение) на один согласованный термин на локаль.
2. Человеческая проверка. Носитель-языка-проверяющий исправляет зерно на беглость, терминологию, и тон до его отгрузки. Копия с машинным-зерном никогда не публикуется как окончательный непроверенный текст.

Страница готова-к-выпуску в локали только после того, как проверяющий её засвидетельствовал. До тех пор стоит английский запасной вариант, который точен и полон, а не частично-переведён.

Внесение перевода

1. Выберите страницу под site/content/docs/en/ и целевую локаль.
2. Создайте зеркальный путь под site/content/docs/<locale>/ с тем же относительным slug и теми же ключами frontmatter (title, description).
3. Переведите тело, чествуя глоссарий локали, чтобы доменные термины оставались согласованными с остальной частью этой локали.
4. Держите каждый блок кода, команду, идентификатор, цель ссылки, и ссылку на фигуру идентичными источнику — переводится только естественно-языковая проза.
5. Откройте вклад для проверки носителем-языка. После засвидетельствования страница отгружается в этой локали, и её запись hreflang добавляется в когорту.

См. Руководство по вкладу для рабочего процесса репозитория и процесса проверки, который применяется к каждому изменению.