Mozilla Fluent .ftlファイルを翻訳する
Fluentメッセージは変数、用語参照、選択式全体を含むことができます。KAERISはテキスト部分をすべて翻訳し、その周囲の構造を保持し、変数と用語参照をチェックします。
KAERISはこのページを翻訳し、すべての行を逆翻訳して確認しました。ネイティブスピーカーによるレビューはまだ行われていません。 英語原文
Fluentファイルの構成方法
メッセージはid = text形式で、{ $name }変数、{ -brand-name }用語参照、属性(.title)、[one]などの選択式バリアントと*のデフォルトを持ちます。コメントは#で始まります。
# Shown on the home screen welcome = Welcome back, { $name }! emails = { $count -> [one] You have { $count } new email. *[other] You have { $count } new emails. } -brand-name = Firefox about = About { -brand-name }
Fluent翻訳で注意すべき点
変数と用語
{ $name }と{ -brand-name }はそのままにしてください。以下の実際の実行では両方とも保持されました。選択式
各バリアントは独立した翻訳テキストです。
*のデフォルトはマークされたままです。上の解析例では2つのメールバリアントが別々の文字列として扱われています。用語
-brand-nameのような用語は独立したエントリです。翻訳に含まれていない場合は欠落として報告されます。コメント
ソースのコメントはファイルとともに再出力されます。
実際の実行例:ドイツ語に翻訳しチェック
実際の実行例、2026年10月27日、手動編集なし:kaeris translate en.ftl --langs de をkaeris 0.2.35で実行、2.1秒、モデルはgoogle/gemini-2.5-flash-lite(無料プランのデフォルト)。以下に書き出されたドイツ語ファイルとkaeris checkの結果を示します。
# Shown on the home screen welcome = Willkommen zurück, { $name }! emails = { $count -> [one] Sie haben { $count } neue E-Mail. *[other] Sie haben { $count } neue E-Mails. } -brand-name = Firefox about = Über { -brand-name }
$ kaeris check --source en.ftl --langs de ✓ de: complete & placeholder-safe ✓ all locales complete & placeholder-safe
KAERIS が行うこと
構造を保持
メッセージ、用語、属性、選択バリアントは同じ形で読み書きされます。
参照をカウント
失われた
{ $name }や{ -term }はモデルなしで検出されます。この形式の無料チェック
無料チェックページの/checkはこの形式を読み込み、キーやアカウントなしで実行できます。ターミナルコマンド
kaeris checkも同様に読み込みます:kaeris 0.2.35以降の13形式すべてに対応し、同じルールでどこにも送信しません。
3ステップで実行する
CLIをインストールする
pip install kaerisを実行します。ファイルを翻訳する
kaeris translate locales/en/app.ftl --langs de,jaを実行します。結果をチェックする
無料チェックページにソースと翻訳済みの.ftlファイルをアップロードしてください。
pip install kaeris kaeris translate locales/en/app.ftl --langs de,ja --verify
よくある質問
選択式はサポートされていますか?
はい。各バリアントは個別に翻訳され、構造はそのまま書き戻されます。
-brand-nameのような用語はどうなりますか?
用語は独立したエントリで、ソースと比較されます。翻訳に含まれていない場合は欠落キーとして報告されます。
無料ですか?
はい、アカウントなしで:ファイルあたり 10,000 文字、実行あたり最大 8 言語。無料の API キーでファイル制限が 50,000 文字に引き上げられます。一度限りの生涯プランは 79 ドルで、ご自身の OpenRouter キーを使用します。月額プランは 19 ドルから。 料金
ターミナルや CI から実行できますか?
はい。pip install kaerisを実行し、次にkaeris translate locales/en/app.ftl --langs de,jaを実行します。GitHub Actionはプルリクエストで同じ翻訳を実行します。CLIドキュメント · GitHub Action
続ける
CLIリファレンス · チェックリファレンス · ブラウザで翻訳 · 無料チェック · フォーマット変換 · 疑似ローカリゼーション
その他のフォーマット:JSON · YAML · .po · ARB · XLIFF · .strings · .xcstrings · .properties · .resx · CSV · Markdown · Android XML