Godot - Lingo.dev CLI

什么是 Godot？

Godot 是一个开源的游戏引擎，用于开发 2D 和 3D 游戏。它通过 CSV 和 PO 文件格式内置了国际化支持，方便管理游戏翻译内容。

什么是 Lingo.dev CLI？

Lingo.dev 是一个由 AI 驱动的翻译平台。Lingo.dev CLI 会读取源文件，将可翻译内容发送给大型语言模型，并将翻译后的文件写回到您的项目中。

关于本指南

本指南介绍如何在 Godot 游戏项目中配置 Lingo.dev CLI。您将学习如何配置翻译文件、搭建翻译流水线，并将翻译集成到您的游戏中。

步骤 1. 设置翻译文件

为您的游戏可翻译字符串创建一个 CSV 文件（例如，strings.csv）：

keys,en
WELCOME,"Hello, world"

Godot 会根据此 CSV 自动生成 .translation 文件（例如，strings.en.translation、strings.es.translation）。

注意： 在 Godot 中，通常建议键名使用大写，但这并非强制要求。

步骤 2. 配置 CLI

在 Godot 项目的根目录下创建一个 i18n.json 文件：

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {
    "csv": {
      "include": ["strings.csv"]
    }
  }
}

该文件定义了：

Lingo.dev CLI 需要翻译的 CSV 文件
需要翻译的语言对

在本例中，配置将 CSV 文件从英文翻译为西班牙文。

步骤 3. 翻译内容

注册 Lingo.dev 账号。
通过 CLI 登录 Lingo.dev：
```
npx lingo.dev@latest login
```
运行翻译流水线：
```
npx lingo.dev@latest run
```

CLI 会将翻译内容更新到您的 CSV 文件，并生成一个 i18n.lock 文件，用于跟踪已翻译内容（以防止不必要的重复翻译）。

步骤 4. 在 Godot 中配置语言

进入 Project > Project Settings。
切换到 Localization 选项卡。
点击 Add。
选择自动生成的 .translation 文件。
点击 Open。

步骤 5. 使用翻译内容

UI 控件

选择一个节点（例如 Button 或 Label）。
打开该节点的 Inspector 面板。
将 Text 属性设置为翻译文件中的某个键（如 "WELCOME"）。
确保已启用 Auto Translate 选项（默认已启用）。

GDScript

使用 tr 函数访问翻译内容：

tr("WELCOME")

C#

使用 Tr 函数访问翻译内容：

Tr("WELCOME")

步骤 6. 测试翻译内容

进入 Project > Project Settings。
启用 Advanced Settings。
进入 Internationalization > Locale。
在 Test 字段中输入一个 locale（如 "es"）。
运行游戏。

已知限制

Godot 支持的 locale 代码不一定与 Lingo.dev 支持的 locale 代码一致。要了解可用的 locale 代码，请参阅官方文档。

后续步骤

要了解更多关于 Godot 翻译系统的信息，请参阅：