# General Translation Platform: Настройка автоматизаций Locadex
URL: https://generaltranslation.com/ru/docs/platform/locadex/guides/configuring-automations.mdx
---

title: Настройка автоматизаций Locadex
description: "Как настроить автоматизации Locadex: в этом руководстве рассматриваются шаблоны, триггеры, ветки, поведение pull request и команды."
related:
  links:
    - /docs/platform/locadex/guides/auto-merging-prs
    - /docs/platform/locadex/guides/managing-languages
    - /docs/platform/locadex/guides/viewing-automation-activity
    - /docs/platform/locadex/guides/adding-environment-variables

---

Используйте настройки автоматизации, чтобы управлять тем, что именно изменяет Locadex, когда он запускается и как создает или обновляет pull request.

В Locadex есть три шаблона. Каждую автоматизацию можно запускать при изменении pull request, при push коммита или вручную.

## Выберите шаблон [#choose-template]

Откройте **Проект > Автоматизации**. В разделе **Начать с шаблона** выберите:

* **Сгенерировать код** для интернационализации кода.
  * Укажите, когда Locadex должен оборачивать ваш исходный код вызовами библиотеки интернационализации, такими как `t()` или компонент `T`.
* **Сгенерировать переводы и отправить** для обновлений контента.
  * Укажите, когда Locadex должен переводить новый или обновлённый исходный контент на целевые языки.
* **Поддерживать синхронизацию локалей** для обновлений локалей.
  * Укажите, когда Locadex должен обновлять файлы в вашем проекте, если языки были добавлены или удалены. При ручном запуске можно выбрать исходную и целевые локали.

Чтобы изменить настроенную автоматизацию, выберите её на этой странице. Вы также можете использовать **Организация > Locadex > Автоматизации**, чтобы искать автоматизации и управлять ими во всех проектах.

## Настройка автоматизации [#configure-automation]

### Измените триггер

Установите для **Run when** один из трех триггеров:

* **A pull request changes** запускается, когда соответствующий pull request открывают, повторно открывают или помечают как готовый к проверке. Новые коммиты отменяют любой выполняющийся запуск, но не запускают новый; оставьте комментарий `/locadex`, когда pull request снова будет готов к обработке.
* **A commit is pushed** запускается, когда коммиты отправляются в целевую ветку.
* **Started manually** запускается, только когда вы нажимаете **Run now**.

Для новых автоматизаций **Generate code** и **Generate translations and push** по умолчанию используется **A pull request changes**. Для **Keep locales in sync** значением по умолчанию является **Started manually**.

### Изменение целевой ветки и префикса

Укажите **Target branch** — ветку, изменения в которой должен отслеживать Locadex. В большинстве проектов используется `main`.

Укажите **Created branch prefix** для веток, создаваемых Locadex. Значение по умолчанию:

```txt
locadex/
```

Используйте постоянный префикс, чтобы ветки Locadex было проще находить в GitHub.

### Изменение настроек PR

Используйте переключатели, чтобы управлять тем, как Locadex создает pull request и работает с ними:

* **Auto-merge** автоматически сливает pull request от Locadex, когда все проверки пройдены. См. [Автоматическое слияние PR Locadex](/docs/platform/locadex/guides/auto-merging-prs).
* **Changed files only** ограничивает проверку релевантности **Generate code** только измененными строками, а не всем содержимым измененных файлов. Автоматизации перевода и синхронизации локалей этот фильтр не используют, а фреймворки документации пропускают проверку релевантности.
* **Preserve local edits** сохраняет внесенные вручную изменения в файлах, ранее сгенерированных Locadex.

Для автоматических триггеров Locadex повторно использует открытый pull request для той же исходной ветки и той же автоматизации. Перед инкрементальным обновлением он помечает такой PR как черновик и публикует комментарий со статусом для каждого запуска. PR снова переводится в состояние ready for review только в том случае, если до запуска он уже был в этом состоянии; черновик, оставленный пользователем, так и остается черновиком. Ручные запуски из Dashboard используют одноразовые pull request.

Если автоматизация запускается pull request, то при создании отдельного PR Locadex оставляет комментарий в исходном PR со ссылкой на него.

Текстовые поля внизу страницы дают дополнительные возможности настройки:

* **Pull request title** задает заголовок для pull request Locadex.
* **Pull request description** задает body pull request.
* **Commit message** задает сообщение для коммитов Locadex.

### Добавление команд

Используйте команды, чтобы запускать в проекте такие шаги, как setup или валидация. Команды можно использовать для установки зависимостей, сборки проекта, проверки сгенерированных изменений линтером или запуска проверок, специфичных для проекта. Команды можно запускать до или после обработки файлов в Locadex:

* **Команда предобработки** запускается до того, как Locadex обрабатывает файлы. Например, запустите `npm run build`.
* **Команда постобработки** запускается после того, как Locadex обрабатывает файлы. Например, запустите `npm run typecheck`.

Команды запускаются из корня репозитория и внутри [VM-образа Locadex](/docs/platform/locadex/reference/vm-image). Если автоматизация завершается ошибкой из-за отсутствующего пакета, скрипта или исполняемого файла, добавьте команду предобработки.

Если какая-либо проверка завершится ошибкой, [auto-merge](/docs/platform/locadex/guides/auto-merging-prs) не запустится.
## Next steps

- /docs/platform/locadex/guides/auto-merging-prs
- /docs/platform/locadex/guides/managing-languages
- /docs/platform/locadex/guides/viewing-automation-activity
- /docs/platform/locadex/guides/adding-environment-variables