开发者工具
翻译文件,从服务器调用 API,使用 JavaScript 包渲染多语言应用。
本地化将两类代码连接起来:生成译文的代码和使用译文的代码。服务器可能在记录变更时请求翻译内容,构建流程可能收集已翻译的文件,而 React 组件可能直接读取现有的翻译目录,无需发起任何翻译请求。
从你正在实现的部分入手。每个章节都会先带你完整地完成一项入门任务,再介绍后续开发所需的接口约定。
API #
如果内容已存储在服务器上,并且需要由服务器决定何时请求翻译、将译文存储在哪里以及何时使用,请使用 API。将 JSON 内容或上传的文件提交为翻译任务,启动任务,再逐一获取已完成的目标译文。引擎控制任务的翻译和审核阶段。
发起首次请求会发送少量数据,并将翻译后的数据保存到本地。这份操作指南介绍了凭据、本地化引擎的选择、响应字段,以及接入应用存储前需要执行的检查。
CLI #
如果内容存储在文件中,请使用 CLI。配置源文件路径和目标语言区域,提交选定的任务,再将目标文件取回项目中。CLI 会记录源内容基线,让后续运行能够处理变更,而不必将每个文件都视为新文件。
翻译首个文件涵盖安装、身份验证、配置和译文获取。同一个 CLI 还可以将显式声明的 React 消息提取到翻译目录中;提取在本地完成,不会发起翻译请求。
JavaScript #
JavaScript 包涵盖服务端客户端、React 消息渲染和语言区域路由。要发起翻译请求,请选择客户端;要渲染应用中已有的消息,请选择渲染库。浏览器端渲染无需翻译 API 密钥。
React 文档提供了在本地渲染首条消息的示例,并介绍翻译目录加载、语法变体、富文本和特定框架的集成方式。URL 协商与翻译文本各有分工,因此路由参考文档会说明如何让选定的语言区域与已加载的消息保持一致。
接入现有项目 #
格式说明了每个处理器会翻译和重建哪些内容。也请查看调用该处理器的工具所列出的格式:服务端集成可用的处理器,不一定对应 CLI 中已配置的文件格式。
使用 i18n.json 或 LingoDotDevEngine 的项目可查阅对应版本的 CLI v0 和 SDK v0 参考文档。规划迁移期间,请保留当前安装的版本;不同代际的配置、保留的状态和返回值可能有所变化。
如果助手需要处理本地文件或账户配置,请使用 MCP。如果翻译需要对接代码仓库、CMS 或帮助中心,请使用集成。每种连接都会明确任务如何启动、使用哪些权限,以及结果返回到哪里。