開発者ツール
ファイルの翻訳も、サーバーからのAPI呼び出しも、JavaScriptパッケージを使った多言語アプリケーションの表示も。
ローカライゼーションは、翻訳を生成するコードと、翻訳を利用するコードをつなぎます。サーバーがレコードの変更時に翻訳済みコンテンツをリクエストすることもあれば、ビルド時に翻訳済みファイルを収集することもあります。Reactコンポーネントなら、翻訳をリクエストせずに既存のカタログを読み込むこともできます。
実装したい部分から始めましょう。各セクションでは、最初の作業を完了するまでの手順と、その後の開発に必要な仕様を順に説明します。
API #
サーバーがすでにコンテンツを保持していて、翻訳のリクエスト時期や保存先、利用のタイミングをサーバー側で決める場合は、APIを使います。JSON形式のコンテンツやアップロードしたファイルを翻訳ジョブとして送信し、実行を開始して、完了した翻訳を対象ごとに取得します。翻訳とレビューの各段階は、エンジンが制御します。
初めてのリクエストを送信するでは、少量のデータを送信し、翻訳済みデータをローカルに保存します。認証情報、ローカライゼーションエンジンの選択、レスポンスの各フィールドに加え、アプリケーションのストレージに接続する前の確認事項も説明します。
CLI #
コンテンツをファイルで管理している場合は、CLIを使います。ソースのパスと対象ロケールを設定し、選択した作業を送信して、翻訳先のファイルをプロジェクトに取得します。CLIはソースの基準となる状態を記録するため、次回以降はすべてのファイルを新規として扱うのではなく、変更分を処理できます。
初めてのファイルを翻訳するでは、インストールから認証、設定、翻訳済みファイルの取得までを説明します。同じCLIで明示的に記述されたReactメッセージを抽出し、カタログにまとめることもできます。抽出はローカルで行われ、翻訳はリクエストされません。
JavaScript #
JavaScriptパッケージは、サーバー用クライアント、Reactでのメッセージ表示、ロケールのルーティングに対応しています。翻訳をリクエストするならクライアントを、アプリケーションにすでにあるメッセージを表示するなら表示用ライブラリを選びましょう。ブラウザーでの表示に翻訳APIキーは必要ありません。
Reactのドキュメントでは、最初のメッセージをローカルで表示する例、カタログの読み込み、文法に応じた表現の切り替え、リッチテキスト、フレームワーク別の連携を紹介しています。URLの決定と翻訳済みテキストの扱いは、それぞれ別の役割です。ルーティングのリファレンスでは、選択したロケールと読み込んだメッセージの整合性を保つ方法を説明します。
既存のプロジェクトで使う #
形式では、各ハンドラーが何を翻訳し、再構成するかを説明します。呼び出し元ツールの対応形式一覧も確認してください。サーバー連携で利用できるハンドラーが、CLIのファイル形式としても設定されているとは限りません。
i18n.jsonまたはLingoDotDevEngineを使っているプロジェクト向けに、バージョン別のCLI v0とSDK v0のリファレンスを用意しています。移行を計画している間は、インストール済みのバージョンを維持してください。世代によって、設定や保持される状態、戻り値が変わる場合があります。
アシスタントがローカルファイルやアカウント設定を操作する場合は、MCPを使います。リポジトリ、CMS、ヘルプセンターと連携して翻訳する場合は、連携を使います。各接続では、作業の開始方法、使用する権限、結果の返却先が定義されています。