MDXドキュメントをローカライズ

翻訳とは、コンテンツをある言語から別の言語に変換することです。国際化（i18n）とは、ルーティング、ナビゲーション、日付、複数形などを整え、サイトが複数のロケールに対応できるようにすることです。ローカライゼーション（l10n）は、文言からフォーマットまで、製品全体を各ロケールに合わせて調整する取り組みの総称です。MDX ドキュメントでは、ドキュメント用フレームワークが配信するロケール別のフォルダーを用意することが国際化に、各ページをそれぞれの言語に訳すことが翻訳にあたります。General Translation は、このローカライゼーションのワークフロー全体を継続的に処理します。

翻訳に特化した情報をお探しですか？MDX 翻訳をご覧ください。

一度きりの翻訳なら可能です。ただし、毎週、すべての言語で信頼できるドキュメントを公開するには、モデルだけでなく、それを支える仕組みが必要です。

ページは単なるテキストではありません。MDXコンポーネント、インポート文、コードブロックは記述どおりに維持し、フロントマターのキーも保持する必要があります。また、ディープリンクが切れないよう、{#configure-client}のような見出しIDもそのまま残す必要があります。

ドキュメントは単独のページではなく、サイト全体で成り立っています。ナビゲーションは言語ごとに用意し、ロケールコードはプラットフォームが受け付ける形式に合わせる必要があります。また、「workspace」の訳語は1ページ目でも400ページ目でも統一する必要があります。アプリ内でも同様です。アプリのローカライゼーションにも対応しています。

ドキュメントは毎週更新されます。そのたびに変更箇所だけを翻訳し、レビュー担当者が手作業で加えた修正を保持したうえで、ビルドに合わせてリポジトリに反映する必要があります。後から言語を追加しても、既存の言語に不具合が生じてはいけません。

チームの各メンバーが翻訳を管理し、状況を把握できることも重要です。各行を翻訳元と並べて確認でき、履歴、コメント、ロール、言語ごとの文体ルールも確認できる必要があります。

General Translationは、これらすべてにエンドツーエンドで対応します。顧客のローカライゼーションに関するプルリクエストを数千件にわたって処理し、世界中で愛される製品づくりに専念できるよう支援しています。

大がかりな移行は不要で、数分で完了します。npx gt initを実行し、言語を選択して、npx gt translateを実行するだけです。あとは大量のコンテンツも翻訳できます（Rampは40,000個のキーに相当する数百万語を数分で翻訳しました）。「Setup for Agents」ボタンを使って、コーディングエージェントにセットアップを任せることもできます。

General Translationがサポートする120以上のロケールを利用できます。pt-BRやzh-Hantなどのリージョンバリアントや、アラビア語やヘブライ語などの右から左に書く言語も含まれます。gt.config.jsonに指定し、必要に応じていつでも追加できます。詳しくは対応ロケールをご覧ください。

はい、継続的に更新されます。CIでドキュメントをビルドする前にnpx gt translateを実行してください。翻訳元が変更されたコンテンツのみを翻訳し、ローカルでの編集も保持するため、各リリースで変更内容とその翻訳を全言語で同時に公開できます。

General Translationでは、トーンや文体を指定するカスタムプロンプトと、製品名や重要な専門用語の表記を統一する用語集を設定できます。アプリ、ウェブサイト、ドキュメント、スライド、デザインファイルなど、すべての翻訳に文脈が一貫して反映されます。

いいえ。CLI は、human-readable なコンテンツを翻訳する際も、MDX の構文と書式をすべて維持します。{#id} などの明示的な見出し ID も、対応する見出しにそのまま保持されます。

ユーザー単位の課金やサブスクリプションのない従量課金です。Starterはプラットフォーム料金が0ドルで、プロジェクト数、ユーザー数、言語数は無制限です。無料利用枠から始められます。詳しい料金は料金ページをご覧ください。