# AI翻訳

> AIにすべてのページを他の言語へ翻訳させ、ドキュメントの変更に合わせて各翻訳を最新に保ちます。Pro と Enterprise で利用できます。

言語でAI翻訳をオンにすると、Typemark はすべてのページをその言語に翻訳し、ページが変更されるたびに再翻訳します。翻訳は、リポジトリ内の通常の MDX ファイルです。読んだり、編集したり、手で書き直したりでき、Typemark は誰かが編集した翻訳を上書きすることはありません。AI翻訳は Pro と Enterprise で利用でき、プロジェクトオーナーのプランに従います。

## 有効にする

<Steps>
  <Step title="言語を追加する">
    **Settings** > **Languages** で **Add a language** をクリックし、言語コードを入力して、**Translated by** で **AI** を選び、**Save languages** をクリックします。その他の設定については [Languages](https://docs.typemark.dev/ja/configuration/languages) を参照してください。

    または、[`typemark.json`](https://docs.typemark.dev/configuration/typemark-json) の `languages` に `"translate": "ai"` を指定して言語を追加します:

    ```json title="typemark.json"
    "languages": [
      { "code": "en", "name": "English" },
      { "code": "fr", "name": "Français", "translate": "ai" },
      { "code": "de", "name": "Deutsch", "translate": "ai" }
    ]
    ```
  </Step>
  <Step title="変更を公開する">
    設定は保存時に公開されます。`typemark.json` を編集した場合は、デプロイブランチにプッシュするか、`typemark push` を使用してください。公開後、Typemark は1ページずつ翻訳を開始し、完了するたびにそれをコミットします。
  </Step>
  <Step title="翻訳を確認する">
    エディターでページを開き、上部バーの言語切り替えから言語を選びます。各言語には翻訳の[ステータス](#statuses-in-the-editor)が表示されます。
  </Step>
</Steps>

言語ごとに組み合わせることもできます。一部の言語はAIで翻訳し、他は手作業で翻訳できます(デフォルトは `"translate": "manual"` です)。

## 用語をそのまま残す

翻訳してはならない製品名、機能名、その他の用語は、**Settings** > **Languages** > **Terms AI keeps as written** に1行に1つずつ入力するか、`translations.do_not_translate` に指定します。各用語は100文字以内で、最大200件まで指定できます:

```json title="typemark.json"
"translations": {
  "do_not_translate": ["Acme Pay", "Workspace", "acme.config.json"]
}
```

AIは本文とコンポーネントのプロパティにおいて、これらを指定どおりに書きます。Typemark は翻訳を保存する前に、すべての用語が維持されているかを確認します。

## トーンを設定する

AI翻訳は [AI writing](https://docs.typemark.dev/ja/editor/ai-writing#tell-ai-how-you-write) と同じ指示に従います。これは **Settings** > **AI writing** に書いた内容で、`ai.instructions` として保存されます。丁寧さの度合い、読者への呼びかけ方(「tu」か「vous」か)、使用する綴りなどを指定できます。

## 翻訳される内容

| 翻訳される | そのまま残る |
|------------|-------------------------|
| 読者が読むテキスト:見出し、段落、リスト、表、リンクのテキスト | コードブロックと `inline code` |
| フロントマターの `title`、`description`、`sidebarTitle` | フロントマターのその他のキーと値 |
| コンポーネント内のテキスト:カード、タブ、ステップ、アコーディオン、コールアウトのタイトル、説明、ラベル、画像の alt テキスト、キャプション、プレースホルダー、ヒント、チップ | コンポーネント名、プロパティ名、`href`、`src`、`icon`、`url` など、テキスト以外のプロパティ |
| | リンクと画像の参照先 |
| | `{expressions}` として書かれたプロパティ(テキストプロパティを含む) |
| | `do_not_translate` の用語 |

Typemark は翻訳を保存する前に、すべてを確認します。AI がコード、リンク、コンポーネント、フロントマターのキー、または維持すべき用語を変更していた場合、その翻訳は破棄されます。ページには既存の翻訳が残るか、翻訳がなければデフォルト言語のページが表示されます。Typemark は後で再度試みます。

40,000文字を超えるページは翻訳されません。また、OpenAPI 仕様から生成された [API リファレンスのページ](https://docs.typemark.dev/api-reference/openapi) も翻訳されません。

## タブ、グループ、リンクの名前

AIは `typemark.json` 内のサイトの名前も翻訳します。対象はタブ、グループ、トップナビゲーションのリンク、フッターのリンクです。翻訳は、その言語の `translations.labels` に書き込まれます([Languages](https://docs.typemark.dev/ja/configuration/languages#translate-tab-group-and-link-names) を参照)。コミットは **Typemark AI** によって行われ、`do_not_translate` の用語は維持されます。

翻訳がまだない名前だけを埋めます。あなたが書いた、または編集した名前が変更されることはありません。ある言語で名前をそのまま残したい場合は、空の翻訳(`"Changelog": ""`)を指定してください。AI はそれには触れません。グループ名を変更すると、AI は新しい名前を翻訳し、古い名前に対する自身の翻訳を削除します。

## 翻訳の保存先

翻訳は、手書きの翻訳と同じ場所に保存されます。`quickstart.mdx` の翻訳は `fr/quickstart.mdx` になります。`docs_root` がある場合はその中に保存されます。各翻訳は独立したコミットになり、「Translate quickstart into Français」のような名前で **Typemark AI** によって作成されます。[接続済みのリポジトリ](https://docs.typemark.dev/ja/github/sync) では、エディターでの保存と同様に GitHub にプッシュされます。

Typemark は、AI が書いたページと名前の記録を `.typemark/translations.json` に保存します。これはリポジトリに残しておいてください。Typemark はこの記録をもとに、AI のテキストとあなたの編集を区別します。

## エディターでのステータス

エディターの言語切り替えには、表示中のページごとに各AI言語のステータスが表示されます:

| ステータス | 意味 | AI の動作 |
|--------|---------------|--------------|
| **Source** | デフォルト言語。翻訳の元になる言語 | |
| **Not translated yet** | まだ翻訳がない | ページを翻訳する |
| **Translating…** | 翻訳が進行中 | |
| **Up to date** | 現在のページに対する AI の翻訳 | なし |
| **Updating soon** | ページの古いバージョンに対する AI の翻訳 | 再翻訳する |
| **Edited by hand** | 翻訳が誰かによって変更され、その後ページは変更されていない | なし |
| **Out of date** | 翻訳が誰かによって変更され、その後ページが変更された | なし。手動で更新するか、再翻訳してください。 |

## 翻訳を編集する

言語切り替えから翻訳を開き、変更して保存します。すると状態は **Edited by hand** になり、それ以降はページが変更されても AI は触れません。ページが変更されると **Out of date** と表示されるので、更新が必要だとわかります。

AI言語で自分で追加した翻訳も同様に扱われ、AI によって置き換えられることはありません。

### 再翻訳

AI の版から最初からやり直すには、翻訳を開き、言語切り替えの言語に続けて **Re-translate into** を選びます。編集内容を含めて翻訳が置き換えられ、[月間上限](#limits)に計上されます。エディターとプロジェクトオーナーが再翻訳できます。

## 読者が見る前に確認する

[手動デプロイモード](https://docs.typemark.dev/ja/configuration/publishing#manual-deploy)では、新規および更新された AI 翻訳は、あなたの編集と同様に、誰かが **Publish** をクリックするまで保留されます。先にエディターで確認でき、Publish が確認の工程になります。自動デプロイモードでは、各翻訳はビルドされるとすぐに公開されます。

## 翻訳が実行されるタイミング

AI はデプロイブランチにあるものを翻訳します。エディターでの保存、デプロイブランチへのプッシュ、または `typemark push` の後に実行されます。

[プレビューデプロイメント](https://docs.typemark.dev/ja/github/previews)や[エディター内のブランチ](https://docs.typemark.dev/ja/editor/branches)は決して翻訳されません。ブランチは既存の翻訳を保持し、そのページはマージされた後に翻訳されます。エディターがブランチ上にある間は **Re-translate** は提供されません。

## 上限

AI は、オーナーのすべてのサイトと言語を合わせて、月に最大2,000ページを翻訳します。3言語に翻訳したページは3回として数えられ、更新のたびにも同様に数えられます。言語のタブ、グループ、リンクの名前の翻訳は1ページとして数えられます。上限に達すると、AI は翻訳を停止し、翌月の1日まで再開しません。すでに公開されている翻訳はそのまま残り、翻訳がないページは、それまでデフォルト言語を表示します。

## オーナーのプランが変わった場合

AI翻訳はプロジェクトオーナーのプランに従います。オーナーが Free に変更すると、公開済みの翻訳はサイト上に残りますが、AI は新規および変更されたページの翻訳を停止し、**Re-translate** は利用できなくなります。翻訳は引き続き手作業で編集できます。再度アップグレードすると、AI は中断したところから再開します。

## あなたのコンテンツ

Typemark は、[AI writing](https://docs.typemark.dev/ja/editor/ai-writing#your-content) と同じ方法で、ページと上記の指示を AI プロバイダーに送信します。プロバイダーには、データを保存または学習に使用しないモデルプロバイダーにのみリクエストをルーティングするよう要求しています。
