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

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

## 概要 [#overview]

| トピック                  | 説明                                        |
| --------------------- | ----------------------------------------- |
| [設定](#config)         | ソースおよび翻訳後の `.lottie` ファイルのパスを設定します。       |
| [翻訳ワークフロー](#workflow) | 非同期処理をstageし、完了したアニメーションをdownloadします。        |
| [レイアウト処理](#layout)    | アニメーションのデザインを維持しながら、翻訳テキストを収めます。          |
| [式](#expressions)     | 翻訳前に実行可能な After Effects の式を削除します。         |
| [フォント](#fonts)        | 翻訳後のレイアウト処理で使用するフォントをアップロードします。           |
| [バイナリ出力](#binary)     | base64 での転送とデコード済みの `.lottie` ファイルを処理します。 |

## 設定 [#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) を使用するよう案内して終了します。

## レイアウト処理 [#layout]

レイアウト処理では、アニメーションのフォントサイズを維持します。翻訳後のラベルが収まるようにテキストを再配置し、周辺のレイヤーを調整します。それでもラベルが収まらない場合は、意味を保ったまま対象言語で短縮または言い換えることがあります。省略記号を付けた切り詰めは最後のフォールバックです。

等幅テキストとしてスタイル設定されたコードトークンは、短縮も言い換えも行われません。文章形式のコメントは、収まるように言い換えられることがあります。

レイアウトの変更をレンダリングして検証できない場合、未検証の変更は適用されず、基本の翻訳済みアニメーションでジョブが完了します。公開前に、ダウンロードしたアニメーションを確認してください。

## 式 [#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 データを手動で編集したりしないでください。

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.