# gt: General Translation CLI tool: Lottie
URL: https://generaltranslation.com/ja/docs/cli/reference/formats/lottie-files.mdx
---
title: Lottie
description: General Translation CLI を使用して dotLottie アニメーションファイルを翻訳します。Lottie ファイル形式の API リファレンス。

---

CLI は、バイナリ形式の dotLottie (`.lottie`) アニメーションファイル内のテキストを翻訳し、結果ごとに完全な `.lottie` ファイルとして書き出します。Lottie ジョブには非同期のレイアウト処理フェーズがあるため、stage と download に分かれたワークフローを使用します。

## 設定 [#config]

`files` の下に、glob パターンの `include` 配列を含む `lottie` エントリを追加します。CLI がソースアニメーションを見つけ、各対象ロケールの下に翻訳済みファイルを保存できるように、`[locale]` プレースホルダーを使用します。

```json title="gt.config.json"
{
  "defaultLocale": "en",
  "locales": ["es", "fr"],
  "files": {
    "lottie": {
      "include": ["animations/[locale]/**/*.lottie"],
      "exclude": ["animations/[locale]/drafts/**"]
    }
  }
}
```

この設定では、ソースアニメーションは `animations/en/` にあり、翻訳済みのアニメーションは `animations/es/` と `animations/fr/` に保存されます。共通のファイルキーについては、[設定リファレンス](/docs/cli/reference/config#files)を参照してください。

## 翻訳ワークフロー [#workflow]

アニメーションを送信するには、[`gt stage`](/docs/cli/reference/commands/stage) を実行します。その後、すべてのロケールの処理が完了するまで [`gt download`](/docs/cli/reference/commands/download) を実行します。

```bash
npx gt stage
npx gt download
```

まだ処理中の翻訳はスキップされます。後で [`gt download`](/docs/cli/reference/commands/download) を再実行して取得してください。ステージ済みのエントリは、設定されているすべてのロケールがダウンロードされるまで `gt-lock.json` に残ります。

[`gt translate`](/docs/cli/reference/commands/translate) では、ステージされていない Lottie ジョブを1回の実行で完了することはできません。`stageTranslations` が `false` で、config に Lottie ファイルが含まれている場合は、[`gt stage`](/docs/cli/reference/commands/stage) と [`gt download`](/docs/cli/reference/commands/download) を使用するよう案内して終了します。

## 式 [#expressions]

After Effects の式を含む Lottie ファイルは、実行可能な JavaScript を含むため拒否されます。式を削除するかキーフレームにベイクしてアニメーションを再エクスポートし、再度 stage してください。

## フォント [#fonts]

アニメーションでレイアウト処理時に利用できない可能性のあるフォントを使用する場合は、トップレベルの[`fonts`](/docs/cli/reference/config#fonts)設定を追加します。

```json title="gt.config.json"
{
  "fonts": {
    "include": ["public/fonts/**/*.{ttf,otf}"]
  }
}
```

CLI は翻訳ジョブをキューに追加する前に、該当するフォントをアップロードします。フォントを同期できない場合でも、代替フォントを使用して翻訳を続行し、警告を出力します。

## バイナリ出力 [#binary]

CLI は内部で `.lottie` ファイルを base64 として扱い、ダウンロードした結果をバイナリファイルにデコードします。ダウンロードしたコンテンツを UTF-8 テキストとして扱ったり、中間の base64 データを手動で編集したりしないでください。