# gt: General Translation CLI tool: SRT
URL: https://generaltranslation.com/ja/docs/cli/reference/formats/srt-files.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: General Translation CLI を使用して SubRip 字幕ファイルを翻訳します。SRT ファイル形式の API リファレンスです。

CLI は、SubRip (`.srt`) 字幕ファイル内のキューテキストを翻訳します。キュー番号、タイムスタンプ、区切り文字、マークアップはそのまま保持されます。この機能を利用するには、`gt` 2.22.2 以降が必要です。

## 概要 [#overview]

| トピック                  | 説明                                         |
| --------------------- | ------------------------------------------ |
| [設定](#config)         | ソースと翻訳後の `.srt` パスを対応付けます。                 |
| [翻訳動作](#behavior)     | キュー番号、タイミング行、区切り文字、字幕マークアップを保持します。         |
| [エンコーディング](#encoding) | BOM 付きテキストエンコーディングをデコードし、元のエンコーディングに復元します。 |
| [検証](#validation)     | 空のファイルをスキップし、有効なキューが 1 つもないドキュメントを拒否します。   |

## 設定 [#config]

`files` の下に `srt` エントリを追加し、glob パターンを指定した `include` 配列を設定します。`[locale]` プレースホルダーを使用すると、CLI がソースファイルを検出し、翻訳を対応するロケールのパスに保存できます。

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

この設定では、ソースの字幕は `subtitles/en/` から読み込まれ、翻訳された字幕は `subtitles/es/` および `subtitles/fr/` の下に保存されます。出力パスの名前を変更するには [`transform`](/docs/cli/reference/config#files) を使用します。

SRT で指定できる出力形式は `SRT` のみで、`transformationFormat` を使って別のファイル形式に変換することはできません。共通のファイルキーについては、[設定リファレンス](/docs/cli/reference/config#files)を参照してください。

## 翻訳動作 [#behavior]

翻訳されるのはキューテキストのみです。パイプラインは、ソースドキュメントの以下の部分を変更せずにそのまま保持します。

* キュー番号
* 開始・終了タイムスタンプ (位置データを含む) 
* 空行による区切り文字、および有効なキュー以外のコンテンツ
* `<i>`、`<b>`、`<u>`、`<font>` などの字幕マークアップ、および先頭の `{\an1}`–`{\an9}` 位置タグ

翻訳された行には、そのキューのソースで検出された改行コードが使用されます。翻訳の対象外である区切り文字は変更されません。変更のないキューについては、再翻訳を強制しない限り、既存の翻訳が再利用されます。

## エンコーディング [#encoding]

CLI は、バイトオーダーマーク (BOM) のない SRT ファイルを UTF-8 として読み込みます。ファイルの先頭に BOM がある場合は、UTF-8、UTF-16 (リトルエンディアンまたはビッグエンディアン) 、UTF-32 (リトルエンディアンまたはビッグエンディアン) に対応しています。ダウンロードした翻訳には、ソースファイルと同じエンコーディングと BOM が使用されます。

BOM のない UTF-16 または UTF-32 ファイルは UTF-8 として扱われます。翻訳する前に、適切な BOM を付与するか、UTF-8 で保存してください。

## 検証 [#validation]

CLI は空の SRT ファイルをスキップし、コマンドのサマリーにその旨を表示します。API では、有効なタイミング行を含むキューが少なくとも 1 つ必要です。有効なタイミング行を含まないブロックは、変更も翻訳もされずにそのまま残ります。

## Sitemap

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