# 翻訳

{% hint style="info" %}
のみ [組織の管理者](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/akaunto/member-management/roles#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%2FhOOp6fNMYks6U4M6UXTO%2FCreate%20translation%402x.png?alt=media&#x26;token=a142a9cd-6ecd-49c4-9670-2226897afc1f" alt=""><figcaption></figcaption></figure>

## 翻訳の仕組み

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

## 自動翻訳を設定する

スペースを新しい言語に翻訳するには、まず新しい [スペース](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/creating-content/content-structure/space#create-a-space) を組織内に作成します。表示されるモーダルで、 **翻訳** をクイックアクションメニューからクリックします。

表示されるモーダルで、次のいずれかを選択する必要があります：

* ソース
* ソース言語
* 対象言語

これらのオプションは、スペースを組織内の複製された翻訳済みスペースに翻訳するために使用されます。また、スペースの翻訳にかかるコストの概要も表示されます。

### 詳細設定

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

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

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

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

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

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

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

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

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

サイト設定の構成タブに移動して、ある翻訳に対する新しいバリアントを設定してください。

## 料金

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

* 最大50,000語までの翻訳で$25
* 追加1,000語ごとに$0.20

毎月、50,000語分の翻訳が$25に含まれます。それ以降は、追加の1,000語ごとに$0.20かかります。50,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-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/publishing-documentation/customization/extra-configuration#localize-user-interface) してください。 [特定のバリアント](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/publishing-documentation/customization#customizing-sites-with-multiple-sections).
  * これには、お知らせバナーなどのユーザー入力によるカスタマイズが含まれます。
* 翻訳では、ヒントや、ページがAIによって翻訳されたことを示すバナーのような追加コンテンツをページに追加することはできません。これを示すには、翻訳済みスペースに追加のページを作成するか、サイトバリアントの [お知らせバナー](https://gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs/documentation/ja-gitbook-documentation/publishing-documentation/customization/layout-and-structure#announcement-premium-and-ultimate) の使用を検討してください。
* 用語集を変更すると、すべてのページの完全な再翻訳がトリガーされ、処理時間とコストが増加する可能性があります。現時点では、用語集の使用状況に基づく部分的な再翻訳はできません。

</details>

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