AI翻訳
AIにすべてのページを他の言語へ翻訳させ、ドキュメントの変更に合わせて各翻訳を最新に保ちます。Pro と Enterprise で利用できます。
2026年11月19日更新
言語でAI翻訳をオンにすると、Typemark はすべてのページをその言語に翻訳し、ページが変更されるたびに再翻訳します。翻訳は、リポジトリ内の通常の MDX ファイルです。読んだり、編集したり、手で書き直したりでき、Typemark は誰かが編集した翻訳を上書きすることはありません。AI翻訳は Pro と Enterprise で利用でき、プロジェクトオーナーのプランに従います。
有効にする
言語を追加する
Settings > Languages で Add a language をクリックし、言語コードを入力して、Translated by で AI を選び、Save languages をクリックします。その他の設定については Languages を参照してください。
または、
typemark.jsonのlanguagesに"translate": "ai"を指定して言語を追加します:"languages": [ { "code": "en", "name": "English" }, { "code": "fr", "name": "Français", "translate": "ai" }, { "code": "de", "name": "Deutsch", "translate": "ai" } ]変更を公開する
設定は保存時に公開されます。
typemark.jsonを編集した場合は、デプロイブランチにプッシュするか、typemark pushを使用してください。公開後、Typemark は1ページずつ翻訳を開始し、完了するたびにそれをコミットします。翻訳を確認する
エディターでページを開き、上部バーの言語切り替えから言語を選びます。各言語には翻訳のステータスが表示されます。
言語ごとに組み合わせることもできます。一部の言語はAIで翻訳し、他は手作業で翻訳できます(デフォルトは "translate": "manual" です)。
用語をそのまま残す
翻訳してはならない製品名、機能名、その他の用語は、Settings > Languages > Terms AI keeps as written に1行に1つずつ入力するか、translations.do_not_translate に指定します。各用語は100文字以内で、最大200件まで指定できます:
"translations": {
"do_not_translate": ["Acme Pay", "Workspace", "acme.config.json"]
}
AIは本文とコンポーネントのプロパティにおいて、これらを指定どおりに書きます。Typemark は翻訳を保存する前に、すべての用語が維持されているかを確認します。
トーンを設定する
AI翻訳は AI writing と同じ指示に従います。これは 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 リファレンスのページ も翻訳されません。
タブ、グループ、リンクの名前
AIは typemark.json 内のサイトの名前も翻訳します。対象はタブ、グループ、トップナビゲーションのリンク、フッターのリンクです。翻訳は、その言語の translations.labels に書き込まれます(Languages を参照)。コミットは Typemark AI によって行われ、do_not_translate の用語は維持されます。
翻訳がまだない名前だけを埋めます。あなたが書いた、または編集した名前が変更されることはありません。ある言語で名前をそのまま残したい場合は、空の翻訳("Changelog": "")を指定してください。AI はそれには触れません。グループ名を変更すると、AI は新しい名前を翻訳し、古い名前に対する自身の翻訳を削除します。
翻訳の保存先
翻訳は、手書きの翻訳と同じ場所に保存されます。quickstart.mdx の翻訳は fr/quickstart.mdx になります。docs_root がある場合はその中に保存されます。各翻訳は独立したコミットになり、「Translate quickstart into Français」のような名前で Typemark AI によって作成されます。接続済みのリポジトリ では、エディターでの保存と同様に 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 を選びます。編集内容を含めて翻訳が置き換えられ、月間上限に計上されます。エディターとプロジェクトオーナーが再翻訳できます。
読者が見る前に確認する
手動デプロイモードでは、新規および更新された AI 翻訳は、あなたの編集と同様に、誰かが Publish をクリックするまで保留されます。先にエディターで確認でき、Publish が確認の工程になります。自動デプロイモードでは、各翻訳はビルドされるとすぐに公開されます。
翻訳が実行されるタイミング
AI はデプロイブランチにあるものを翻訳します。エディターでの保存、デプロイブランチへのプッシュ、または typemark push の後に実行されます。
プレビューデプロイメントやエディター内のブランチは決して翻訳されません。ブランチは既存の翻訳を保持し、そのページはマージされた後に翻訳されます。エディターがブランチ上にある間は Re-translate は提供されません。
上限
AI は、オーナーのすべてのサイトと言語を合わせて、月に最大2,000ページを翻訳します。3言語に翻訳したページは3回として数えられ、更新のたびにも同様に数えられます。言語のタブ、グループ、リンクの名前の翻訳は1ページとして数えられます。上限に達すると、AI は翻訳を停止し、翌月の1日まで再開しません。すでに公開されている翻訳はそのまま残り、翻訳がないページは、それまでデフォルト言語を表示します。
オーナーのプランが変わった場合
AI翻訳はプロジェクトオーナーのプランに従います。オーナーが Free に変更すると、公開済みの翻訳はサイト上に残りますが、AI は新規および変更されたページの翻訳を停止し、Re-translate は利用できなくなります。翻訳は引き続き手作業で編集できます。再度アップグレードすると、AI は中断したところから再開します。
あなたのコンテンツ
Typemark は、AI writing と同じ方法で、ページと上記の指示を AI プロバイダーに送信します。プロバイダーには、データを保存または学習に使用しないモデルプロバイダーにのみリクエストをルーティングするよう要求しています。