ドキュメント / ガイド
機械翻訳されたページ
Excel や CSV で受け渡す
未翻訳の文字列を Excel のブックや CSV ファイルにエクスポートして翻訳者に渡し、結果を自動実行と同じ安全チェックでインポートします。
人が翻訳すべき文字列がある場合に使います。たとえば、マーケティングコピー、法務文書、最も重要な言語です。翻訳が必要な文字列をエクスポートし、翻訳者が埋め、そのファイルをロケールファイルにインポートします。
エクスポートは、自動実行が翻訳するのと同じキー(新しいキーと変更されたキー)だけを選びます。インポートは translate と同じ整合性チェックを実行するので、プレースホルダーを壊す手入力の値は、書き込まれずに保留され、報告されます。どちらのコマンドもプロバイダーを呼び出さず、API キーも不要です。
1 つ以上のターゲットロケールを持つ verbatra プロジェクトが必要です。
往復の流れ
# 1. Export the strings that need translating
verbatra export
# 2. A translator fills the Translation column and sends the file back
# 3. Import the filled workbook
verbatra import verbatra-translations.xlsxエクスポートは、作業ディレクトリに verbatra-translations.xlsx を書き込みます。インポートは、入力済みのすべての行を検証し、通過した値を書き込みます。そして translate の実行と同じように、受け付けたキーに限り、ロックファイル(ロックファイルと来歴を参照)を進めます。
ブックに入る内容
ブックは Instructions(説明)シートで始まり、続いてターゲットロケールごとに 1 枚のシートがあります。シート名はロケールです(de、fr、...)。どのロケールシートも、同じ列を持ちます。
| 列 | 編集可能 | 用途 |
|---|---|---|
Key | いいえ | キーのパス(行を文字列に対応づける唯一の手がかり) |
Source | いいえ | ソースロケールの値 |
Current translation | いいえ | 既存のターゲット値(ある場合) |
Status | いいえ | new、changed(翻訳後にソースが変わった)、unchanged(--include-unchanged を付けた場合のみ) |
Translation | はい | 翻訳者が埋める唯一のセル |
Source hash | いいえ | 非表示(エクスポート後にソースが変わったことを検出する) |
Context | いいえ | キーの説明(ソースのフォーマットが持つ場合のみ。インポートされることはない) |
Review status | いいえ | ok、またはレビューフラグが再確認を勧める場合の review |
Review reasons | いいえ | review の状態になったレビューの理由 |
Translation 以外のすべての列は、シートの保護でロックされています。Translation は Excel の表示形式「文字列」を使うので、007 のような値や = で始まる値は、文字どおりのテキストのままです。レビュー列は参考用で、インポートがこれらを読むことはありません。
受け渡し
翻訳者に次のルールを伝えます(Instructions シートにも同じ内容が書かれています)。
Translation列を埋め、ほかは何も変更しません。- 言語タブの名前変更、削除、並べ替えはしません。各タブは正確な名前でロケールに対応づけられるため、名前を変えたタブや足りないタブは、そのロケールを失敗させます。
- 行の並べ替えやフィルターは問題ありません。行は
Keyで対応づけられるためです。列は今の位置のままにします。 - 「まだ翻訳していない」ときは、セルを空にします。半分だけ埋めたブックを今返し、残りを後で返すこともできます。
- 既存の値をあえてクリアするには、
[[CLEAR]]とそのまま入力します。
インポートが受け付けるもの
書き込みの前に、入力済みのすべての行を、現在のプロジェクトに照らして判定します。
- ソースのドリフト:エクスポート後にソース文字列が変わった場合、その行は保留されます。古いソースの訳文が書き込まれることはありません。
- 整合性:プレースホルダー、インラインマークアップ、ICU の構造は、すべての実行と同じように、ソースと一致している必要があります。詳しくは整合性ゲートを参照してください。
- 崩れた値:繰り返しのループ、異常な長さ、空でないソースに対する空の値は、保留されます。
- 不明なキー:キーがソースにもターゲットにも存在しない入力済みの行は、そのロケールのシートを失敗させます。ターゲットにだけあるキーは、書き込まれません。
- 変更のない行:CSV、TSV、xlsx の受け渡しで、最新のキーがすでに持つ値と等しい入力済みの行は、同じゲートを通過したうえで、書き込まれず、変更なしとして報告されます。
保留された行や空白の行は、ロックファイルのベースラインを保ちます。そのため、解決されるまでそのキーは再びエクスポートされます。ソースがドリフトした空白の行は、BLANK_ も発生させます。読み取れない行や重複したキーは、シートを失敗させずに報告されます。各シートは実行サマリーの中で 1 つのロケールとして扱われます。インポートは translate と同じ終了コードを使うので、受け渡しにも、自動実行と同じ CI のチェックを使えます(CI で verbatra を実行するを参照)。詳しくは verbatra import を参照してください。
まずドライランする
返ってきたブックが何を書き込むかを、ファイルに触れずにプレビューします。
verbatra import verbatra-translations.xlsx --dry-runブックの代わりに CSV と TSV
ベンダーやパイプラインがプレーンテキストを求める場合は、--format csv または --format tsv を指定すると、同じ列がロケールごとに 1 つのファイルとして書き込まれます。
# write handoff/de.csv and handoff/fr.csv
verbatra export --format csv --out handoff
# import every locale file in the directory back
verbatra import handoff --format csvロケールはファイル名から決まるので、エクスポートしたときの名前のままにします。ブックと比べると、次のようになります。
- 何も保護されません:すべての列が編集可能で、
Source hashも見えます。編集されたハッシュが信頼されることはありません。行は現在のソースと比較され、ドリフトとして保留されます。 - Instructions シートはありません:上記のルールは、翻訳者に自分で伝えます。
- 数式は無害化されます:
=、+、-、@、タブ、キャリッジリターンで始まる値は、先頭にアポストロフィを付けて書き込まれるので、スプレッドシートはテキストとして保持します。インポートでは、アポストロフィが再び取り除かれます。それでも、返されたファイルは信頼できない入力として扱ってください。 - 範囲を狭めて再エクスポートすると、古いファイルは無効になります:以前の、より広い範囲のエクスポートで残ったファイルは、インポート時に適用されず、拒否されます。何も削除されません。
CAT ツール向けの XLIFF
翻訳会社が Trados、memoQ、OmegaT などの CAT ツール(翻訳支援ツール)で作業する場合は、代わりに XLIFF をエクスポートします。翻訳会社に受け渡す(XLIFF)を参照してください。
TMX は別の経路
受け渡しは、各ロケールの未処理の文字列を人に届けます。verbatra tmx は、翻訳メモリ全体を、1 つの多言語ファイルとしてツール間で移動します。そのため、TMX は export --format に指定する値ではありません。
エクスポート対象の選択
デフォルトでは、エクスポートに含まれるのは、欠落している文字列と変更された文字列だけです。
# Only the German and French sheets
verbatra export --locales de,fr
# Also include strings that are already up to date
verbatra export --include-unchanged
# Write to a specific path
verbatra export --out handoff/round-2.xlsx翻訳者がコンテキストのためにロケール全体を必要とする場合は、--include-unchanged を使います。--out はプロジェクト内にとどめる必要があり、プロジェクトが依存するファイルを指してはいけません。すべてのオプションとルールは verbatra export を参照してください。
レビュー列
どちらの列も、エクスポート時にソースと現在の値から計算されるので、訳文のない行は常に ok です。Review reasons は、各理由を小文字とハイフンで書きます(length-ratio-outlier)。ただし、実行でしか見えない 2 つ(provider-degraded、fuzzy-cache-reuse)は、表示されません。値の ICU の分岐がターゲット言語に合わない場合は、欠落している分岐や余分な分岐とともに icu-arms も追加されます。整合性ゲートはその値を拒否するので、行を返す前に直します。フラグを消すには、訳文を直します。
SDK から使う
2 つのコマンドは、exportWorkbook と importWorkbook をラップしています。
import { exportWorkbook, importWorkbook, loadConfig } from "@verbatra/sdk";
const config = await loadConfig();
await exportWorkbook({ config, format: "csv", out: "handoff" });
const summary = await importWorkbook({ config, workbook: "handoff", format: "csv" });importWorkbook は、translate と同じ RunSummary を返します。
関連項目
verbatra exportとverbatra import:すべてのオプション、出力パス、終了コード- 翻訳の安全性:すべての書き込みの背後にある整合性ゲート
- 機械翻訳なしで実行する:すべての訳文が人から届くプロジェクト