連携
チームが使い慣れたリポジトリ、アプリケーション、コンテンツツールに、翻訳と測定をつなぎます。
チームのコンテンツは、リポジトリ、アプリケーションのデータベース、CMS、翻訳プラットフォームなどに保存されています。連携は、こうした日々の作業をLingo.devにつなぐ仕組みです。どのコンテンツを読み取り、何をきっかけに翻訳や測定を始め、どこに結果を反映するかを定めます。
翻訳の連携では、保存済みの用語、指示、モデル設定を適用したローカライゼーションエンジンに原文コンテンツを送ります。リポジトリ連携では翻訳済みのファイルを返し、CMS連携ではコンテンツの各言語版を更新します。アプリケーションのコードは、保存や配信に使うデータを受け取ります。測定の連携では、既存の翻訳を元のシステムに残したまま、その翻訳についての根拠データを取り込みます。
いつもの作業をつなぐ #
どこから始めるかは、コンテンツがどこで変更され、誰が作業を実行するかによって変わります。
| 始める場所 | 連携の仕組みと結果 |
|---|---|
| GitHubリポジトリ内のファイル | GitHub Appは、設定したリポジトリイベントに応じて動作し、翻訳用のプルリクエスト、または元のプルリクエストのブランチに翻訳済みのコミットを届けます。 |
| 独自のCIパイプライン内のファイル | GitHub Actions、GitLab CI、Bitbucket Pipelines、またはBuildkiteでCLIを実行します。成果物の保持も、リポジトリへの配信の制御も、ジョブで行います。 |
| ローカルファイル | CLIは、選択したファイルを送信し、翻訳をチェックアウト先に取得します。コミットするタイミングは自分で決められます。 |
| Payloadのコレクションとグローバル | Payloadは、選択したローカライズ対象フィールドを、同じリソースの翻訳先ロケールに翻訳します。手動でも、原文の変更後にも実行できます。 |
| Zendeskヘルプセンター | Zendeskでは、手動操作で、選択したカテゴリ、セクション、記事をヘルプセンターの各言語版に翻訳します。 |
| バックエンドで管理するコンテンツ | APIは、構造化されたアプリケーションデータを受け付けます。作業の追跡と、返された翻訳の保存は、アプリケーション側のコードで行います。 |
| Crowdinで作成された翻訳 | Crowdinは、対応する翻訳アクティビティをRadarでの測定用に送信します。この連携では、修正内容を元のシステムに書き戻しません。 |
| Jiraでの翻訳フィードバック | Jiraのトリアージは、ラベル付きの課題を調べ、レビューに向けた変更案を提示します。リポジトリの再翻訳には、別途承認が必要です。 |
連携カタログには、各サービスの設定と復旧の詳しい手順が記載されています。CIレシピはチーム側のインフラストラクチャで実行されるもので、ネイティブのアカウント接続を作成するものではありません。
エージェントが作業を行う場合は、MCPを通じて、呼び出し元の権限でローカライゼーション操作を利用できます。Reactアプリケーションでメッセージを表示するには、Reactライブラリを使用してください。別の連携でカタログを作成する場合でも、メッセージの描画とロケールの選択はアプリケーション側で担います。
一つの変更が反映されるまでを確認する #
まずは、チームの誰かが確認できる原文の変更を一つ用意します。リポジトリなら、チェックアウト画面のメッセージ一つと翻訳先の言語一つ、CMSなら、未公開の記事一つから始められます。原文の選択、翻訳先ロケール、ローカライゼーションエンジンを設定し、各サービスの初回実行手順に従ってください。
結果は、実際に使われる場所で確認してください。ファイルのパスと構造は、アプリケーションが読み込める形である必要があります。CMSの翻訳は、意図したロケールに属し、想定どおりの公開状態になっていることが必要です。正しく反映されたかだけでなく、意味も確認しましょう。次に一か所を修正し、採用した表現をどこで管理するかを決めます。そうすることで、次回の実行時にその表現を適切に扱えます。
承認が必要になるタイミングは、ワークフローごとに異なります。GitHub Appでは、翻訳費用が発生する前に同意を求め、その後、コンテンツのレビュー用にプルリクエストを作成できます。CMS連携では、下書きとして保存することも、直接公開することもできます。それぞれの操作を行う場所で、実行を許可する人、翻訳を承認する人、公開する人を決めてください。
知りたいことに合わせて測定を加える #
まず既存の翻訳を把握したい場合は、測定から始めてください。Crowdinはイベントベースの連携を提供します。CLIでのスコアリングでは、ローカルのカタログを確認し、結果をローカルに書き込みます。どちらも、翻訳の作成担当を変えずに利用できます。
結果は、測定対象のテキストとひも付けておいてください。以前の版に対する指摘は、公開済みの文には当てはまらない場合があります。翻訳の収集では、利用できる根拠データの取り込み方法を説明しています。自動で取り込まれる内容は、各サービスのページで確認できます。修正は、採用済みのテキストを管理するシステムを通じて反映してください。