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で言語を設定する

プロジェクト > プロジェクト設定に移動します。
ローカライゼーションタブに切り替えます。
追加をクリックします。
自動生成された.translationファイルを選択します。
開くをクリックします。

ステップ5. 翻訳を使用する

UIコントロール

ノード（例：ButtonまたはLabel）を選択します。
ノードのインスペクターペインを開きます。
Text属性を翻訳ファイルのキー（例："WELCOME"）に設定します。
Auto Translateオプションが有効になっていることを確認します（デフォルトで有効です）。

GDScript

翻訳にアクセスするにはtr関数を使用します：

tr("WELCOME")

C#

翻訳にアクセスするにはTr関数を使用します：

Tr("WELCOME")

ステップ6. 翻訳をテストする

プロジェクト > プロジェクト設定に移動します。
詳細設定を有効にします。
国際化 > ロケールに移動します。
テストフィールドにロケール（例：「es」）を入力します。
ゲームを実行します。

既知の制限事項

Godotがサポートするロケールコードは、Lingo.devがサポートするロケールコードと一致することが保証されていません。利用可能なロケールコードについては、公式ドキュメントを参照してください。

次のステップ

Godotの翻訳システムの詳細については、以下を参照してください：