Markdownドキュメントを翻訳

コマンド1つで、書式を保持したまま、ドキュメント内のすべてのMarkdownファイルを数分で翻訳

使い始める

content/docs/en-US/platform/locadex/quickstart.md

  1. ---
  2. title: Quickstart
  3. description: Use Locadex, the AI agent which connects your codebase, translations, and content sources. It’s the fastest way to run General Translation's full-stack localization.
  4. ---
  6. Locadex is the General Translation AI agent which connects your codebase, translations, and content sources.
  8. After setup, Locadex can configure your project and automatically translate it into the languages you choose.
  10. Locadex currently supports **Next.js**, **Mintlify**, **Fern**, and **Docusaurus** projects, along with React applications built with Vite, Gatsby, Redwood, React Router, TanStack Start, Bazel, esbuild, Rollup, Rolldown, or webpack.
  12. ## How Locadex works [#locadex-works]
  14. Locadex works inside your GitHub repository and automatically opens or updates PRs with generated changes. Three automation templates keep your localization up to date:
  16. - **Generate code** wraps source code with the right internationalization (i18n) library calls, such as `t()` and the `T` component.
  17. - **Generate translations and push** translates source content into every target language and updates translation files.
  18. - **Keep locales in sync** updates project files when languages are added or removed.

npx gt translatees, fr, ja

簡単な手順でドキュメントをあらゆる言語に翻訳

必要なのはコマンド2つだけ。コードの変更も手動での設定も不要

  1. セットアップウィザードを実行

    ドキュメントのリポジトリでnpx gt initを実行し、ファイル形式としてMarkdownを選択して、対象言語を指定します。

  2. 対象ファイルを指定

    ウィザードは、.mdファイル用のglobパターンを1つgt.config.jsonに追加し、言語ごとに[locale]フォルダーを使うよう設定します。コードを変更する必要はありません。

  3. 翻訳してリリース

    npx gt translateを実行すると、CLIがMarkdownの構文と書式をすべて保持したまま、各ファイルの翻訳版を作成します。翻訳済みファイルをコミットし、ドキュメントサイトで公開してください。

デプロイのたびに翻訳を最新の状態に保つにはどうすればよいですか？

文字起こし

In Montreal, your French page shows the line you added this week in English. Your build script runs next build alone, so the line was never translated. General Translation keeps translations current when your CI runs npx gt translate before the build. Create an API key for CI with the file, context and translation queue permissions. Store it and your project ID as secrets in your CI provider. Add npx gt translate to your build script, before the build command. Run that build on every push to main, for example with a GitHub Actions workflow. Each build then ships current translations in Spanish, Japanese and French.

世界の一流企業が信頼

General Translationは、スムーズな開発者体験を実現するため、ローカライゼーションに必要なスタック全体を構築しています

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

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

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

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

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

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

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

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

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

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

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

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

チームでレビュー・編集

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

更新に合わせた継続的な翻訳

ドキュメントのビルド前に npx gt translate を実行すると、変更箇所だけが翻訳されるため、デプロイのたびにすべての言語で公開できます

  1. ドキュメントの変更をプッシュ
  2. ビルド時にCLIを実行npx gt translate
  3. 変更箇所のみを翻訳
  4. すべての言語でデプロイ

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

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

ドキュメント

よくある質問

ドキュメントの翻訳とローカライゼーションは同じですか？

厳密には異なります。翻訳とは、コンテンツをある言語から別の言語に変換することです。ローカライゼーションは、ソフトウェアの翻訳に関わる取り組み全体を指します。製品全体を各ロケールに合わせるもので、国際化（i18n）も含まれます。国際化では、ルーティング、ナビゲーション、日付、通貨、複数形など、ロケールごとに異なる慣習に対応し、サイトで複数のロケールを扱えるようにします。

General Translationは、ローカライゼーションと翻訳の両方で、セットアップから継続的な保守まで対応します。

ローカライゼーションのセットアップ手順全体については、Markdownのローカライゼーションをご覧ください。

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

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

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

翻訳するとMarkdownの書式が崩れますか？

いいえ。CLIは、すべての翻訳済みファイルでMarkdownの構文と書式を保持します。{#id}のように明示的に指定した見出しIDも、対応する見出しにそのまま残ります。

料金はいくらですか？

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

Markdownドキュメントを翻訳して世界中の読者に届ける

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

使い始めるデモを申し込む