Typemark Documentation

AI翻訳

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

2026年11月19日更新

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

有効にする

  1. 言語を追加する

    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" }
    ]
  2. 変更を公開する

    設定は保存時に公開されます。typemark.json を編集した場合は、デプロイブランチにプッシュするか、typemark push を使用してください。公開後、Typemark は1ページずつ翻訳を開始し、完了するたびにそれをコミットします。

  3. 翻訳を確認する

    エディターでページを開き、上部バーの言語切り替えから言語を選びます。各言語には翻訳のステータスが表示されます。

言語ごとに組み合わせることもできます。一部の言語は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 プロバイダーに送信します。プロバイダーには、データを保存または学習に使用しないモデルプロバイダーにのみリクエストをルーティングするよう要求しています。