Lingo.dev 的 Bitbucket 集成通过官方 Pipe 运行本地化流水线。它既可直接提交翻译，也可创建拉取请求，并通过 rebase 自动处理冲突。
前置条件
请先完成 CI/CD 设置。你需要准备好可用的 i18n.json 和 LINGODOTDEV_API_KEY，并将它们保存为仓库变量。
身份认证#
将你的 API 密钥添加为仓库变量：Repository settings > Repository variables。
如果使用拉取请求模式，还需要创建一个 Bitbucket 访问令牌：
- Repository settings > Access tokens > Create Repository Access Token
- 授予以下权限范围：Read & write repositories、Read & write pull requests
- 将其添加为名为
BB_TOKEN的仓库变量
工作流示例#
直接提交（默认）#
yaml
image:
name: atlassian/default-image:2
pipelines:
branches:
main:
- step:
name: Translate
script:
- pipe: lingodotdev/lingo.dev:main拉取请求模式#
yaml
image:
name: atlassian/default-image:2
pipelines:
branches:
main:
- step:
name: Translate
script:
- pipe: lingodotdev/lingo.dev:main
variables:
LINGODOTDEV_PULL_REQUEST: "true"功能分支完整配置示例#
yaml
image:
name: atlassian/default-image:2
pipelines:
branches:
feat/*:
- step:
name: Translate
script:
- pipe: lingodotdev/lingo.dev:main
variables:
LINGODOTDEV_API_KEY: "${MY_LINGODOTDEV_API_KEY}"
BB_TOKEN: "${MY_ACCESS_TOKEN}"
LINGODOTDEV_PULL_REQUEST: "true"
LINGODOTDEV_PULL_REQUEST_TITLE: "feat: update translations"
LINGODOTDEV_COMMIT_MESSAGE: "feat: update translations"
LINGODOTDEV_WORKING_DIRECTORY: "apps/web"配置变量#
| 变量 | 默认值 | 说明 |
|---|---|---|
LINGODOTDEV_API_KEY | 必填 | Lingo.dev API 密钥 |
BB_TOKEN | PR 模式下必填 | Bitbucket 访问令牌 |
LINGODOTDEV_PULL_REQUEST | false | 创建拉取请求，而非直接提交 |
LINGODOTDEV_PULL_REQUEST_TITLE | feat: update translations via @lingodotdev | 自定义 PR 标题 |
LINGODOTDEV_COMMIT_MESSAGE | feat: update translations via @lingodotdev | 自定义提交信息 |
LINGODOTDEV_WORKING_DIRECTORY | . | Monorepo 的工作目录 |
LINGODOTDEV_PROCESS_OWN_COMMITS | false | 处理由该集成创建的提交 |
