ドキュメント

提案に基づく翻訳の管理

ネイティブスピーカーが自社サイトの文言を修正し、その提案をレビューした上で、通常のプルリクエストとして適用します。

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

Coroidが13言語で自社製品の翻訳を維持する仕組みがこれです。以下の手順は、指定された通りにプロジェクトが設定されていることを前提としています。プロジェクトを翻訳する。

貢献を有効にする

貢献機能を利用するには、次の2つの要素が必要です。.coroid/i18n.json:プロジェクトの提案バインディングと、それをサポートするエンジン版。"Contributors"タブでは、Contributorsタブで、貢献を有効にするための提案を作成を選択します。Coroidが両方の要素を追加するタスクを作成し、そのpull requestをマージします。それまでの間、タブには不足している内容が記載されます。

貢献者を招待する

「貢献者を招待」を選択し、メールアドレスと翻訳可能な言語を入力します。

  • レビュー。"適用前に提案をレビュー」を新規貢献者向けに有効にしておきます。この機能をオフにすると、提案は即座に承認されますが、その前提条件はソーステキストが同期済みのリポジトリと一致することです。
  • シート不要。貢献者は貴社の組織に追加されることも、メンバーシートを使用することもありません。アクセス権はこのプロジェクトと指定された言語にのみ付与されます。
  • 招待状には有効期限があります。対象者は招待されたアドレスでログインまたはアカウントを作成し、7日以内に承諾する必要があります。

アクセス権を取り消すと新しい提案の受け付けが停止されますが、その人物の履歴は保持されます。

サイト上のピッカー

貢献者は文脈に沿ったテキストを確認しながら、貴社サイトから提案を行います。

  1. "設定 → サイトのオリジン"の下で、各サイトのアドレスを1行につき1つのHTTPSオリジンとして追加し、有効にします。新しいオリジンは、オーナーまたは管理者が有効にするまで使用できません。
  2. "Contributors"タブでは、Contributorsタブで、「サイト連携用タスクを準備」を選択します。このタスクにより、Coroidのピッカーパッケージが貴社サイトに追加されます。このパッケージは、ページのアドレスに?coroid-translate=1が含まれる場合にのみ読み込まれるため、一般の訪問者は何もダウンロードする必要がありません。
  3. 貢献者がそのパラメーター付きで貴社サイトを開き、文字列をクリックすると、Coroidのポップアップが表示され、キー、ソース、現在の翻訳内容が示されます。
ACMENeuheitenAngeboteMarken
Weiter zur Kasse gehen

Kostenloser Versand ab 50 € und 30 Tage Rückgabe.

Bestellung prüfen
翻訳モード任意のテキストをクリックしてください終了
翻訳を提案する
キー
ui · cart.checkout
英語ソース
Proceed to checkout
現在の翻訳
Weiter zur Kasse gehen
あなたの翻訳
Zur Kasse

中括弧や山括弧で囲まれた部分は、そのままの形式で入力してください。

提案を送信

翻訳モードの顧客サイト:貢献者が見出しをクリックし、Coroidポップアップ内でより適切なドイツ語表現を提案。参考データ。

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

レビュー

「提案「提案」タブには、キー、言語、ソース、現在の翻訳、および提案された翻訳を含むすべての提案が一覧表示されます。ステータスや言語で絞り込み、各提案を承認または却下できます。複数の提案を一度に却下することも可能です。

ストアフロント
設定済み · ソース: en · ターゲットロケール: 4件
概要セットアップ設定貢献者提案自動化
レビュー待ち承認済み適用済み
修正タスクを準備
  • cart.checkoutdeレナ · ドイツ語
    en
    Proceed to checkout
    de
    Weiter zur Kasse gehen
    de
    Zur Kasse
    承認却下
  • product.inStockfrヒューゴ · フランス語
    en
    In stock
    fr
    En stock
    fr
    Disponible
    承認却下
  • nav.dealsdeレナ · ドイツ語

    提出されたソースが、同期されたリポジトリの内容と一致しません。

    en
    Weekly deals
    de
    Angebote
    de
    Angebote der Woche
    承認却下

提案タブ:レビュー待ちの修正内容が、同期されたソースと照合される。参考データ。

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

ステータス意味
レビュー待ちレビュアーを待機中
承認済み次の修正タスクの準備完了
キューに入れられています修正タスクが適用中です
適用済みpull request内で記述され、マージおよびデプロイされると即座に反映されます
ソースが変更されました適用前にソーステキストが変更されました
無効エンジンのチェックに合格しなかったため、例えばプレースホルダーが破損している場合などです
却下レビュアーが却下しました

承認済みの提案を適用する

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

  • 今すぐ「提案タブで、「修正タスクを準備」を選択します。1つのタスクでプロジェクト全体の承認済み提案最大500件を処理できます。
  • 毎晩自動的に「自動化処理タブで、「夜間修正をインストール」を選択します。スケジュールはUTC時間02時に実行され、モデル呼び出しは行わず、承認済みの提案がある場合にのみタスクを作成します。ファクトリー内のスケジュールから一時停止または再開できます。:00UTC時間02時に実行され、モデル呼び出しは行わず、承認済みの提案がある場合にのみタスクを作成します。ファクトリー内のスケジュールから一時停止または再開できます。

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

Coroidが生成しなかったプルリクエスト内でも文字列が変更されることがあります。インストールしてくださいCoroid 以外でマージされた文字列を翻訳するの自動化処理タブで。そのような pull request がデフォルトブランチにマージされると、Coroid は既に実行済みの翻訳チェック結果を pull request から読み取ります。もし翻訳漏れや古い文字列があれば、そのマージに対して翻訳タスクを作成します。翻訳すべき内容が何も残っていなければ、何も起こりません。

これには翻訳機能がプルリクエストで制御され、PR をすべてレビューする自動化により、マージ前にチェックが実行されます。

監査と通知

この翻訳監査機能は定時で各カタログをチェックします。チェック失敗時に通知を受け取るには、監査失敗通知の自動化処理タブで。組織が連携したSlackやメールなどのメッセージングツールを通じて通知が送信されます。タスクQAやプルリクエストでの失敗は通知されず、作業が行われている場所に直接表示されます。

設定を別の組織に移行する

設定のエクスポートとインポートでは、毎晩のスケジュールや両方のフック自動化設定が引き継がれます。ただし、宛先プロジェクトでは一時的に停止され、サイトオリジンは無効化され、貢献者情報はコピーされません。新しい組織では再度招待する必要があります。