提案に基づいて翻訳を維持する

モデルはほとんどの文字列を正しく認識しますが、ネイティブな読者であっても誤認した箇所を見つけ出すことができます。提案機能を使えば、その読者がサイト上で文言を修正し、あなたは Coroid でそれをレビューして、変更内容を通常の pull request としてリポジトリに反映させることができます。

Coroid が13言語で自社製品を維持する仕組みはこの通りです。以下の手順は、該当プロジェクトが国際化されていることを前提としています。プロジェクトを国際化するここにあるすべての内容は、プロジェクトのワークベンチ内のローカライゼーション。

貢献を有効にする#

貢献機能を利用するには、.coroid/i18n.json内にプロジェクトの提案バインディングと、それをサポートするエンジン版が必要です。国際化ウィザードでは、これらがデフォルトで追加されます。

これらの設定がされていないプロジェクトの場合は、コントリビューターを開いて、貢献機能の有効化を提案するを選択します。そうすると Coroid が両方を追加するタスクを作成し、その pull request をマージします。それまでは、コントリビューターに不足している項目が記載されています。

コントリビューターを招待する#

「コントリビューターを招待」を選択し、メールアドレスと翻訳可能な言語を入力します。

• レビュー。「新規コントリビューターに対しては、提案を適用する前にレビューする」を有効にしておきましょう。この設定をオフにすると、提案が即座に承認されますが、その前提条件としてソーステキストが同期済みのリポジトリと一致している必要があります。
• シートなし。コントリビューターはあなたの組織に追加されることも、メンバーシートを使用することもありません。アクセス権限はこのプロジェクトと指定された言語に限定されます。
• Coroid アカウント。招待された人は7日以内に、招待されたアドレスで Coroid にログインするか、招待状から無料アカウントを作成して承諾します。そのアカウントには独自のワークスペースがあり、あなたのワークスペースとは別物です。

アクセス権を取り消すと新しい提案ができなくなりますが、その人の履歴は保持されます。

サイト上のピッカー#

コントリビューターはサイト上から提案を行い、文脈に沿ったテキストを確認できます。

1. 「設定 → アクセスと利用範囲 → サイトオリジン」の下で、各サイトのアドレスを1行につき1つのHTTPSオリジンとして追加し、有効にします。新しいオリジンは、オーナーまたは管理者が有効にするまで利用できません。
2. 「コントリビューターでは、「サイト連携タスクを準備する。このタスクでは、Coroidのピッカーパッケージをサイトに追加します。ページのアドレスに?coroid-translate=1が含まれている場合にのみ読み込まれるため、通常の訪問者は何もダウンロードしません。
3. 貢献者はそのパラメーターを使ってサイトを開き、文字列をクリックすると、キー、ソース、現在の翻訳が表示されるCoroidのポップアップが開きます。

ポップアップでは送信前にプレースホルダーを確認します。貢献者はポップアップ内でCoroidにログインしますが、サイト側で認証情報を処理することはありません。匿名での提案は受け付けられません。

レビュー#

提案には、キー、言語、ソース、現在の翻訳、提案された翻訳が記載されたすべての提案が一覧表示されます。ステータスや言語でフィルタリングし、各提案を承認または却下できます。複数の提案を一度に却下することも可能です。

Coroidは各提案のソースを同期済みのデフォルトブランチと比較します。貢献者が確認した後にソースが変更されていた場合、承認は無効となり、該当行にその旨が記載されます。その提案を却下すれば、貢献者は再度提案できます。

承認済みの提案を適用#

承認済みの提案をpull requestに反映させる方法は2通りあります。どちらも同じ修正タスクを使用し、指定されたエンジンのapply-claimコマンドを実行して各ソースを再確認し、対象のカタログのみを書き込み、適用された内容、古くなった内容、無効な内容を報告します。

• 今すぐの中で提案から修正タスクを準備を選択するか、 コミットの下にある文字列。1つのタスクで、プロジェクト全体の承認済み提案最大500件とワークベンチで行われた変更が処理されます。
• 毎晩ウィザードではデフォルトで夜間の修正が適用されます。それ以外の場合は夜間修正をインストールに自動化処理。スケジュールは 02時に実行されます:00UTCで、モデル呼び出しは行わず、承認された場合のみタスクを作成します。ファクトリー内のスケジュールから一時停止または再開できます。

Coroid外でマージされた文字列#

人がCoroidが作成していないプルリクエスト内で文字列を変更することもあります。ウィザードが インストールしますCoroid外でマージされた文字列を翻訳がデフォルトでインストールされます。それ以外の場合は にインストールします自動化処理このようなpull requestがデフォルトブランチにマージされると、Coroidは既に実行したグローバリゼーションチェック結果を読み取ります。文字列が不足または古くなっている場合、そのマージに対して翻訳タスクを作成します。このタスクはpull requestが追加または変更した文字列のみを翻訳します（coroid-i18n1.19.0以降）ため、同時に翻訳されたマージでは互いの文字列に影響を与えず、それらを含むpull requestが開かれます。チェックでコード内のテキストや文がブロックされた場合、そのコードの国際化のためのタスクも作成されます。処理すべきものがなければ何も起こりません。タスクで残された文字列はバックログを夜間に翻訳、同じ場所にインストールされます：毎晩デフォルトブランチを読み取り、未処理のものに対してタスクを作成し、何もなければ何もしません。

これにはグローバリゼーションプルリクエストでのチェックとすべてのPRをレビュー自動化処理により、マージ前にチェックが実行されます。

設定を別の組織に移行#

設定のエクスポートおよびインポートには夜間スケジュールとマージ済み文字列の自動化処理が含まれます。これらは宛先プロジェクトで一時停止状態で届き、サイトオリジンは無効になり、貢献者はコピーされません。新しい組織で再度招待してください。

関連項目#

• ローカライゼーションワークベンチ
• グローバリゼーションチェック
• プロジェクトを国際化
• スケジュール
• フック