预发布环境
如何在预发布环境中准备翻译供审阅
概览
gtx-cli stage 是一个为你的项目生成翻译并将其暂存以供人工复审的命令。
只有在你为项目启用了人工复审时，此命令才有意义。
目前，此命令仅支持使用 gt-next 或 gt-react 的应用。
用法
在为生产环境构建应用之前，请在 CI 流水线中运行此命令。
npx gtx-cli stage注意： 此命令需要生产环境 API key！请在平台获取。
gtx-cli stage 命令与 translate 命令的用法相同，但它不会下载已完成的翻译，也不会将其发布到 CDN（内容分发网络）；而是将其暂存以供审核。
运行 gtx-cli stage 后，应运行 gtx-cli translate 以完成流程，并下载翻译（如果已相应配置）。
仅限生产环境使用！
此命令面向生产构建，不应在开发环境中使用。
运行此命令之前，请确认你位于用于生产发布的分支。
同时请在环境变量中指定生产环境的 API key（GT_API_KEY）和项目 ID（GT_PROJECT_ID）。
参数标志
| 参数 | 说明 | 类型 | 可选 | 默认值 |
|---|---|---|---|---|
--api-key | 指定生产环境的 API key | string | true | |
--project-id | 指定项目 ID | string | true | |
--version-id | 指定版本 ID（默认为内容的哈希值） | string | true | |
--config <path> | 指定 GT 配置文件路径 | string | true | "gt.config.json" |
--tsconfig, --jsconfig <path> | 指定 TS 或 JS 配置文件路径 | string | true | |
--src <paths> | 以空格分隔的 glob 模式列表，用于匹配源文件。应为相对于根目录的相对路径。 | [string] | true | [ 'src/**/*.{js,jsx,ts,tsx}', 'app/**/*.{js,jsx,ts,tsx}', 'pages/**/*.{js,jsx,ts,tsx}', 'components/**/*.{js,jsx,ts,tsx}', ] |
--dictionary <path> | 指定字典文件路径 | string | true | |
--inline | 除字典外，包含内联的 <T> 标签 | boolean | true | true |
--timeout | 翻译请求的超时时间（秒） | number | true | 600 |
--new, --locales <locales> | 将项目翻译为的目标 locales | [string] | true | |
--default-locale <locale> | 项目的源 locale | string | true | en |
--ignore-errors | 忽略错误并对有效内容强制执行翻译 | flag | true | false |
--dry-run | 试运行该命令 | flag | true | false |
以上所有参数均为可选。
不要将你的 API key 添加到 gt.config.json 文件中！
应将其设置为环境变量。若已设置，CLI 会自动读取 GT_API_KEY。
以下是几个关键参数：
| 参数 | 说明 |
|---|---|
--dry-run | 该标志会让 CLI 解析并校验你的项目，但不会与 GT API 通信。可用于验证代码库。 |
--api-key | 除非使用 --dry-run，否则必须提供生产环境的 API key。 |
--project-id | 同样，除非使用 --dry-run，否则必须提供项目 ID。 |
--new, --locales <locales> | 将项目翻译为的目标 locales。这些会追加到你在 gt.config.json 中指定的 locales。 |
配置文件
当运行 gtx-cli stage 时，CLI 会自动在你的 gt.config.json 文件中添加 stageTranslations: true 属性。
该属性可确保如果在未先为特定部署版本运行 stage 的情况下运行 translate，
CLI 工具将报错并退出。
本指南如何?