ドキュメント

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

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

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

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

貢献を有効にする

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

これらが設定されていないプロジェクトの場合は、Contributorsを開いて貢献機能の有効化を提案する。Coroidが両方を追加するタスクを作成し、そのpull requestをマージします。それまでの間は、Contributorsが不足している項目を説明します。

貢献者を招待する

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

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

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

サイト上のピッカー

貢献者はサイト上でコンテキストに沿った文言を確認しながら提案できます。

  1. 「設定 → アクセスと利用範囲 → サイトオリジン」の下で各サイトのアドレスを1行につき1つのHTTPSオリジンとして追加し、有効にします。新しいオリジンは所有者または管理者が有効にするまで使用できません。
  2. 「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にサインインします。サイト側で彼らの認証情報を扱うことはありません。匿名での提案は受け付けられません。

レビュー

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

ローカライゼーション
ストアフロント
英語ソース · 5言語 · 確認済み 2 時間前 で 3f2c9a1
  • 概要
  • 文字列
  • 提案
  • 交換
  • 貢献者
  • 自動化
  • 設定
提案
修正タスクを準備
レビュー待ち承認済み適用済み
  • 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件と、ワークベンチで行われた変更を処理します。
  • 毎晩ウィザードではデフォルトで夜間の修正をインストールします。それ以外の場合は「夜間の修正をインストール」を選択してください。自動化処理スケジュールは02時に実行されます:00UTCで動作し、モデル呼び出しを行わず、承認された場合にのみタスクを作成します。ファクトリー内のスケジュールから一時停止または再開できます。

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

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

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

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

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