# gt: General Translation CLI tool: MDX と Markdown
URL: https://generaltranslation.com/ja/docs/cli/reference/formats/mdx-md-files.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: General Translation CLI で MDX ファイルと Markdown ファイルを翻訳します。MDX および Markdown ファイル形式の API リファレンスです。

CLI は MDX (`mdx`) ファイルと Markdown (`md`) ファイルを翻訳します。ソースファイル内のすべての構文と書式は、翻訳後でもそのまま保持されます。

## 概要 [#overview]

| トピック                          | 説明                                  |
| ----------------------------- | ----------------------------------- |
| [設定](#config)                 | ソースファイルと翻訳後の出力パスを選択します。             |
| [カスタム見出し ID](#heading-ids)     | 明示的な見出しアンカーを保持します。                  |
| [静的データのエクスポート](#data-exports) | 対象のエクスポートでは、変更されていない文字列を再利用します。     |
| [翻訳後のファイル名](#transform)       | `transform` を使用して出力ファイル名を再マッピングします。 |
| [リンクとアセット](#localize)         | URL、インポート、相対アセットをローカライズします。         |

## 設定 [#config]

`files` の下に、glob パターンを指定した `include` 配列を持つ `mdx` または `md` のエントリを追加します。CLI がソースファイルを見つけて翻訳を正しいパスに保存できるよう、`[locale]` プレースホルダーを使用してください。

```json title="gt.config.json"
{
  "defaultLocale": "en",
  "locales": ["ja"],
  "files": {
    "mdx": {
      "include": ["content/docs/[locale]/**/*.mdx"],
      "transform": "*.[locale].mdx"
    }
  }
}
```

これにより、`content/docs/en` 配下のすべての MDX ファイルが翻訳され、結果は `content/docs/ja` に保存されます。Markdown ファイルには、代わりに `md` キーを使用してください。すべてのファイルキーについては、[設定リファレンス](/docs/cli/reference/config#files)を参照してください。

## カスタム見出し ID [#heading-ids]

Mintlify 形式の `{#id}` サフィックスは、翻訳後も見出しに付いたまま保持されます:

```markdown
## クライアントを設定する {#configure-client}
```

明示的な見出し ID を使用するには `gt` 2.17.3 以降が必要です。

`experimentalAddHeaderAnchorIds` を `'mintlify'` に設定すると、CLI は翻訳後のすべての見出しに Mintlify ネイティブの `{#id}` 構文を書き込み、ソース見出しの ID を再利用します。Mintlify は先頭のスペースが 3 個以下の見出しでのみサフィックスを認識するため、JSX 内にネストされた見出しは必要に応じて左端へ移動されます。このモードには `gt` 2.20.4 以降が必要です。

## 静的データのエクスポートを更新する [#data-exports]

更新された MDX ファイルに静的データのエクスポートが含まれている場合、General Translation は以前の翻訳から一致する文字列を再利用し、新規または変更された文字列だけを翻訳します。この再利用は、チャンク内でエクスポートされるすべての変数が、静的な文字列、数値、bigint、boolean、`null` のリテラル、配列、プレーンオブジェクトのみを含む場合に適用されます。TypeScript のアサーションラッパーがサポートされています。

スプレッド、識別子、関数呼び出し、テンプレートリテラル、JSX、または計算されたオブジェクトキーを含むエクスポートでは、通常の翻訳処理が使われます。[`gt translate --force`](/docs/cli/reference/commands/translate) を実行する場合や用語集の翻訳を適用する場合も、この増分的な再利用は行われません。

## 翻訳済みファイル名の変更 [#transform]

`transform` キーは、出力ファイル名を再マッピングします。上の例では、`*.[locale].mdx` によって翻訳後の拡張子が `.ja.mdx` に変わります。これは、ドキュメントフレームワークがディレクトリパスではなくファイル名にロケールを含めることを前提としている場合に使用します。

## リンクとアセットをローカライズする [#localize]

いくつかの実験的な [`gt translate`](/docs/cli/reference/commands/translate#experimental) フラグは、`md` および `mdx` の出力にのみ適用されます。

* `--experimental-localize-static-urls` — 翻訳後内の URL をローカライズします。
* `--experimental-localize-static-imports` — 翻訳後内の静的インポートをローカライズします。
* `--experimental-localize-relative-assets` — 翻訳後内の相対画像アセット URL を書き換えます。
* `--experimental-hide-default-locale` — ローカライズされたパスからデフォルトロケールを非表示にします。

## Sitemap

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