> 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-agent/translations.md).

# 翻訳

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

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

<figure><img src="/files/eafbb5d2e39f81847895d67ead233ecc73ae1d4b" alt=""><figcaption></figcaption></figure>

## 翻訳の仕組み

* **翻訳セクションを作成する：** 既存のセクションの翻訳として、新しいセクションを設定します。ソースとなるセクションとターゲット言語を選択してください。
* **継続的な更新：** ソースコンテンツを変更するたびに、翻訳ワークフローは次のものに対してのみ実行されます： **変更されたページ**.
* **自動同期：** 変更がマージされた後、翻訳ワークフローは **自動的に実行されます** し、ソースと同期するため、翻訳済みセクションには常に最新の更新内容が反映されます。

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

## 自動翻訳を設定する

セクションを新しい言語に翻訳するには、組織に戻って **ホーム** 、 **翻訳** をサイドバーで選択し、次にクリックします **翻訳を作成**.

この **翻訳を作成** モーダルで、次を選択します：

* **ソース** — 翻訳したいセクション
* **から** 言語
* **へ** 言語

クリック **作成** 翻訳ワークフローを開始します。これらのオプションは、組織内でセクションを複製した翻訳済みセクションに翻訳するために使用されます。

この **翻訳** 画面には、設定済みの翻訳ワークフローも一覧表示され、ステータス、ソース、実行回数、翻訳済みページと単語数が含まれます。ワークフローは、ソースコンテンツが更新されるたびに再実行されます。

### 詳細設定

クリック **詳細な手順を表示** この **翻訳を作成** モーダルでこれらのオプションを設定します。

**カスタムAI指示：** AIにトーン、文体、その他の好みを指示する詳細なガイダンスを追加します。これにより、翻訳がブランドや対象読者に合うようになります。

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

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

**用語集のサポート：** 特定の用語をどのように翻訳するかを制御するために用語集を定義します。これにより、対応しているすべての言語で用語が一貫します。

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

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

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

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

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

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

## 料金

翻訳は有料の **月額** 追加機能です：

* 翻訳済み最大50,000語まで25ドル
* 追加1,000語ごとに0.20ドル

各月には、25ドルで50,000語分の翻訳が含まれます。その後は、追加1,000語ごとに0.20ドルかかります。50,000語の上限は毎月の初めにリセットされます。

最初の翻訳では、すべての単語が請求対象になります。その後は、 **ページ** の新規または更新された単語のみが課金対象です。たとえば、後でドキュメントを編集しても、新しい単語が含まれるページだけが単語上限にカウントされ、文書全体に対して再請求されることはありません。

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

## よくある質問

<details>

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

* **手間のかからない多言語ドキュメント：** 手動翻訳作業なしで、世界中のユーザーに届けられます。
* **スマートな更新：** 変更されたページのみが再翻訳されるため、時間とリソースを節約できます。
* **完全なコントロール：** 詳細な指示と用語集管理で翻訳をカスタマイズできます。

</details>

<details>

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

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

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

その回避策として、次の流れをおすすめします：

* AIに使わせたい特定の翻訳を定義するために用語集を使います
* カスタム指示を使って出力を反復改善します

</details>

<details>

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

作成すべきなのは **言語ごとに1つの翻訳ワークフローだけです** です。1つのソースコンテンツに対して複数のワークフローを作成すると、組織内で追加の重複コストが発生します。

</details>

<details>

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

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

</details>

自動翻訳の開始方法についてサポートが必要な場合や、設定について詳しく知りたい場合は、 [サポートチームまでお問い合わせください](https://gitbook.com/docs/help-center/further-help/how-do-i-contact-support).


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.