[ English | 한국어 (대한민국) | Indonesia | русский | 中文 (简体, 中国) | Deutsch | English (United Kingdom) | 日本語 ]

Инфраструктура инструментов для перевода

В инфраструктуре OpenStack работают несколько заданий, которые управляют изменениями переводов в Zanata. Без этих заданий изменения в переводах не попадали бы в проекты OpenStack. На этой странице вы найдёте информацию о том, как задания, работающие в инфраструктуре OpenStack, запускают скрипты задач Zuul, и как отслеживать их статус.

Задания, относящиеся к переводам

У нас работают два задания в Zuul для переводов: синхронизация строк из исходных кодов с последних версий репозиториев в Zanata, и экспорт переводов из Zanata обратно в репозитории. Первое задание - для обновлений данных в Zanata. Подлежащие переводу обновлённые строки из исходных кодов сравниваются и обновляются между репозиторием проекта OpenStack и Zanata. Если тексты в исходных кодах в репозитории проекта OpenStack изменились, то эти изменения отправляются в Zanata. Таким образом переводчики всегда работают с самыми свежими строками текста для перевода. С другой стороны, второе задание занимается тем, что отражает изменения текстов в готовых переводах из Zanata в соответствующие репозитории проектов OpenStack. Это задание создаёт запросы на изменения в виде патчей Gerrit, как описано в разделе, описывающем импорт переводов.

Задания по обновлению Zanata стартуют сразу после того, как патчи сливаются в репозитории проектов OpenStack; Zuul запускает задачи по обновлению репозиториев OpenStack ежедневно в 6:00 UTC.

Обратите внимание, что не любые изменения обрабатываются заданиями, относящимися к переводам. Нашей целью является наличие цельных переводов программ, пользовательского интерфейса и документации. В наличии перевода нескольких строк нет большого смысла. Команда решила, что только файлы переводов, покрывающие как минимум 75% сообщений будут добавляться в Git репозиторий.

Чтобы избежать слишком большого оттока и исправлений строк в последнюю минуту, приводящих к удалению файлов, существует также и применяемая вручную и только для релизов политика более низкого порога в 66 процентов переведённых сообщений.

Скрипты инфраструктуры OpenStack, выполняемые задачами, в настоящий момент загружают только те новые файлы, объём перевода которых достигает 75 процентов. При этом, если размер файла растёт, но объём переводов не увеличивается (или если строки сильно изменяются), то файл перевода будет автоматически удалён из проектов, когда будет достигнут нижний порог объёма перевода, который в настоящий момент составляет 40 процентов.

Отслеживание заданий, относящихся к переводам

Страница сборки Zuul предоставляет удобный способ проверки статуса задач перевода.

• Пост-задачи – синхронизация в Zanata

• Периодические задачи: синхронизация в репозитории

Задания и скрипты инфраструктуры переводов

Задания инфраструктуры переводов хранятся и управляются в репозитории openstack/project-config. Скрипты инфраструктуры переводов хранятся и управляются в репозитории openstack/openstack-zuul-jobs.

• upstream-translation-update.yaml

  • Реализует первую задачу Zuul (синхронизацию в Zanata) запуская upstream_translation_update.sh

• propose-translation-update.yaml

  • Реализует вторую задачу Zuul (синхронизация в репозитории) запуская propose_translation_update.sh

  • This job renames Chinese locales in Zanata (zh-cn and zh-tw) to zh-hans and zh-hant for horizon related projects. For other projects and documentations (including docs in horizon related projects), zh-cn and zh-tw are used as-is. For more details, see Работа с проектами панелей управления Horizon.

• common_translation_update.sh

  • Общий код, используемый propose_translation_update.sh и upstream_translation_update.sh

• create-zanata-xml.py

  • Скрипт на Python, настраивающий проекты для Zanata

• releasenotes/pre.yaml

• releasenotes/run.yaml

  • Выполняет сборку аннотаций к версиям в оригинальной (английской) и в переведённых версиях (если они есть).

Обратите внимание, что скрипты в задачах используют zanata-cli, чтобы загружать и выгружать контент для перевода.

Debugging job scripts

See Debugging job scripts.