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.8,
  "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 字段中输入一个区域设置（例如，"es"）。
运行游戏。

已知限制

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

下一步

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