Проекты перевода в Weblate

Команда локализации Fedora 2026-02-01

Информация для владельцев проектов, которые оценивают или намереваются использовать онлайн-платформу перевода проекта Fedora (основанную на программном проекте Weblate) для перевода своего проекта. Как получить доступ к платформе или запросить создание проекта перевода, почему команда локализации Fedora считает целесообразным предлагать её более широкому кругу проектов, а не только проектам самого Fedora, и несколько собранных практических советов по администрированию проекта перевода.

Онлайн-платформа перевода Fedora

Проект Fedora управляет веб-ориентированной онлайн-платформой перевода на основе программного обеспечения Weblate. Этот экземпляр Weblate Fedora доступен по адресу https://translate.fedoraproject.org/ и используется переводчиками Fedora для перевода подпроектов Fedora, будь то проект разработки программного обеспечения, веб-сайт или документация.

Однако размещаются не только подпроекты Fedora. Примеры свободных проектов с открытым исходным кодом, которые можно найти на платформе перевода Fedora Weblate и которые находятся скорее вне Fedora:

Соображения для вышестоящих проектов

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

  • Оказать поддержку любому проекту, разделяющему те же ценности, что и проект Fedora

  • Улучшить поддержку i18n в вышестоящих проектах

  • Потенциальный источник роста для самого сообщества Fedora

Как команда локализации Fedora, мы считаем, что мы достаточно «зрелые и последовательные в своих ценностях, чтобы быть готовыми приветствовать проекты, которые имеют иные технические решения, чем те, что реализует Fedora» (Jean-Baptiste Holcroft, участник команды L10N Fedora, 2020).

Запрос нового проекта перевода в Fedora Weblate

Несмотря на усилия быть максимально открытыми и инклюзивными, некоторые связанные с этим опасения привели нас к тому, что создавать проект перевода на платформе может не каждый:

  • Перевод (открытого) проекта должен быть обеспечен — а не то, что решил перевести отдельный человек.

  • Проекту не нужно изучать внутреннее устройство weblate

  • Настройка Weblate не так очевидна — предпочтительно, чтобы первую настройку для проекта выполнили мы, чтобы снизить, например, затраты на миграцию.

Чтобы запросить создание нового проекта перевода в Weblate, откройте заявку.

Table 1. Запрос проекта с примерными значениями курсивом

Проект:

debbuild

Веб-сайт:

https://github.com/debbuild/debbuild

Репозиторий:

https://github.com/debbuild/debbuild

Имя ветки разработки:

Маска файлов:

po/*

Имя пользователя:

ngompa

Необязательно:

Любое объявление или предупреждение, которое вы хотели бы показать переводчикам? (оно будет отображаться в Weblate):

Необходимость активировать какие-либо конкретные проверки? (это настройка для каждого компонента):

Необходимость автоматически обнаруживать новые файлы перевода? (типичный случай использования: перевод веб-сайта с одним файлом перевода на страницу):

Указанное имя (имена) пользователя будет установлено в начальной конфигурации проекта в Weblate в качестве администратора (администраторов) проекта, и впоследствии они будут уведомлены о создании проекта.

Запросы, сделанные вышестоящими проектами, будут рассматриваться в индивидуальном порядке после подачи заявки. Приоритет будет отдан проектам, создающим программное обеспечение, упакованное для Fedora.

Лучшие практики настройки проекта

Как только запрошенный проект перевода будет создан для вас в Weblate, вы можете продолжить с настройкой его других параметров. Существует несколько подходов к созданию компонентов проекта, например. Weblate предоставляет различные средства для получения и отправки изменений между Weblate и вашим репозиторием, поэтому сложно охватить все возможности здесь или подготовить общее руководство. Но вот что мы узнали, помогая настраивать различные проекты:

Не забудьте установить, если это уместно, вебхук в параметрах проекта, чтобы автоматически получать изменения из вашей VCS, например

https://translate.fedoraproject.org/hooks/pagure  //for Pagure
https://translate.fedoraproject.org/hooks/gitlab  //for GitLab
https://translate.fedoraproject.org/hooks/github  //for GitHub

Weblate способен отправлять переводы в ваш репозиторий, установив параметр 'Repository push URL' в конфигурации компонента. Для GitHub есть пользователь Weblate, которому следует предоставить доступ на коммит в репозиторий. То же самое относится к GitLab. Для Pagure есть пользователь weblatebot.

Weblate предоставляет широкий спектр проверок качества строк. Флаг placeholders можно установить, чтобы добавить проверку качества текстов из исходной строки, которые не должны отсутствовать в переводе. Если они отсутствуют, у переводчика появится предупреждение. Помимо извлечения из файла перевода, заполнители могут быть добавлены вручную администраторами проекта на основе отдельного компонента или отдельной строки, но не для всего проекта.

Чтобы установить заполнители для компонента:

  1. Перейдите на страницу компонента (например, компонент перевода dnf5 проекта DNF5)

  2. Используйте меню Manage  Settings

  3. На странице Settings перейдите на вкладку Translation

  4. Прокрутите, пока не увидите поле Translation flags

  5. Впишите туда выражение флага placeholders

    Например: placeholders:{}:{0}:{1}:{2}

    Такие заполнители могут быть полезны для всего компонента, поскольку эти термины могут встречаться очень часто, как в строке перевода Failed to cleanup repository cache in path "{0}": {1}.

Чтобы установить заполнители для конкретной строки (что переопределит заполнители её компонента):

  1. При редактировании строки перейдите на боковую панель справа и найдите элемент Flags

  2. Нажмите на значок карандаша, чтобы отредактировать флаги

  3. В поле Translation flags впишите туда выражение флага placeholders

    Например: placeholders:--alldeps:--resolve

    Эти параметры командной строки могут быть очень хорошими заполнителями для отдельной строки, если они нечасто встречаются в данном компоненте, как в строке перевода Option "--alldeps" should be used with "--resolve".

Дополнительная информация из документации программного обеспечения Weblate: