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コントロール

ノード（例：ボタンやラベル）を選択します。
そのノードのインスペクタペインを開きます。
テキスト属性を翻訳ファイルのキーに設定します（例："WELCOME")。
自動翻訳オプションが有効になっていることを確認します。（デフォルトで有効になっています。）

GDScript

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

tr("WELCOME")

C#

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

Tr("WELCOME")

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

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

既知の制限事項

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

次のステップ

Godotの翻訳システムについて詳しく知るには：