将你的 Next.js 应用翻译成法语 🇫🇷、西班牙语 🇪🇸、日语 🇯🇵，或任何其他语言既费力又耗时。

Locadex 是一款可为你处理 100% 国际化（i18n）工作的 AI 代理。 安装仅需 5 分钟。

Locadex：

• 将项目配置为使用 gt-next i18n 库
• 修改 React 组件和文案以支持多语言内容
• 将应用翻译成任意数量的目标语言
• 当你推送新内容时持续完成国际化与翻译

设置流程

步骤 1：登录 General Translation Dashboard

前往你的 Dashboard 并登录你的账户。

步骤 2：连接 GitHub

1. 在你的 dashboard 中找到并进入 GitHub 集成部分
2. 点击“Connect GitHub”以连接你的 GitHub 账户
3. 系统会将你重定向至 GitHub 以授权连接

步骤 3：安装 GitHub 应用

1. 连接 GitHub 后，你会被重定向去安装 Locadex GitHub 应用
2. 选择要授予 Locadex 访问权限的仓库：
   • 安装到所有仓库，或
   • 选择特定仓库
3. 点击“Install”完成 GitHub 应用的安装

第 4 步：将代码仓库关联到项目

1. 回到你的 GT dashboard，选择你要进行国际化的代码仓库
2. 这会将你的仓库与翻译设置和目标语言关联起来
3. 每个项目只能关联一个代码仓库，但你可以创建多个项目，每个项目对应不同的仓库

步骤 5：配置

在配置界面中，设置：

• 目标语言：选择要翻译的目标语言（locale）

第 6 步：完成安装

1. 查看你的配置
2. 点击“Install”，为你的代码库启用 Locadex
3. 系统会将你带到一个概览页面，显示已连接的 GitHub 代码库

接下来是什么

初始设置

完成安装后：

1. 立即创建 PR：Locadex 会在你的主分支上创建一个 Pull Request
2. 完整设置：该 PR 会运行完整的 Locadex 设置命令，具体包括：
   • 安装 GT 库
   • 为你的项目配置国际化
   • 搭建翻译基础设施
3. 审查并合并：审查该 PR 并将其合并，以完成 i18n 设置

持续国际化

在完成初始设置并合并后：

1. Locadex 会监控你的主分支或指定分支上的 Pull Request
2. 当你推送包含可翻译内容的新代码时，等待 Locadex 将其提交添加到 PR
3. 一旦 Locadex 已向 PR 提交，便可安全合并——你的新代码已完成国际化
4. 你的应用无需人工干预即可持续保持已翻译状态

监控你的存储库

仪表盘状态

在 dashboard 中，你可以查看：

• 仓库状态：实时监控指示
• 配置：当前设置与目标语言

GitHub 集成

• 状态检查（Status Checks）：Locadex 会在拉取请求（pull request）上添加状态更新
• 检查运行（Check Runs）：GitHub 会显示 Locadex 的处理进度

故障排除

常见问题

Locadex 未创建 PR

• 确认 GitHub 应用已获仓库访问权限
• 检查提交是否包含可翻译内容

需要进行配置更改

• 在你的 GT dashboard 中更新分支设置
• 更改将在更新后对新的提交生效

支持的框架

目前，Locadex 仅支持基于 Next.js App Router 的应用。