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

General Translationでドキュメントサイトを数分で翻訳

使い始める
General Translation

Quickstart

Translate a Mintlify documentation site with General Translation.

The integration is powered by Locadex, an AI agent: connect the GitHub repository that holds your docs, choose your languages, and Locadex opens a pull request with internationalization (i18n) routing and translated content. There is nothing to install and no config to write by hand.

Before you start

You need:

  • A project.
  • A GitHub repository containing a valid Mintlify project: a docs.json whose $schema points at Mintlify (mintlify.com/docs.json), with no legacy mint.json.
  • Permission to install a GitHub App on that repository.

プルリクエストをマージ済みes, fr, ja

わずか数ステップでドキュメントをローカライズ

わずか数分で、ドキュメントサイト全体を本番環境で使える品質に翻訳

  1. リポジトリを接続

    Mintlifyのドキュメントを管理しているGitHubリポジトリに、Locadex Agentを接続します。

  2. 言語を選択

    ソースロケールと対象言語を選択します。インストールや設定ファイルの手書きは不要です。

  3. PRをマージ

    Locadexがすべての設定を行い、翻訳済みのページ、多言語ナビゲーション、国際化(i18n)ルーティングを含むPRを作成します。マージすれば、翻訳済みのドキュメントが公開されます。

Mintlifyのドキュメントサイトを翻訳するにはどうすればよいですか?

文字起こし

In Hamburg, your Mintlify docs open in English, and the site offers no German. The navigation in docs.json lists one set of English pages and no languages. General Translation lets you choose languages, and Locadex opens a translation pull request. Authorize the General Translation app on GitHub, and choose your docs repository in the Dashboard. Create an automation from the Generate translations and push template for Mintlify, then run its setup with your languages. Locadex's pull request adds a navigation entry per language and the translated pages. The merged site's menu switches the docs to Spanish, Japanese and German.

世界の一流企業が信頼

General Translationはローカライゼーションに必要なスタック全体を構築し、開発者にもユーザーにもスムーズな体験を提供します

  • ダッシュボード、ランディングページ、iOS で11以上のロケールに対応

  • Web・ドキュメントで14以上のロケール

  • プラットフォーム・ドキュメントで47以上のロケール

  • Web・iOS・Androidで2以上のロケール

  • Web・GTMで7以上のロケール

  • オープンソースのi18nライブラリ
  • コンテキストを考慮した翻訳
  • チーム向けレビュープラットフォーム
  • コンテンツの外部連携
  • Locadex Agent

文脈を十分に踏まえた、ネイティブレベルの翻訳

製品を理解し、ドキュメントサイト全体と照らし合わせて仕上げる、最高品質の翻訳

あらゆる階層で文脈を考慮

製品の文脈とロジックを理解し、独自の語り口やスタイルルールに沿って翻訳します。

すべてのページで一貫性を維持

各ページを校正し、翻訳元と照合したうえで、他のページとの一貫性を確認します。

チームでレビュー・編集

ダッシュボードでは、各言語を並べて表示し、履歴やコメントを確認しながら、すべての行を編集できます。

更新に合わせた継続的なローカライゼーション

ドキュメントを更新するたびに、Locadexが変更箇所を翻訳し、プルリクエストを作成します。あとはレビューしてマージするだけです

  1. ドキュメントの変更をプッシュ
  2. Locadexが変更箇所を翻訳
  3. プルリクエストが作成される
  4. レビューしてマージ
  5. すべての言語で公開

製品群を連携し、まとめてローカライズ

General Translationは、コード、コンテンツ、翻訳、レビューを1つのプラットフォームに統合します

よくある質問

翻訳、国際化、ローカライゼーションの違いは何ですか?

翻訳とは、コンテンツをある言語から別の言語に変換することです。国際化(i18n)とは、ルーティング、ナビゲーション、日付、複数形などの面で、サイトを複数のロケールに対応できるようにすることです。ローカライゼーション(l10n)は、文言からフォーマットまで、製品全体を各ロケールに合わせて調整する包括的な取り組みです。Mintlifyサイトでは、Locadexが設定するロケールルーティングと多言語ナビゲーションが国際化に、各言語のページを用意することが翻訳にあたります。General Translationは、このローカライゼーションのワークフロー全体を継続的に担います。

翻訳について詳しく知りたい場合は、Mintlifyの翻訳をご覧ください。

AI APIでドキュメントを翻訳するだけではだめですか?

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

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

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

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

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

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

セットアップにはどのくらい時間がかかりますか?

大がかりな移行は不要で、数分で完了します。リポジトリを接続し、言語を選択して、General Translationが作成するプルリクエストをマージするだけです。あとは大量のコンテンツも翻訳できます(Rampは40,000個のキーに相当する数百万語を数分で翻訳しました)。「Setup for Agents」ボタンを使って、コーディングエージェントにセットアップを任せることもできます。

どの言語に対応していますか?

スペイン語、フランス語、ドイツ語、日本語、韓国語、中国語(簡体字・繁体字)、ポルトガル語(ブラジルを含む)、アラビア語、ヘブライ語、ヒンディー語など、Mintlifyがサポートするすべての言語に対応しています。General Translationは、選択したロケールをMintlifyの言語コードに対応付けます。リージョンバリアントには、Mintlifyが直接サポートしている場合を除き、基本言語が使用されます。詳しくは対応ロケールの一覧をご覧ください。

ドキュメントの変更に合わせて翻訳も更新されますか?

はい、継続的に更新されます。Locadex Agentは、プルリクエスト、コミット、手動実行のうち、選択したタイミングで実行されます。サイト全体ではなく変更部分だけを翻訳し、プルリクエストとして提出するため、各リリースで変更内容とその翻訳を全言語で同時に公開できます。

翻訳は自社の文体や用語に合ったものになりますか?

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

翻訳によってMDXコンポーネントが壊れることはありますか?

いいえ。MDXの構文とコンポーネント構造を保持したまま、human-readableなコンテンツを翻訳します。Mintlifyサイトでは、フロントマターのタイトルと説明も翻訳されます。

料金はいくらですか?

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

Mintlifyのドキュメントを世界中の読者へ

月額料金なしで、無料スタート