> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/ja-gitbook-documentation/gitbook-jento/translations.md).

# 翻訳

GitBook Agent を使ってコンテンツを複数の言語に自動翻訳し、同期を保ちましょう

{% hint style="info" %}
翻訳を作成・利用できるのは [組織管理者](https://gitbook.com/docs/documentation/ja-gitbook-documentation/collaborate/member-management/roles.md#admin) のみです。これは [有料機能のためです](#pricing).
{% endhint %}

自動翻訳を使えば、最小限の手作業で、複数の言語でドキュメントを最新の状態に保てます。あるセクションを別のセクションの翻訳として作成し、残りは GitBook Agent に任せられます。

<figure><img src="https://4217681718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-3777238cc7776f4b7fc0f67870454e27b06d7578%2F25_12_10_create_translation%402x.png?alt=media" alt=""><figcaption></figcaption></figure>

## 翻訳の仕組み

* **翻訳セクションの作成：** 既存のセクションを翻訳した新しいセクションを作成します。翻訳元のセクションと翻訳先の言語を選択します。
* **継続的な更新：** 翻訳元のコンテンツを変更するたびに、翻訳ワークフローは **変更されたページに対してのみ実行されます**.
* **自動同期：** 変更がマージされると、翻訳ワークフローが **自動的に実行され** 、翻訳元と同期されるため、翻訳されたセクションには常に最新の更新が反映されます。

{% hint style="info" %}
自動翻訳されたセクションのページスラッグは、固定スラッグが設定されていない場合、変更されることがあります。言語間でURLを安定させるには、翻訳する前に固定スラッグを設定してください。スラッグの更新方法については、次を参照してください： [URLのスラッグを変更するにはどうすればよいですか？](https://app.gitbook.com/s/Ua3kTfM3iWAoECzM0u90/published-documentation/custom-domains/how-can-i-change-the-slug-in-the-url)
{% endhint %}

## 自動翻訳を設定する

セクションを新しい言語に翻訳するには、組織の **ホーム** に戻り、サイドバーの **翻訳** をクリックしてから、 **翻訳を作成**.

をクリックします。「 **翻訳を作成** 」ダイアログで、次の項目を選択します：

* **ソース** — 翻訳するセクションです。
* **翻訳元の** 言語。
* **翻訳先の** 言語。

「 **作成** 」をクリックして翻訳ワークフローを開始します。選択したオプションを使用してセクションが翻訳され、組織内に翻訳済みの複製セクションが作成されます。

「 **翻訳** 」画面には、設定済みの翻訳ワークフローも一覧表示されます。各ワークフローのステータス、翻訳元、実行履歴、翻訳されたページ数と単語数を確認できます。ワークフローは、翻訳元のコンテンツが更新されるたびに再実行されます。

### 詳細設定

「 **詳細な指示を表示** 」を「 **翻訳を作成** 」ダイアログでクリックすると、次のオプションを設定できます。

**カスタムAI指示：** 文調、スタイル、その他の好みについてAIに指示する詳細な指示を追加できます。これにより、翻訳をブランドや対象読者に合わせることができます。

{% hint style="info" %}
翻訳ワークフローにカスタム指示を追加すると便利な場合がありますが、いくつかのケースでは制限があります。

カスタム指示は、翻訳済みセクションに新しい要素を作成したり、追加テキストを加えたり、ソースコンテンツの構造を変更したりするためには使用できません。
{% endhint %}

**用語集のサポート：** 用語集を定義して、特定の用語の翻訳方法を指定できます。これにより、サポートされているすべての言語で用語の一貫性を保てます。

用語集の用語は、制御したいソース言語の表記と一致している必要があります。GitBook は翻訳実行時にそれらを適用して、用語の一貫性を保ちます。

例えば、翻訳元の言語が英語で、用語集に次の項目が含まれている場合： `SSO` → `SSO` と `Git Sync` → `Git Sync`、「Git Sync で SSO を設定」のような文では、これらの用語は翻訳後もそのまま保持されます。

{% hint style="warning" %}
**用語集を変更すると、コンテンツ全体が再翻訳されます**。現時点では回避策はありません。用語集のキーワードが含まれる可能性のあるページを確実に検出できないため、すべてのページを再翻訳するのが最も安全です。そのため、用語集の更新には時間と費用がかかる場合があります。
{% endhint %}

## バリアントに翻訳を追加する

翻訳を作成した後、公開済みのドキュメントサイトに [バリアント](https://gitbook.com/docs/documentation/ja-gitbook-documentation/manage-your-site/site-structure/variants.md)として追加できます。これにより、メインのドキュメントサイトを閲覧するユーザーは、右上で言語を切り替えられるようになります。

{% hint style="info" %}
ユーザーに最適な体験を提供するため、設定時にバリアントの既定言語を指定できます。

バリアントを設定する際は、翻訳済みセクションの言語を追加するのがベストプラクティスです。
{% endhint %}

翻訳用の新しいバリアントを設定するには、サイトのサイドバーで **サイト構造** を開き、構造エディターを表示します。

## 料金

翻訳は有料のアドオンです。翻訳の請求は、メインのサブスクリプションと同じ月次または年次サイクルで行われます。

* 月額料金：毎月最大50,000語までの翻訳に対して月25ドル。
* 年額料金：毎月最大50,000語までの翻訳に対して年250ドル。
* 追加1,000語ごとに0.20ドル。

月間上限は毎月初めにリセットされます。0.20ドルの料金は、年額サブスクリプションを含むすべての追加1,000語に適用されます。

「月額」は料金と語数上限を表しており、請求サイクルを表すものではありません。

最初の翻訳では、すべての単語が請求対象になります。その後は、 **ページ** 内の新規または更新された単語のみが請求対象となります。たとえば、後からドキュメントを編集した場合、新しい単語があるページのみが単語数の上限に算入され、ドキュメント全体について再度請求されることはありません。

{% hint style="warning" %}
大きなページを含む複数の翻訳を扱う場合は注意してください。翻訳語数には、変更が含まれるページ内のすべての語が含まれるため、大きなページでわずかな語だけが変更された場合でも、ページ全体が再翻訳されます。
{% endhint %}

## FAQ

<details>

<summary>自動翻訳を使う理由</summary>

* **手軽に多言語対応のドキュメントを作成：** 手作業で翻訳することなく、世界中のユーザーに情報を届けられます。
* **スマートな更新：** 変更されたページのみを再翻訳するため、時間とリソースを節約できます。
* **完全な制御：** 高度な指示や用語集の管理を使って、翻訳をカスタマイズできます。

</details>

<details>

<summary>翻訳を編集できますか？</summary>

翻訳を編集することはできません。

翻訳はソースコンテンツの純粋な変換として行われるため、翻訳結果に加えられた編集を新しい翻訳と突き合わせることはできません。

これを回避するには、次の手順をおすすめします:

* AIに使わせたい特定の訳語を用語集で定義します
* カスタム指示を使って出力を調整します

</details>

<details>

<summary>いくつの翻訳を作成する必要がありますか？</summary>

特定のソースコンテンツについては、 **言語ごとに翻訳ワークフローを1つだけ** 作成してください。複数のワークフローを作成すると、組織に重複した追加費用が発生します。

</details>

<details>

<summary>現在の制限にはどのようなものがありますか？</summary>

* 翻訳によって、バリアント内のUI要素が自動的にローカライズされることはありません。サイトのサイドバーで **カスタマイズ** を開き、 [インターフェースをローカライズ](https://gitbook.com/docs/documentation/ja-gitbook-documentation/manage-your-site/customization/extra-configuration.md#localize-user-interface) してください。対象となる [特定のバリアント](https://gitbook.com/docs/documentation/ja-gitbook-documentation/manage-your-site/customization.md#customizing-sites-with-multiple-sections-or-variants).
  * これには、告知バナーなどのユーザー入力によるカスタマイズも含まれます。
* 翻訳によって、ヒントやページがAIで翻訳されたことを知らせるバナーなど、ページに追加のコンテンツを加えることはできません。その旨を記載するページを翻訳セクションに追加するか、サイトバリアントの [お知らせバナー](https://gitbook.com/docs/documentation/ja-gitbook-documentation/manage-your-site/customization/layout-and-structure.md#announcement-premium-and-ultimate) をご検討ください。
* 用語集を変更すると、すべてのページの全面再翻訳がトリガーされ、処理時間とコストが増える可能性があります。現時点では、用語集の使用に基づく部分再翻訳はできません。

</details>

設定を始める際にサポートが必要な場合や、自動翻訳の設定について詳しく知りたい場合は、 [サポートチームにお問い合わせください](broken://pages/55ca09da2fc64db3d290bfa3cf9175afa45c2bdc).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/ja-gitbook-documentation/gitbook-jento/translations.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
