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

リファレンス / CLI

機械翻訳されたページ

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

verbatra import

記入済みのブック、CSV、TSV、XLIFF の受け渡しファイルをロケールファイルに取り込み、同じ安全チェックを実行します。

翻訳者が記入した受け渡しファイルを、ロケールファイルに読み戻します。すべての値は、自動実行と同じ整合性チェックを通ります。通過した値は書き込まれ、ロックファイルと来歴が更新されます。失敗した値は保留されて報告されるため、不正なセルがロケールファイルに入ることはありません。実際の実行では、既存の .gitignore に欠落しているエントリも追加します。詳しくは .gitignore のエントリを参照してください。

書式

verbatra import <workbook> [flags]
  • <workbook>:verbatra export が書き出し、翻訳者が記入した受け渡しファイルです。xlsx ではブックファイルです。csv、tsv、xliff2、xliff12 では、<locale>.csv、<locale>.tsv、<locale>.xlf のいずれか 1 つのファイル、またはロケールごとに 1 ファイルを含むディレクトリです。

例

# import the filled workbook
verbatra import verbatra-translations.xlsx

# validate and report, write nothing
verbatra import verbatra-translations.xlsx --dry-run

# import every locale file in a CSV handoff directory
verbatra import handoff --format csv

# import one XLIFF file back from a CAT tool, naming the reviewer
verbatra import handoff/de.xlf --reviewer "Agency GmbH"

オプション

オプション引数デフォルト説明
--dry-runなしオフロケールファイルへの書き込みもロックファイルの更新もせずに、検証して報告する
--format<format>パスの拡張子から決まる。csv、tsv、.xlf または .xliff なら xliff2、それ以外は xlsx。ディレクトリでは、エクスポートのマニフェストまたは中のロケールファイルから決まるxlsx、csv、tsv、xliff2、xliff12 のいずれか。どちらの XLIFF フォーマットも両方のバージョンを読み込む
--reviewer<name>なしreviewed または final とされた各 XLIFF 翻訳単位に記録される名前。最大 64 文字で、コミットされる来歴ファイルに保存される
--lock-timeout<seconds>600保持されているロケールごとの書き込みロックを待つ時間。1 から 3600 までの整数で、それ以外は使い方の誤りとなり終了コード 2 になる

グローバルオプションの --cwd、--config、--json も使えます。

動作

警告

チェックを通過した記入済みの値は、人が書いた値であっても、ロケールファイル内の対応する値を置き換えます。まず --dry-run を実行して、何が変わるかを確認してください。

ロケールファイルと残存ファイル

csv または tsv では、ロケールはファイル名から決まるため、すべてのファイルをエクスポートしたときの名前のままにします。ファイル(ブックの場合はシート)がない設定済みのターゲットロケールは、WORKBOOK_SHEET_MISSING で失敗します。黙ってスキップされることはありません。

より広い --locales 指定の以前のエクスポートから残っているファイルは、適用されません。インポートは、ディレクトリを直近のエクスポートが書き込んだマニフェストと照合し、該当するロケールを HANDOFF_FILE_STALE で失敗させます。そのロケールを再エクスポートするか、ファイルを削除します。読み取れるマニフェストがないディレクトリ(手で組み立てた場合や、アーカイブで失われた場合)は、そのまま読み込まれます。直接指定した単一のファイルも同じです。

書き込みロック

--lock-timeout は、使用中の書き込みロックをロケールが待つ時間を設定します。時間を過ぎると LOCK_CONTENDED で失敗します。動作は verbatra translate と同じです。待機はロケールのファイルを書き込む前に行われるため、タイムアウトしたロケールには手が付けられず、ほかのロケールは引き続きインポートされます。コマンドは 1 で終了します。ファイルを書き込んだあと、ロックファイルへの記録は、--lock-timeout の値にかかわらず、デフォルトの 10 分まで待ちます。1 秒を超える待機では、書き込みロックとその保持者を示す行が出力されます(--json では lock-wait レコード)。--dry-run は書き込みロックを取らないため、待機しません。

XLIFF

XLIFF ファイルは、宣言されているバージョンで読み込まれます。名前が設定済みのロケールでない単一のファイルは、宣言されているターゲット言語で照合されます。ターゲットが現在の値と等しい翻訳単位は何も変えません。それ以外のターゲットは、ブックの行と同じように整合性ゲートを通ります。reviewed または final(1.2 では signed-off や approved="yes" も)の翻訳単位は、--reviewer の名前とともに承認として記録され、HANDOFF_REVIEWS_RECORDED 通知で報告されます。ID が指すソースキーがない翻訳単位は、不正な行として報告されます。詳しくは翻訳会社に受け渡す(XLIFF)を参照してください。

空の行と壊れた行

空の Translation セルでロケールが失敗することはありません。その行はスキップされ、ロックファイルのベースラインは維持され、キーはまだ翻訳が必要な間は unfilled として報告されます。まだ誰も記入していない受け渡しファイルをインポートしても成功し、未処理のキーがすべて一覧に出ます。

エクスポート後にソーステキストが変わった記入済みの行は保留されます。そのキーは理由なしで integrity-withheld に一覧され、ロケールは一部完了になり、キーは再びエクスポートされます。

読み取れない行が 1 つあれば、不正な行として報告され、ロケールの残りは引き続きインポートされます。サイズが大きすぎる、またはまったく解析できない受け渡しファイル(たとえば読み取れる xlsx コンテナーではない場合)は、実行全体の SOURCE_INVALID エラーになり、メッセージに原因が示されます。

CSV、TSV、xlsx の受け渡しファイルでは、最新のキーがすでに持っている値と等しい記入済みの行は、整合性ゲートを通過したあとも手を付けず、翻訳されたものではなく未変更として報告されます 。詳しくはインポートが受け付けるものを参照してください。

ターミナルへの表示

import は、ファイルを読み込んで適用している間、1 行を表示します。正常にインポートが終わると verbatra check を、--dry-run のあとは --dry-run を外した同じインポートを提案します。ロケールが失敗した場合や一部完了になった場合は、拒否された行を修正したあとの同じインポートを提案します。次の手順を持つエラーでロケールが失敗した場合は、その手順を提案します。

出力
verbatra: importing verbatra-translations.xlsx... done (0.4s)
next: verbatra check (confirm every locale is in sync)

これらの行は stderr に出力され、--quiet で表示されなくなります。詳しくはターミナル出力を参照してください。

JSON 出力

スキーマ:import-envelope.json がエンベロープ(envelope)全体を検証します。ほかのスキーマはスキーマに一覧があります。

--json を付けると、JSON 出力のエンベロープが 1 つの RunSummary を含みます。形は verbatra translate が出力するものと同じで、すべてのフィールドは RunSummary にあります。

終了コード

終了コード意味
0ターゲットロケールがすべて完了した
1実行は終了したが、1 つ以上のロケールが失敗したか一部完了になった
2実行できなかった。実行全体のエラー(設定、受け渡しファイル、フォーマット、破損したロックファイル)または使い方の誤り
130Ctrl-C(SIGINT)で中断された。実行の書き込みロックを解放した後で終了した
143SIGTERM で停止された。実行の書き込みロックを解放した後で終了した

終了コードの規則は verbatra translate と同じです。そのため、手動の受け渡しも CI で同じように分岐します。一部完了のロケールは 1 で終了します。ロックファイルが破損している場合、または破損した場合は、実行全体を 2 で止め、残りのロケールには手を付けません(それ以前に適用されたロケールは書き込まれたままです)。すべてのコマンドが従う規則は終了コードを参照してください。

関連項目

GitHub で編集

このページの内容