本文へスキップ
本文へスキップ

ドキュメント / ガイド

機械翻訳されたページ

このページは自動翻訳のため、誤りや不自然な表現が含まれている可能性があります。正式な内容は英語版です。英語の原文を読む。

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_ROW_BASELINE_RETAINED も発生させます。読み取れない行や重複したキーは、シートを失敗させずに報告されます。各シートは実行サマリーの中で 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 を返します。

関連項目

GitHub で編集

このページの内容