言語
ドキュメントを複数の言語で公開できます。それぞれ独自のアドレスを持ち、読者向けの言語ピッカーも備えます。すべてのプランで利用できます。
2026年11月19日更新
サイトを複数の言語で公開できます。各翻訳は、翻訳元のページの隣に置かれたMDXファイルです。読者はサイトのヘッダーから言語を切り替えられ、検索エンジンはすべてのバージョンを見つけられます。言語はすべてのプランで利用できます。ProプランとEnterpriseプランでは、AIで翻訳を作成し、最新の状態に保つこともできます。
言語を追加する
設定 > 言語 で、プロジェクトのオーナーがページを書いている言語を設定し、その後ほかの言語を追加します。
- デフォルトの言語 の下で、ページが書かれている言語のコードと名前をチェックします。言語を設定していないサイトは英語になります。
- 言語を追加 をクリックし、
frのようなコードを入力します。Typemark はその言語での名前を自動で入力します。この名前は変更できます。実在する言語コードでないコードは受け付けられません。 - 翻訳者 の下で、すべてのページをAIで翻訳する場合は AI を(ProプランとEnterpriseプラン)、自分たちで翻訳を書く場合は チーム を選択します。
- 言語を保存 をクリックします。Typemark は一覧を
typemark.jsonに保存し、サイトを再ビルドします。
保存済みの言語のコードは変更できません。変更するには、言語を削除してから追加し直してください。言語を削除すると、その翻訳は公開されなくなります。翻訳のファイルはリポジトリに残ります。
設定 は typemark.json の languages 一覧に書き込みます。直接編集することもできます。ページを書いている言語を最初に置いてください。
"languages": [
{ "code": "en", "name": "English" },
{ "code": "fr", "name": "Français" },
{ "code": "pt-BR", "name": "Português (Brasil)" }
]
| キー | 役割 |
|---|---|
code | fr、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.mdx | fr/quickstart.mdx | /fr/quickstart |
guides/authentication.mdx | fr/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としてデフォルトのページを検索エンジンに示します。これにより、同じテキストが二重にインデックスされることを防ぎます。
デフォルトの言語のままになるもの
llms.txt、llms-full.txt、MCPサーバー、Ask AIはデフォルトの言語を使います。- OpenAPI仕様から生成されたAPIリファレンスページは翻訳されません。
エディターで
複数の言語を持つサイトでは、エディターの上部バーに、ビジュアル と ソース の横に言語スイッチャーが表示されます。現在のページを別の言語で開きます。翻訳がまだない言語はグレーアウトされます。翻訳は通常のページと同じように保存されます。
デフォルトの言語のページは、名前の変更、移動、削除ができます。翻訳の名前を変更または削除するには、リポジトリ上で、または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 にないページの翻訳です。そのため公開されません。 |