Typemark Documentation

言語

ドキュメントを複数の言語で公開できます。それぞれ独自のアドレスを持ち、読者向けの言語ピッカーも備えます。すべてのプランで利用できます。

2026年11月19日更新

サイトを複数の言語で公開できます。各翻訳は、翻訳元のページの隣に置かれたMDXファイルです。読者はサイトのヘッダーから言語を切り替えられ、検索エンジンはすべてのバージョンを見つけられます。言語はすべてのプランで利用できます。ProプランとEnterpriseプランでは、AIで翻訳を作成し、最新の状態に保つこともできます。

言語を追加する

設定 > 言語 で、プロジェクトのオーナーがページを書いている言語を設定し、その後ほかの言語を追加します。

  1. デフォルトの言語 の下で、ページが書かれている言語のコードと名前をチェックします。言語を設定していないサイトは英語になります。
  2. 言語を追加 をクリックし、fr のようなコードを入力します。Typemark はその言語での名前を自動で入力します。この名前は変更できます。実在する言語コードでないコードは受け付けられません。
  3. 翻訳者 の下で、すべてのページをAIで翻訳する場合は AI を(ProプランとEnterpriseプラン)、自分たちで翻訳を書く場合は チーム を選択します。
  4. 言語を保存 をクリックします。Typemark は一覧を typemark.json に保存し、サイトを再ビルドします。

保存済みの言語のコードは変更できません。変更するには、言語を削除してから追加し直してください。言語を削除すると、その翻訳は公開されなくなります。翻訳のファイルはリポジトリに残ります。

設定 は typemark.json の languages 一覧に書き込みます。直接編集することもできます。ページを書いている言語を最初に置いてください。

"languages": [
  { "code": "en", "name": "English" },
  { "code": "fr", "name": "Français" },
  { "code": "pt-BR", "name": "Português (Brasil)" }
]
キー役割
codefr、pt-BR、zh-Hans などの言語コードです。アドレスの一部になります。例: /fr/quickstart
name言語ピッカーに表示される名前です。50文字まで指定できます。Français のように、その言語自身の表記で書いてください。
defaultページを書いている言語に true を指定します。指定がない場合は、最初の言語がデフォルトになります。
translate"ai" にすると、すべてのページをこの言語にAIで翻訳します(ProプランとEnterpriseプラン)。デフォルトの "manual" では翻訳を自分で行います。AI翻訳を参照してください。

言語は最大30件まで登録できます。Typemark が使用できないエントリ(同じコードが重複している、名前がない言語など)は除外され、公開時にプロジェクトの概要に警告として表示されます。

typemark.json は、接続済みのリポジトリで編集するか、Typemark がホストしているプロジェクトであれば CLI で編集してください。設定 > 言語 では、使用できないエントリが警告として表示され、保存するとそれらは削除されます。

言語コード

コードは実在する言語コードです。言語、必要に応じてスクリプトと地域の順で構成されます。例として fr、pt-BR、zh-Hans、es-419、sr-Latn-RS があります。Typemark は各部分を IANA言語サブタグレジストリと照合します。

  • 設定 > 言語 は、zz やタイプミスなど、実在しないコードを受け付けません。入力欄の下にその旨が表示されます。古いコードの場合は現在のコードを示します。例えば iw は現在 he です。
  • typemark.json にある、Typemark が認識しないコードも引き続き公開されます。その際、公開時にプロジェクトの概要に警告が表示されます。他の変更を保存したときは、設定 でも注記付きで残ります。
  • コードは書かれたとおりに完全一致で照合されます。そのため、typemark.json とフォルダ名では同じコードを使ってください。
  • mcp と ai-search はコードに使えません。どのサイトもすでにこれらのアドレスを使用しているためです。

デフォルトの言語

既存のページはデフォルトの言語になります。/quickstart などのアドレスはそのまま維持され、内容も変わりません。

languages を設定していないサイトは英語です。言語を1つだけ登録したサイトは、全体がその言語で表示されます。ページの lang 属性と検索もその言語を使い、言語ピッカーは表示されません。

翻訳の配置場所

翻訳は、翻訳元のページと同じパスを持ち、言語コードという名前のフォルダの中に置かれます。

ページフランス語の翻訳アドレス
quickstart.mdxfr/quickstart.mdx/fr/quickstart
guides/authentication.mdxfr/guides/authentication.mdx/fr/guides/authentication

docs_root を設定している場合、言語フォルダはその内側に置きます。例: docs/fr/quickstart.mdx。その言語のホームページは /fr になります。

翻訳は、独自のフロントマター(翻訳された title と description)と、その言語で書かれた本文を持つ完全なページです。手動で作成するには、ページのファイルを言語フォルダにコピーして翻訳します。リポジトリ上で行うことも、CLIを使うこともできます。エディターでは、言語スイッチャーからそのページにすでにある翻訳を開けます。

読者に表示されるもの

  • 言語ピッカー はサイトのヘッダーに表示され、登録した言語を一覧にします。選んだ言語で、現在のページの対応するページを開きます。Typemark がブラウザの設定から言語を選ぶことはありません。
  • どの言語でも同じナビゲーション。 タブ、グループ、その並び順は navigation から決まります。各ページのタイトルは、翻訳がある場合は読者の言語になります。タブとグループの名前は、翻訳を設定している場合は翻訳されます。
  • サイト自体も読者の言語で表示されます。 「このページの内容」、検索、ページ操作メニュー、Ask AI、「このページは役に立ちましたか?」、前へ・次へ、日付、404ページは、読者の言語で表示されます。サイト自体の文言を参照してください。
  • どの言語でもすべてのページが表示されます。 翻訳がないページは、その言語のアドレスでデフォルトの言語のページを表示します。そのため、/fr/billing は翻訳前でも動作し、ナビゲーションに欠けが出ることはありません。
  • 読者の言語でのリンク。 フランス語のページで /quickstart へのリンクは、フランス語の翻訳が公開されると /fr/quickstart に移動します。公開されるまでは /quickstart のままです。デフォルトのアドレスへのリンクは通常どおり書いてください。Typemark はページを配信するときにリンクを調整し、ファイルは変更しません。アンカー、他サイトへのリンク、/llms.txt などのファイル、言語をすでに指定しているリンク(/de/setup)は、書かれたままになります。
  • 読者の言語での検索。 フランス語のページで検索すると、フランス語の翻訳と、まだ翻訳がないデフォルトの言語のページが見つかります。検索は、Typemark が対応している言語では、その言語の語形変化のルールを使います。そのため、単語の異なる形も一致します。その他の言語では、書かれたとおりに一致します。各言語の対応状況を参照してください。
  • どの言語でもリダイレクト。 /old から /new へのリダイレクトは、/fr/old から /fr/new へも転送されます。

各言語の対応状況

どの言語にも、独自のアドレス、言語ピッカー、翻訳されたナビゲーション、hreflang リンクが用意されます。一部の機能は言語によって異なります。

機能対応言語
サイト自体の文言英語、ドイツ語、フランス語、スペイン語、ポルトガル語、日本語、エストニア語。その他の言語では英語で表示されます。
単語の異なる形も一致させる検索アラビア語、デンマーク語、オランダ語、英語、フィンランド語、フランス語、ドイツ語、ギリシャ語、ハンガリー語、インドネシア語、アイルランド語、イタリア語、リトアニア語、ネパール語、ノルウェー語、ポルトガル語、ルーマニア語、ロシア語、スペイン語、スウェーデン語、タミル語、トルコ語。その他の言語(エストニア語、日本語、中国語、韓国語など)は、書かれたとおりに一致します。
AI翻訳AIモデルが書ける任意の言語。ProプランとEnterpriseプラン。

アラビア語、ヘブライ語、ペルシア語、ウルドゥー語などの右から左に書く言語は、まだサポートしていません。公開はできますが、レイアウトは左から右のままです。

サイト自体の文言

翻訳されたページでは、サイトが表示するすべての文言が読者の言語になります。目次、検索、ページ操作メニュー、「このドキュメントをAIで使う」カード、Ask AIのパネル、フィードバックウィジェット、前へ・次へ、「更新日」と読了時間、モバイルメニュー、「Powered by Typemark」、404ページ、非公開サイトのサインインフォームが含まれます。

Typemark は、英語、ドイツ語、フランス語、スペイン語、ポルトガル語、日本語、エストニア語の文言を持っています。地域コードは、その言語の文言を使います。例えば pt-BR はポルトガル語、es-419 はスペイン語になります。その他の言語は英語で表示されます。製品名、MCP、llms.txt、Markdownはそのままです。

タブ、グループ、リンク名の翻訳

タブとグループの名前、トップナビゲーションのリンク、フッターのリンクは、typemark.json から取得されます。言語ごとの翻訳は translations.labels の下に、書いたとおりの名前をキーとして設定します。

"translations": {
  "labels": {
    "fr": { "Get started": "Premiers pas", "Guides": "Guides", "Status": "État du service" },
    "de": { "Get started": "Erste Schritte" }
  }
}

翻訳がない名前は書いたとおりに表示されます。デフォルトの言語のページは、常に書いたとおりの名前を表示します。翻訳は名前をキーとしているため、グループを移動しても翻訳は保たれます。名前を変更した場合は、新しい翻訳が必要です。AIが翻訳する言語では、AIが未翻訳の名前を補い、書かれた名前は変更しません。

検索エンジン

  • すべてのページは <html lang> に言語を設定します。
  • 各ページは、ほかの言語のバージョンを hreflang リンクで示します。さらに、デフォルトの言語には x-default を付けます。そのページ独自の翻訳がある言語だけが列挙され、非表示のページは何も列挙しません。
  • サイトマップには、各翻訳が同じ代替リンクとともに記載されます。
  • 翻訳のアドレスでデフォルトの言語が表示されるページは、正規URLとしてデフォルトのページを検索エンジンに示します。これにより、同じテキストが二重にインデックスされることを防ぎます。

デフォルトの言語のままになるもの

エディターで

複数の言語を持つサイトでは、エディターの上部バーに、ビジュアル と ソース の横に言語スイッチャーが表示されます。現在のページを別の言語で開きます。翻訳がまだない言語はグレーアウトされます。翻訳は通常のページと同じように保存されます。

デフォルトの言語のページは、名前の変更、移動、削除ができます。翻訳の名前を変更または削除するには、リポジトリ上で、またはCLIを使ってファイルを変更してください。

エディターでは、リンクは書かれたとおりに表示されます。プレビュー を開くと、ページがサイト上で表示され、リンクはそのページの言語になります。

公開前の確認

typemark dev を使うと、手元のコンピューターで全言語をプレビューできます。言語ピッカー、翻訳されたページとラベル、読者の言語のリンクを確認できます。

typemark check は、公開時と同じように languages を読み取り、/fr/<page> へのリンクをそのページへのリンクとして扱います。

ルール重大度意味
config-languagesエラーTypemark が除外する言語エントリです。言語コードの形式でない、または重複しているコードなどが該当します。
language-code警告zz やタイプミスなど、実在する言語コードではないコードです。それでも公開されます。
config-translations警告"ai" でも "manual" でもない translate、リストではない translations.do_not_translate、または言語ごとの名前のオブジェクトではない translations.labels を指します。
languages-single警告languages に言語が1つだけあります。そのためサイト全体がその言語になり、言語ピッカーはありません。デフォルトの言語を最初に置き、その後にほかの言語を並べてください。
language-folder警告navigation にあるページが、fr/intro のように言語のフォルダ内にあります。/fr/intro は intro のフランス語版として扱われるため、読者はこのページに到達できません。フォルダの外へ移動してください。
translation-unlisted警告navigation にないページの翻訳です。そのため公開されません。