Управление переводами

Branching (Strings)

Контент автоматически переведен с английского языка с помощью Phrase Language AI.

Доступно для

  • Бизнес и корпоративные планы

Свяжитесь с отделом продаж по вопросам лицензирования.

Доступно для

  • План Enterprise (Устаревшая версия)

Свяжитесь с отделом продаж по вопросам лицензирования.

Ветвление используется при управлении версиями программного обеспечения. Копии файлов проекта, называемых ветками, позволяют командам одновременно работать над параллельными версиями проекта, сохраняя неотредактированную копию. Это исключает риск случайной замены чужих изменений в файлах проекта.

Основной проект копируется при создании новой ветки с изменениями, внесенными только в эту ветку. По завершении изменений ветка объединяется обратно в основной проект. Одновременно можно работать с несколькими ветками, а после объединения ветки можно удалять. Теги из существующей ветки копируются в новую ветку.

Ограничения

  • Все функции, кроме Переводчика и Гостя, имеют доступ к просмотру Веток.

  • Слияния нельзя отменить, а ветки нельзя отменить.

  • Задания, созданные в определенной ветке, не отображаются в основном проекте и наоборот. Когда ветка интегрирована в основной проект, все открытые задания в ней теряются.

  • Отчеты в просмотре Отчетов отражают только статус активной ветки. Включение ветки в основной проект обновляет основные отчеты проекта.

  • Вид Активности содержит только действия в активной ветке. Деятельность в ветках не отображается в основном проекте и наоборот. Действия в ветке теряются при ее объединении с основным проектом.

  • Синхронизацию платформы GitHub можно использовать только в основном проекте, но не в ветках.

  • Замечания, сделанные в ветке, не видны в основном проекте и наоборот.

  • Заказы, созданные в ветке, не видны в основном проекте и наоборот. Когда ветка интегрирована в основной проект, все открытые заказы в ней теряются.

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

Включить ветвление

Ветвление включено на вкладке Дополнительно Настройки проекта с возможностью защиты основной ветки от изменений.

При активации этой опции на экране проекта появляется branch_menu.png меню веток, в котором можно выбрать рабочие ветки. Чтобы указать ветку в CLI, используйте параметр --ветка:

--branch <branch_name>

Ветки отображаются в просмотре Ветки, где представлена информация о создании и объединении. Ветки также могут быть удалены или объединены, и для этой ветки могут быть созданы задания из списка веток.

Чтобы составить список всех веток для проекта с помощью API или CLI, запустите:

Список веток фразы за $ <project_id>

Чтобы удалить ветку через API или CLI, запустите:

Ветка фразы за $ удалить <project_id> <branch_name>

Создание ветки

Администраторы, менеджеры проектов и разработчики могут создавать новые ветки в редакторе перевода, через API или в CLI.

Чтобы создать ветку в редакторе перевода, выполните следующие действия:

  1. На странице Проекта выберите вкладку Ветки.

  2. Нажмите Создать ветку.

    Откроется окно Создание ветки.

  3. Укажите имя ветки.

  4. Нажмите Создать ветку.

    Новая ветка добавлена в список.

Чтобы создать ветку с помощью API или CPI, запустите:

Ветки фразы за $ создают --project_id <project_id> --data <data>

Чтобы создать ветку при отправке переводов, выполните следующие действия:

push фразы за $ --branch <branch_name>

Объединить ветки

После внесения изменений в ветку ее можно объединить с основным переводом, чтобы включить в нее любые новые переводы.

При объединении применяются только изменения к следующим ресурсам:

  • Языковые стандарты

  • Ключа

  • Переводы

Изменения других ресурсов, таких как Деятельность, Задания и Заказы, не применяются.

Конфликты

Конфликт возникает, когда ресурс (перевод, ключ или языковой стандарт) изменился в основном проекте с момента создания ветки до момента ее объединения с основным проектом. Например, переводы и настройки ключей, такие как формы множественного числа), могли измениться в основном проекте после создания ветки, сделав значения в ветке отличными от значений в основном проекте.

Чтобы объединить ветку, выполните следующие действия:

  1. В просмотре веток проекта выберите ветку для объединения и нажмите «Сравнить и объединить».

    Открывается страница ветки Слияние. Информацию о переводах, которые будут изменены при объединении, можно найти в ячейках.

  2. Если возникают конфликты, выберите стратегию объединения:

    • Выберите Использовать Основной проект, чтобы отклонить противоречивые изменения и сохранить существующие переводы.

    • Выберите Используйте branch_menu.png BranchName, чтобы заменить существующие переводы изменениями из ветки.

  3. Нажмите Объединить ветку.

    Ветка объединена с основным проектом.

Чтобы объединить ветку через API или CPI, запустите:

Ветки фразы за $ объединить \
  --project_id <project_id> \
  --name <name> \
  --data '{"strategy":"use_master"}' \
  --access_token <token>
  • use_branch решает конфликты, применяя изменения из ветки, и если они не указаны, используется по умолчанию.

  • use_master решает конфликты, не принимая изменений из ветки.

Push и pull

При использовании CLI укажите ветку для нажатия или вытягивания параметром -- ветка.

push фразы за $ --branch <branch_name>
Фраза за $ pull --branch <branch_name>

Если указанная ветка не существует в проекте, клиент создает ее.

Используйте --use-local-branch-name, чтобы push and pull, используя имя ветки активной ветки git:

push фразы за $ --use-local-branch-name
$ phrase pull --use-local-branch-name

API

Все конечные точки API, использующие аргумент проекта, также поддерживают параметр --ветвь для выполнения действия для определенной ветки проекта:

Загрузите фразу за $ создать <project_id> \

  --branch <branch_name>

  --file /path/to/my/file.json \

  --file-format json \

  --locale-id abcd1234cdef1234abcd1234cdef1234 \

  -- теги awesome-feature,потребности-корректура \

  --locale-mapping "{"en": "2"}" \

  --format-options "{"foo": "bar"}" 
Была ли эта статья полезной?

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.