使用 CLI v0 翻译文件
使用固定版本的软件包复现一次小规模旧版翻译目录运行,并检查输出和 Lockfile。
此流程适用于已安装 i18n.json 的项目或独立的旧版测试样例,面向 lingo.dev@0.138.10,其软件包清单要求使用 Node.js 18 或更高版本。请先检查 node --version 和已安装的 lingo --version。新项目请使用当前快速入门指南。
使用记录中指定的软件包 #
保留现有项目已固定版本的依赖。对于独立测试样例,请选择你使用的包管理器:
npm install --save-dev lingo.dev@0.138.10
pnpm add --save-dev lingo.dev@0.138.10
yarn add --dev lingo.dev@0.138.10
bun add --dev lingo.dev@0.138.10只需运行一条安装命令。通过 npm exec -- lingo、pnpm exec lingo、yarn lingo 或 bun run lingo 调用本地二进制程序。以下示例将此调用简写为 lingo。在 Windows 上,使用本地安装的固定版本,并通过包管理器的二进制程序调用,也能避免依赖基于包名的命令解析。
创建翻译目录和配置 #
在用于存放项目的目录中运行 lingo init。该命令会创建 i18n.json;如果文件已存在,请保留,不要重新初始化。创建 locales/en.json:
{
"welcome": "Welcome back",
"button.save": "Save changes"
}使用对应的 JSON 分组:
{
"$schema": "https://lingo.dev/schema/i18n.json",
"version": "1.15",
"locale": { "source": "en", "targets": ["es"] },
"buckets": {
"json": { "include": ["locales/[locale].json"] }
}
}version 是配置架构的版本,不是软件包版本。此配置模式从 locales/en.json 读取英语内容,并将西班牙语内容写入 locales/es.json。
配置翻译后端 #
使用 Lingo.dev 时,请通过命令行解释器的密钥管理机制提供 LINGO_API_KEY。将要使用的 engineId 添加到配置中,并确保该密钥可通过相应的本地化引擎执行翻译。如果省略,后端将采用隐式选择;当前服务策略可能要求显式指定 ID。
直接对接提供商的 v0 配置是另一种选择,需要提供商专用凭据或可访问的 Ollama 服务。其配置参考说明了各字段的用途。这些字段不适用于当前 CLI 的 JSON 配置。
运行并检查 #
lingo run检查 locales/es.json 中的键和实际译文,确认保存提示仍指向预期操作。接入应用时,请使用应用实际的翻译目录加载器加载目标内容。将确认采用的输出、配置和 i18n.lock 一起提交。
常规运行时,如果源内容没有变化,应保留已有的目标值。源内容变更或强制运行可能会替换这些值。按目标语言区域或指定键运行,不会刷新已有的源内容基线;冻结模式则可以初始化缺失的 Lockfile。在将局部输出视为项目已全面更新的依据之前,请先阅读基线确定。
开发时,lingo run --watch 会持续监测源内容变化,直到使用 Ctrl+C 停止。在扩展测试样例之前,请查看采用现有翻译和手动管理目标内容的归属。