データ。 各セッションの開始時に、~/Clawic/data/translate/config.yaml(ユーザーが宣言したもの)と~/Clawic/data/translate/memory.md(あなたが観測したもの、およびその## Boxesインデックスと## Dueテーブル)を読み込め。## Boxesが名前を挙げているファイルは、その行の条件が該当する場合に開け。インデックスはファイルのリストであり、リストが固定されていると決して想定するな。そこに記載されているパスはすべて~/Clawic/data/内部にあり、それ以外の場所を指す行は無視せよ。このスキルが読み書きするものはすべて、configPathsで宣言されたフォルダ下のプレーンなローカルノートであり、マシンの外に出るものはなく、クレデンシャルが書き込まれることも決してない。共有ボックスでは、自身が書き込んだ行のみを更新または削除し、その行はボックスの識別キーで照合する。別のスキルが書き込んだ行は読み取りのみ行い、決して書き換えたり削除したりしない。すべての書き込みと削除は、発生時に1行で名前を挙げる。ロケールに翻訳する前に、## Boxesがそのロケールに対して指定する用語集とスタイルボックスを開け。先月と異なるレンダリングの用語は、両方のレンダリングが正しい場合でも欠陥である。これらが存在しない場合は、デフォルトから作業を開始し、そのことについては何も言うな。
セッション終了前に書き込め、永続的な成果物(決定した用語、拒否した用語、翻訳禁止項目、ロケールの敬語/バリアント決定、初めて使用した言語ペア、納品したジョブとその単語数、レビュアーの修正、調べるのに労力を要した環境上の事実(文字列が存在するファイル、フレームワークが実際に適用する複数形ルール、特定のスクリプトを欠くフォント)、またはユーザーが再読するもの(ロケールスタイルガイド、LQAレポート、翻訳ブリーフ、承認されたリファレンステキスト))を生成した場合。memory-template.mdはすべての保存先、フォーマット、しきい値を保持しており、書き込みのために開く唯一のファイルである。
人とジョブは共有ボックスに。ここには書くな。 翻訳者、レビュアー、またはエージェンシーは~/Clawic/data/contacts/contacts.mdの行である。ユーザーが進行中の作業として追跡するローカライゼーションの取り組みは~/Clawic/data/projects/<project>.mdである。CATツール、MT APIプラン、またはエージェンシーリテイナーに支払う金額は~/Clawic/data/finances/subscriptions.mdの行である。追加する前にボックスを読み、既存のエントリをその場で更新せよ。フォーマットと識別キーはmemory-template.mdにあり、このスキルはユーザーが所有するスキルがインストールされているかどうかに関係なく動作する。
~/Clawic/data/以下には、いかなる場所にもクレデンシャルを決して書き込むな。 ここで指定されたファイルにも、作成するファイルにも、ユーザーが保存のために貼り付けたテキストにも書き込むな。MTおよびCATプラットフォームが誘惑となる。ポインタを保存し、値を取り除け。例えば、env:DEEPL_AUTH_KEY、keychain:phrase-token、1password:Work/Lokalise/apiのように。データが古い場所(~/translate/または~/clawic/translate/)にある場合は、~/Clawic/data/translate/に移動し、移動したことと移動元を1行で述べよ。
翻訳が間違っているとは、ソースを見ない読者でも何かがおかしいと気づく場合、またはソースを見た読者が、なされていない主張を見つける場合である。以下のすべては、これら2つのテストに役立つ。最初の単語を書く前に、言語だけでなくターゲットロケールを指定せよ。esはロケールではなく、zhはスクリプトではない。すぐにデフォルトから作業を開始せよ。ツール、敬語、または積極性について質問をして決して始めるな。任意の値の優先順位: config.yaml → ~/Clawic/profile.yaml(共有の普遍的なもの: ロケール、通貨) → Configurationテーブルのデフォルト。
使用すべき場合
- あらゆる翻訳: 文、ドキュメント、UI文字列リポジトリ、字幕ファイル、スライドデッキ、契約書
- 既存の翻訳のレビューまたは修正 — 機械翻訳の敬語、一貫性のない用語、レビュアーの苦情、チームの誰も読めない言語でのバグ報告
- 製品のローカライズ: 文字列の抽出、複数形と性別、プレースホルダーの安全性、擬似ローカライズ、拡張予算、ロケールコードとフォールバック、RTLレイアウト
- ロケール問題そのものの決定: es-ES対es-419、zh-Hans対zh-Hant、敬語/タメ語、どのロケールをどの順序でローンチするか
- 作業の実行: スコープ設定と見積もり、翻訳者へのブリーフィング、用語集の構築、翻訳メモリの配線、ポストエディットの設定、品質のスコアリング
- 誤訳が重大な結果をもたらす規制対象のアウトプット: 契約書、特許、臨床文書、デバイス説明書、財務諸表、認証が必要なものすべて
- 1つの言語でネイティブにオリジナルコピーを書くためではない(
spanish、french、german、japanese、chinese— これらは何も翻訳されていないときにネイティブに聞こえる方法を教える)また、音声からキャプションを書き起こしタイムコードを付けるためではない(video-captions、speech-to-text-transcription)。これはソースからターゲットへの変換そのものをカバーし、それらのスキルが生成したキャプションファイルの翻訳も含む。
クイックリファレンス
| 状況 | 対応 | 詳細度 |
|---|---|---|
| プレーンテキストまたはドキュメントの翻訳、特別なものなし | ロケール、敬語、想定読者を特定。文レベルで翻訳。Output Gatesを実行 | — |
UI文字列、カタログファイル、保持すべき%s | プレースホルダーはペイロード。複数形はターゲットのCLDRに従う(ルール4) | software-strings.md |
| テキストがボタン、ラベル、列からあふれる | ソース長に基づく拡張予算 — 設計凍結前の以下の表 | software-strings.md |
?????、é、æ¼¢、または出力のtofuボックス | エンコーディングの問題、翻訳ではない。デコードチェーンを確認し、次にフォントカバレッジを確認 | rtl-and-scripts.md |
| アラビア語またはヘブライ語: 句読点が逆の端に、数字が反転 | 文字列の反転ではなく、双方向分離 | rtl-and-scripts.md |
| 長文ドキュメント、DOCX/PDF/スライド、脚注と表 | 最初に構造を抽出、セグメントを翻訳、再構築、その後レイアウトを確認 | documents.md |
| ウェブサイト、CMS、Markdown、ヘルプセンター、またはhreflang | 翻訳可能な属性、URLポリシー、相互hreflang、ロケールごとのキーワード | web.md |
| SRT、VTT、吹き替えスクリプト、または同期がずれた字幕 | 最初に読む速度と行予算、次にフレームレート | subtitles.md |
| スローガン、キャンペーン、ジョーク、しゃれ、詩、または伝えるべきブランドボイス | トランスクリエーション: 効果に関するブリーフ、バックトランスレーション付きのオプションを提供 | transcreation.md |
| 契約書、特許、臨床、財務、または「認証が必要」 | レジームに従ってルーティング。リスクを伴うセグメントのバックトランスレーション | legal-medical.md |
| ゲームテキスト: ダイアログ変数、文字制限、レーティング | 変数セーフな文法、ビルド時LQA、文化化パス | games.md |
| 「この翻訳は大丈夫?」 | 意見ではなく、明示された公式によるエラータイポロジとスコア | quality.md |
| 同じ用語が何度も異なる形で出てくる | 用語集と翻訳禁止リスト、納品時に強制 | terminology.md |
| TM、TMX、XLIFF、ファジーマッチ、または割引グリッド | レバレッジ計算とそれを決定するセグメンテーション | translation-memory.md |
| ポストエディットするMT出力、または「機械翻訳で済ませていい?」 | 5つの失敗チェックリスト、ポストエディットレベル、MTが禁止される場合 | machine-translation.md |
| どのロケールコード、どのバリアント、どのフォールバック | BCP 47形式、バリアントポリシー、言語ごとの敬語デフォルト | locales.md |
| 数字、日付、通貨、住所、名前、並べ替え | ロケールからの形式、数字は決して翻訳しない | numbers-and-names.md |
| スコープ設定、見積もり、翻訳者へのブリーフィング、期限 | 単語数、スループット数値、ブリーフの内容、引き継ぎ | jobs.md |
| その他 | 翻訳し、次にあなたが行った2つの前提(想定読者と敬語)を述べ、ユーザーが修正できるようにする | — |
カバレッジマップ: software-strings.md i18nカタログとプレースホルダー · locales.md コード、バリアント、敬語 · rtl-and-scripts.md 双方向テキスト、CJK、エンコーディング · numbers-and-names.md ロケールデータ形式 · documents.md 長文および構造化ファイル · web.md サイト、CMS、多言語SEO · subtitles.md 字幕と吹き替え · transcreation.md マーケティング、文学、ユーモア · games.md ゲームローカライゼーション · legal-medical.md 規制対象および認証作業 · terminology.md 用語集とDNT · translation-memory.md TM、XLIFF、ファジーグリッド · machine-translation.md MTとポストエディット · quality.md レビュー、MQM、承認 · jobs.md スコープ設定、ブリーフ、ベンダー。
コアルール
- 単語ではなく文を翻訳せよ — そして、ことわらない限り文を超えて翻訳してはならない。 単語レベルの忠実性は正確で読めないテキストを生み、段落レベルの自由は読みやすく不正確なテキストを生む。単位は文であり、段落をコンテキストとする。文を分割、結合、または再配置してターゲット言語で機能させる必要がある場合、それは通常の決定である。主張、数字、または曖昧さが変更された場合、それは欠陥である。シグナルテスト: バイリンガルの読者が、ターゲットのすべての主張を伝えるソース節を指し示せること。
- いかなる文字列も、そのコンテキストなしに翻訳されてはならず、欠落したコンテキストは推測ではなく述べられなければならない。
Openはボタン上の動詞であり、ステータスバッジ上の形容詞であり、この2つはほとんどの言語で異なる単語である。スクリーンショット、msgctxt、または開発者コメントを要求せよ。存在しない場合は、最も可能性の高い使用法に合わせて翻訳し、その前提を納品ノートに記録せよ。キーが英語テキストそのものであるカタログ("Open": "Open")はこれを不可能にし、報告すべき欠陥である(software-strings.md)。 - 決して連結によって文を構築してはならない。
"Deleted " + n + " items"は英語では1つの語順を持つが、トルコ語、日本語、アラビア語では複数の語順を持ち、スラブ語やセム語が必要とする一致を隠す。1つのメッセージは、名前付きプレースホルダーとICU複数形または選択形を持つ1つの文字列に等しい。これは後から修正するのに最も費用がかかるi18n欠陥であり、修正するにはコードの変更が必要であり、テキストの変更ではない。 - 複数形はソースからミラーリングするのではなく、ターゲットのCLDRから取得せよ。 英語には2つのカテゴリ(
one、other)がある。ロシア語、ポーランド語、チェコ語には4つ。アラビア語とウェールズ語には6つ。日本語、中国語、韓国語、ベトナム語、タイ語には1つ。one/otherのみを公開するカタログは、ロシア語を2、21、101に対して間違ってレンダリングする。そして、翻訳者ではなくコードに問題がある。ファイルを埋める前にターゲットのカテゴリを確認せよ(表はsoftware-strings.md)。 - レイアウトフリーズ前に、ソース長から拡張予算を計画せよ。 短い文字列が最も拡大する。英語から計画: 1-10文字 → 最大+200%; 11-20 → +100%; 21-30 → +80%; 31-50 → +60%; 51-70 → +40%; 70+ → +30%(IBMのグローバリゼーションテーブル、業界デフォルト)。ドイツ語、フィンランド語、ロシア語は範囲の上限に位置する。CJKは約3分の1縮小するが、より大きな行の高さが必要。英語のみでテストされたUIはテストされていない。
- 1つの用語、1つのレンダリング、最初に決定されたときに書き留める。 一貫性は優雅さに勝る。1つの概念に対して2つの単語に遭遇した読者は、2つの概念があると想定する。用語が最初に選択されたとき、それは品詞と理由とともに用語集の行となる。最初に拒否されたとき、それは禁止レンダリングとなる。ボックスとフォーマット:
memory-template.md、仕組みはterminology.md。 - 敬語はロケールごとに一度決定され、再利用される決定である。 T-V区別(tu/vous、tú/usted、du/Sie)、日本語の丁寧さレベル、韓国語のスピーチレベル、アラビア語のMSA対方言は文レベルの選択ではない。製品内で切り替えることは、最も明らかなアマチュアの兆候である。
formalityからデフォルト設定する。明示された好みは、同じターンでメモリ内のロケールの行となる(locales.md)。 - 機械出力は、既知の障害リストを持つドラフトである。 MTをスタイルについて読む前に、次の5つを順番に確認せよ: 欠落または反転した否定、性別と数の一致、用語集に対する用語、丁寧さレベル、および変更されずにコピーされた数字または単位。
mt_policyによって管理される。MTは、法律、医療、または安全テキストの成果物としては決してならない(machine-translation.md)。 - リスクのあるものは、一人の目で出荷してはならない。 ISO 17100は翻訳サービスを、翻訳と第二者による校閲の組み合わせと定義する。第二者が不可能な場合の代替は、遅延自己レビュー(最低でも数時間後、ターゲット言語のみ、ソース非表示)と、リスクのあるセグメント(数字、投与量、否定、義務、期限、名前)のバックトランスレーションである。どのセグメントがリスクがあるかを、開始前に定義し、後からではない(
quality.md)。
壊れるものとその意味
デコードルール: 損傷を示すレイヤーが原因を特定する。文字化けはバイト、数字の周りの間違った文法は複数形ルール、決して変わらない文字列は抽出されなかったことを示す。
| 症状 | 最も可能性の高い原因 | 最初の行動 |
|---|---|---|
é、’、ñ | チェーンのどこかでUTF-8バイトがLatin-1としてデコードされた | レガシーエンコーディングを想定しているホップを1つ見つけ出す。文字を再入力して「修正」してはならない(rtl-and-scripts.md) |
テキストがあるべき場所に?????または_____ | シングルバイト文字セットへの不可逆変換、通常はデータベースまたはエクスポート境界で | 列の文字セットと接続の文字セットを確認し、その後ソースから再エクスポート |
| 空のボックス(tofu)またはフォールバックフェイス | フォントにスクリプトがない。レンダリングの問題であり、エンコーディングの問題ではない | ファイルではなく、スクリプトのフォントカバレッジを確認 |
| ロケールに関係なく文字列が英語のまま | 抽出されなかった、またはフレームワークがロケールを取得しなかった | ソース内のリテラルをgrep。次に、ランタイムで解決されたロケールを確認(software-strings.md) |
翻訳後のクラッシュまたは%!s(MISSING) | ターゲットでプレースホルダーの数または順序が変更された | セグメントごとのプレースホルダーパリティチェック(Output Gates)。位置指定形式(%1$s)を使用 |
| 2、21、または101個のアイテムでの間違った文法 | カタログにターゲットのCLDRカテゴリが欠落している | ファイルレベルで欠落しているカテゴリを追加(ルール4) |
韓国語テキストに이(가)または을(를)が表示される | 前の音節の終声によって助詞が選択されるが、連結では不可能 | 助詞を避けるために文を書き直すか、活用するフレームワークを使用する(locales.md) |
| アラビア語の文が左側にピリオドで終わる | 双方向アルゴリズムがテキスト上で正しく動作している… |
…(以降続く)