ローカリゼーションCSVファイルを翻訳する

ゲームローカリゼーション用CSVはキー列と各言語ごとの列を持ちます。KAERISはキーとソース列を読み取り、ターゲット言語ごとに列を追加します。

KAERISはこのページを翻訳し、すべての行を逆翻訳して確認しました。ネイティブスピーカーによるレビューはまだ行われていません。英語原文

ローカリゼーションCSVの構成方法

最初の列がキー、2列目がソーステキストです。ヘッダーは列名を示します（keys,en）。カンマや改行を含むセルは引用符で囲まれます。完全に空の行は無視されます。

ソースファイルtranslations.csv

keys,en
GREETING,"Welcome back, %s!"
ITEMS,"You have {count} items, %d of them new"
QUIT,Quit game

CSV翻訳で注意すべき点

言語ごとに1列
出力にはキー列、ソース列、そしてde、jaなどが続きます。キーとソースの列名は保持されます。
数式
=、+、-、@で始まるセルは、Excelが数式として実行せずテキストとして表示するよう、先頭にアポストロフィを付けて書き込まれます。
Printf形式と波括弧変数
%s、%d、{count}はソースと比較されます。以下の実際の実行では3つとも戻ってきました。
引用符
セル内のカンマや引用符はCSVライターによって適切に引用されるため、翻訳されたセルが隣の列に漏れることはありません。

実際の実行例：ドイツ語に翻訳しチェック

実際の実行例、2026年10月27日、手動編集なし：kaeris translate translations.csv --langs de をkaeris 0.2.35で実行、2.5秒、モデルはgoogle/gemini-2.5-flash-lite（無料プランのデフォルト）。以下に書き出されたドイツ語ファイルとkaeris checkの結果を示します。

ドイツ語の結果translations/translations.csv

keys,en,de
GREETING,"Welcome back, %s!","Willkommen zurück, %s!"
ITEMS,"You have {count} items, %d of them new","Sie haben {count} Artikel, davon %d neu"
QUIT,Quit game,Spiel beenden

kaeris チェックexit code 0

$ kaeris check --source translations.csv --langs de
✓ de: complete & placeholder-safe
✓ all locales complete & placeholder-safe

KAERIS が行うこと

同じ列構成で言語を追加
キーとソース列は保持され、ターゲット言語ごとに新しい列が追加されます。ターミナルでは結果がソースの隣のtranslations/localization.csvに書き込まれ、kaeris checkはそこから読み込みます。
スプレッドシートで安全なセル
数式のように見えるセルはテキストとして書き込まれます。ゲームエンジン側についてはゲームページを参照してください。
この形式の無料チェック
無料チェックページの/checkはこの形式を読み込み、キーやアカウントなしで実行できます。ターミナルコマンドkaeris checkも同様に読み込みます：kaeris 0.2.35以降の13形式すべてに対応し、同じルールでどこにも送信しません。

ファイルを翻訳するファイルを無料でチェックする

3ステップで実行する

CLIをインストールする
pip install kaerisを実行します。
シートを翻訳する
kaeris translate localization.csv --langs de,ja,frを実行します。
結果をチェックする
kaeris check --source localization.csv --langs de,ja,frを実行するか、無料チェックページにファイルをアップロードします。どちらも各言語の列を読み込みます。

pip install kaeris
kaeris translate localization.csv --langs de,ja,fr --verify

よくある質問

GodotやUnityに対応していますか？

フォーマットはキー列、ソース列、言語列で、これらのエンジンが期待する形です。ゲームページを参照してください。

=で始まるセルは数式として実行されますか？

いいえ。そのようなセルはスプレッドシートでテキストとして表示されるように書き込まれます。

無料ですか？

はい、アカウントなしで：ファイルあたり 10,000 文字、実行あたり最大 8 言語。無料の API キーでファイル制限が 50,000 文字に引き上げられます。一度限りの生涯プランは 79 ドルで、ご自身の OpenRouter キーを使用します。月額プランは 19 ドルから。料金

ターミナルや CI から実行できますか？

はい。pip install kaerisを実行し、次にkaeris translate localization.csv --langs de,jaを実行します。GitHub Actionはプルリクエストで同じ翻訳を実行します。CLIドキュメント · GitHub Action

続ける

CLIリファレンス · チェックリファレンス · ブラウザで翻訳 · 無料チェック · フォーマット変換 · 疑似ローカリゼーション

その他のフォーマット：JSON · YAML · .po · ARB · XLIFF · .strings · .xcstrings · .properties · .resx · Markdown · Fluent · Android XML