# General Translation Platform: 自动化
URL: https://generaltranslation.com/zh/docs/platform/locadex/reference/automations.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 管理 Locadex 自动化模板、配置、手动运行、目标和活动。Locadex 自动化参考。

针对单个项目，请使用 **项目 &gt; 自动化**；如需跨项目操作，请使用 **组织 &gt; Locadex &gt; 自动化**。

Locadex 工作流需要 Starter、Team 或 Enterprise 方案。创建、修改或运行自动化需要对应项目的 `project:locadex:write` 权限，从组织级自动化页面进行操作时同样如此。

| 区域                   | 说明                  |
| -------------------- | ------------------- |
| [自动化列表](#lists)      | 搜索已配置的自动化，并从模板开始创建。 |
| [模板](#templates)     | 创建代码、翻译或区域设置同步自动化。  |
| [自动化详情](#details)    | 查看目标、状态、配置和最近的运行记录。 |
| [手动运行](#manual-runs) | 使用已保存的配置启动自动化。      |
| [设置](#setup)         | 在首次运行自动化之前准备代码仓库。   |

## 自动化列表 [#lists]

项目页面包含：

* **已配置** — 当前项目中可搜索的自动化
* **从模板开始** — 用于创建自动化的模板
* **最近活动** — 整个项目中最近的五次运行记录

组织 页面会列出跨项目的自动化。你可以按自动化或项目搜索，并选择每页显示 25、50 或 100 项。

**组织 &gt; Locadex &gt; Integrations** 列出了 Locadex 可访问的 GitHub 仓库，以及与每个链接关联的项目。

## 模板 [#templates]

* **生成代码** — 检测尚未翻译的用户界面内容，并发起一个供审校的拉取请求
* **生成翻译并推送** — 根据源内容变更生成区域设置文件并推送更新
* **保持区域设置同步** — 在区域设置列表变更后更新项目配置

设置向导会为每个项目选择一个已关联的仓库、目标目录、框架、目标分支、触发器、分支前缀以及拉取请求处理方式。在组织页面中，一次最多可为 50 个项目创建自动化。

## 自动化详情 [#details]

自动化详情页会显示：

* 状态以及自动化是否已启用
* 仓库和目标目录
* 框架、包管理器和 linter
* 目标分支和触发器
* 拉取请求、提交和命令设置
* **最近的运行记录**，包括步骤状态和可安全展示给客户的错误

跨多个项目共享的自动化会显示在这里，但目前无法在详情页中编辑或运行。

新建的自动化默认启用 **Preserve local edits**。启用后，翻译运行需要在 `gt.config.json` 中设置顶层的 `publish: true` 或 `files.gt.output`。保持启用可保留对此前生成的翻译文件所做的手动修改。

## 手动运行 [#manual-runs]

在自动化详情页中点击 **立即运行**，以确认其仓库、目标目录和分支。**保持区域设置同步** 运行还会要求你提供源区域设置和目标语言。

## 设置 [#setup]

只有完成目标目录设置后，自动化才能产生正确结果。设置开始前，自动化详情页会显示 **运行设置**。Locadex 准备仓库时，页面会显示 **正在设置**。

选择源区域设置和目标语言，然后启动设置。Locadex 会准备仓库并创建拉取请求。运行自动化前，请先合并该拉取请求。如果设置失败，**运行设置**会再次可用，以便你重试。

对于服务器端渲染的 React 框架，设置会配置 `gt.config.json`、翻译加载、运行时初始化以及 [`GTProvider`](/docs/react/reference/components/gt-provider) 的放置位置。对于客户端渲染的 React 应用程序 (包括 Bazel 和其他 SPA 构建系统) ，设置会在应用程序入口之前调用 [`initializeGTSPA()`](/docs/react/reference/config#initialize-spa)，并配置浏览器端的翻译加载。随后，它会运行仓库现有的构建或类型检查命令。

设置不会使用 [`<T>`](/docs/react/reference/components/t) 或其他翻译 API 包裹应用程序字符串；设置拉取请求合并后，**生成代码**自动化会处理源内容。

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.
