連携

リポジトリやコンテンツ管理システムと翻訳を連携し、CIでローカライズを実行。Crowdinの検証データの収集や、Jiraのフィードバックの調査にも対応します。

チームがコンテンツの作成、翻訳、レビューに使っているツールと、Lingo.devを組み合わせてご利用ください。接続ごとに役割は異なり、翻訳したコンテンツを元のシステムに書き戻すものもあれば、検証データの収集やフィードバックの調査を支援するものもあります。

今お使いのシステムでコンテンツを翻訳する #

これらのネイティブ連携は、選択した原文コンテンツを読み取り、ローカライゼーションエンジンで翻訳したうえで、付与されたプロバイダーへのアクセス権を使って結果を書き戻します。

接続処理の開始条件翻訳の書き戻し先
GitHub設定済みのリポジトリイベント、または対象範囲を指定した翻訳コマンド既定ブランチの変更に対する翻訳プルリクエスト、または条件を満たすプルリクエストのブランチへのコミット。
Payload手動での同期、またはプラグインからの原文変更通知元と同じコレクションとグローバルにある、選択した翻訳先ロケールのローカライズ対象フィールド。
WordPress手動同期、またはプラグインが通知する公開済み投稿の保存各投稿に紐づく、選択した言語の Polylang または WPML の翻訳。
Zendeskヘルプセンター手動での同期選択したカテゴリ、セクション、記事の各言語版。

プロバイダーの設定でアクセス範囲を指定します。GitHub では、リポジトリとソースファイルのパターンを選択します。Payload では、ローカライズ対象のフィールドを持つコレクションとグローバルを選択します。WordPress では、投稿タイプを選択します。Zendesk では、カテゴリ、セクション、記事をそれぞれ個別に選択します。カテゴリを選択しても、配下の項目は選択されません。

公開時の動作は、プロバイダーによっても異なります。Payloadの公開モードでは、公開済みのドキュメントに未公開の変更がある場合、その変更が公開されるか取り消されるまで書き込みを行いません。翻訳を公開すると、未公開の変更も公開されてしまうためです。Zendeskで下書きとして書き込むと、すでに公開されているロケール版が、再公開されるまで表示されなくなることがあります。初めて書き込む前に、プロバイダーの公開に関するセクションをお読みください。既存の翻訳がある場合は、特にご注意ください。

パイプライン内で翻訳を実行する #

GitHub Actions、GitLab CI、Bitbucket Pipelines、Buildkiteでは、ご自身のランナーでCLIを実行できます。これらの設定例は、ダウンロード可能な成果物、または信頼できる単一のブランチから始める構成なので、リポジトリへの書き込み権限を広げる前に結果を確認できます。.lingo/lock.jsonをコミットしておけば、前回の翻訳以降にソースが変更されている場合や、翻訳先のファイルが見つからない場合に、lingo checkがプルリクエストやマージリクエストのチェックを失敗させます。APIキーは不要です。

スケジュール、シークレット、出力の保持、コミットやプルリクエストの作成は、パイプライン側で管理します。Lingo.devのAPIキーは翻訳の実行を許可し、プロバイダーの認証情報はリポジトリへの書き込みを許可します。CIで翻訳を自動化するでは、原文のリビジョン、完成した出力、アプリケーションのチェックをまとめて管理する方法を説明しています。

翻訳の測定やフィードバックの調査を行う #

Crowdinは、対応している文字列単位のアクティビティをRadarに送信します。翻訳の生成やレビューのワークフローを移すことなく、Crowdinで作成された翻訳を検証できます。確かめたいことに合わせて測定を設定し、収集されたテキストと測定結果を確認してください。この接続では、修正した翻訳をCrowdinに書き戻して同期することはありません。

Jiraでは、報告された問題を起点に処理が始まります。lingoラベルを追加すると、トリアージのワークフローが課題を調査し、用語集、ルール、ブランドボイスの変更を提案します。各提案を適用するか却下するかは人が判断し、その後、影響を受ける接続済みコンテンツを再翻訳するかどうかを選びます。Jiraのトリアージは、チケットの内容をローカライズプロジェクトとして翻訳するものではありません。

対象範囲を広げる前に初回実行を完了する #

各プロバイダーのページでは、小規模な初回実行の手順として、認可、設定、出力の確認、復旧までを案内しています。この初回実行で、接続が何を読み取り、何を変更するのかを確認してください。接続を利用できるかどうかは、組織の権限や機能へのアクセス権によって異なる場合があります。プロバイダーの認証情報だけでは、ローカライゼーションエンジンへのアクセス権は得られません。

接続の利用を終了する際は、新たに処理が始まらないようトリガーを停止し、プロバイダーの認証情報は別途処理してください。接続を切断しても、配信済みのコンテンツ、投稿済みのコメント、記録済みの測定は元に戻りません。どのような状態が残るのか、再接続すると何が起きるのかは、プロバイダーの復旧に関するセクションで説明しています。

アプリケーション側で管理するワークフローについては、開発者ツールでAPI、CLI、JavaScriptのインターフェースをご確認ください。