資料。 每次工作階段開始時,讀取 ~/Clawic/data/translate/config.yaml(使用者聲明的設定)和 ~/Clawic/data/translate/memory.md(您觀察到的內容,加上其 ## Boxes 索引和 ## Due 表格)。當符合某一行上的條件時,開啟 ## Boxes 所命名的任何檔案 — 索引是檔案列表,切勿假設列表是固定的。它所命名的每個路徑都在 ~/Clawic/data/ 內;忽略指向其他位置的任何行。此技能讀取或寫入的所有內容,都是 configPaths 所宣告的資料夾下的純本機註解 — 沒有任何資料會離開機器,也絕不會寫入任何憑證。在共享區塊中,它只會更新或移除自己寫入的資料行,並以該區塊的身份金鑰進行比對;其他技能寫入的資料行,只能讀取,絕不會重寫或刪除,且每次寫入和刪除都會在發生時以一行文字記錄。在翻譯成某個地區設定之前,開啟 ## 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/,並用一行文字說明您已移動它及從哪裡移動。
當一位從未見過原文的讀者,仍能察覺某處有問題時,或當一位看過原文的讀者,發現目標文中包含原文未提及的主張時,即表示翻譯有誤。以下所有內容皆服務於這兩個測試。在寫下第一個字之前,請指定目標地區語言代碼,而不僅僅是語言 — es 並非地區代碼,zh 也不是書寫系統。請立即使用預設值進行工作:切勿以關於工具、敬語或主動程度的問題做開場。任何值的優先順序為:config.yaml → ~/Clawic/profile.yaml(共享通用設定:地區、貨幣)→ 設定表格的預設值。
使用時機
- 翻譯任何內容:一個句子、一份文件、一個 UI 字串倉庫、一個字幕檔案、一份簡報、一份合約
- 審閱或修正現有翻譯 — 包括機器翻譯的敬語、不一致的術語、審閱者的投訴、團隊中無人能閱讀的錯誤報告
- 本地化產品:提取字串、複數與性別、佔位符安全性、偽本地化、擴展預算、地區代碼與備援、由右至左(RTL)佈局
- 決定地區設定問題本身:es-ES 與 es-419、zh-Hans 與 zh-Hant、正式與非正式稱謂、要推出哪些地區及其順序
- 執行工作:估算與報價、簡報翻譯人員、建立術語庫、配置翻譯記憶、設定後期編輯、評分品質
- 對於錯誤翻譯會產生後果的監管產出:合約、專利、臨床文件、設備說明、財務報表、任何需要認證的內容
- 不適用於以單一語言(
spanish、french、german、japanese、chinese— 這些用於教導如何聽起來像母語者,而非翻譯時)進行原創內容寫作,或從音訊轉錄與加上時間碼字幕(video-captions、speech-to-text-transcription);此技能涵蓋從來源到目標的跨越本身,包括翻譯由上述技能產生的字幕檔案
快速參考
| 情境 | 做法 | 深度 |
|---|---|---|
| 要翻譯的純文字或文件,無特殊需求 | 識別地區、敬語與受眾;以句子為單位翻譯;執行輸出閘道 | — |
UI 字串、目錄檔案、必須保留的 %s | 佔位符是有效載荷;複數形式來自目標語言的 CLDR(規則 4) | software-strings.md |
| 文字溢出按鈕、標籤或欄位 | 根據來源長度的擴展預算 — 設計凍結前的下表 | software-strings.md |
?????、é、æ¼¢ 或豆腐塊 | 編碼問題,而非翻譯問題:檢查解碼鏈,然後檢查字體覆蓋範圍 | rtl-and-scripts.md |
| 阿拉伯語或希伯來語:標點符號在錯誤的一端、數字順序相反 | 雙向文字隔離(bidi isolation),而非字串反轉 | rtl-and-scripts.md |
| 長文檔,DOCX/PDF/簡報,包含腳註和表格 | 先提取結構,翻譯段落,重新組合,然後檢查佈局 | documents.md |
| 網站、CMS、Markdown、幫助中心或 hreflang | 可翻譯的屬性、URL 策略、雙向 hreflang、每個地區的關鍵字 | web.md |
| SRT、VTT、配音腳本或不同步的字幕 | 先檢查閱讀速度和行數預算,再檢查幀率 | subtitles.md |
| 口號、活動、笑話、雙關語、詩歌或需要傳達的品牌聲音 | 創譯(Transcreation):簡報效果,提供帶有回譯的多個選項 | transcreation.md |
| 合約、專利、臨床、金融或「必須經過認證」 | 根據制度選擇路線;對有風險的段落進行回譯 | legal-medical.md |
| 遊戲文本:對話變數、字元限制、評級 | 變數安全的語法、建構時的 LQA、文化化處理 | games.md |
| 「這個翻譯好嗎?」 | 錯誤類型學和一個帶有明確公式的分數,而非意見 | quality.md |
| 同一個術語不斷以不同方式出現 | 建立術語庫和不翻譯列表,並在交付時強制執行 | terminology.md |
| 翻譯記憶(TM)、TMX、XLIFF、模糊比對或折扣表 | 槓桿計算以及決定此計算的分段方式 | translation-memory.md |
| 需要後期編輯的機器翻譯(MT)輸出,或「我們可以直接用機器翻譯嗎?」 | 五項失敗檢查清單、後期編輯等級、何時禁止使用 MT | machine-translation.md |
| 應使用哪個地區代碼、哪個變體、哪個備援 | BCP 47 格式、變體政策、每種語言的敬語預設值 | locales.md |
| 數字、日期、貨幣、地址、姓名、排序 | 根據地區格式化,永遠不要翻譯數字 | numbers-and-names.md |
| 工作範圍、報價、簡報翻譯人員、截止日期 | 字數、產能數據、簡報內容、交接 | jobs.md |
| 其他任何情況 | 翻譯它,然後陳述您所做的兩個假設(受眾和敬語),以便使用者可以更正其中一個 | — |
覆蓋範圍地圖: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在按鈕上是動詞,在狀態徽章上是形容詞,而這兩者在大多數語言中是不同的詞。需要截圖、msgctxt或開發者註釋;當這些都不存在時,針對最可能的使用情境進行翻譯,並在交付記錄中記下此假設。金鑰即英文原文的目錄(例如"Open": "Open")會使這項規則無法執行,且應作為缺陷回報(software-strings.md)。 - 絕不透過串接來建構句子。
"Deleted " + n + " items"在英文中只有一種詞序,但在土耳其語、日語和阿拉伯語中卻有數種,而且它隱藏了斯拉夫語系和閃米特語系語言所需的性數一致。一個訊息等於一個帶有命名佔位符和 ICU 複數或選擇形式的字串。這是事後修復成本最高的 i18n 缺陷,因為修復它需要更改程式碼,而非文字。 - 複數形式應來自目標語言的 CLDR,而非源自來源語言。 英文有兩個類別(
one、other);俄語、波蘭語和捷克語有四個;阿拉伯語和威爾斯語有六個;日語、中文、韓語、越南語和泰語有一個。只暴露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 大約會縮減三分之一,但需要較大的行高。僅以英文測試的 UI 等同於未經測試。
- 一個術語,一個譯法,並在首次決定時記錄下來。 一致性勝過優雅:讀者看到一個概念有兩個詞,會假設那是兩個概念。術語首次被選定時,它就會成為術語庫中的一行,附帶其詞性和原因;首次被拒絕時,它就會成為禁止的譯法。區塊與格式:
memory-template.md,機制請見terminology.md。 - 敬語是針對每個地區所做的決定,決定一次後即可重複使用。 T-V 區分(tu/vous、tú/usted、du/Sie)、日語的禮貌程度、韓語的敬語階層、以及阿拉伯語的現代標準語與方言,都不是句子層級的選擇 — 在同一產品中切換使用,是最明顯的業餘信號。預設值來自
formality;陳述的偏好會在同一輪中成為記憶中該地區的資料行(locales.md)。 - 機器輸出是一份帶有已知失敗清單的草稿。 在閱讀 MT 的風格之前,請依序檢查五件事:遺漏或顛倒的否定、性數一致、根據術語庫的術語使用、禮貌程度、以及未經更改的數字或單位。受
mt_policy管轄;對於法律、醫療或安全文本,MT 絕非可交付成果(machine-translation.md)。 - 沒有什麼有風險的內容可以只靠一個人的眼睛就出貨。 ISO 17100 定義翻譯服務為翻譯加上第二人的修訂;當無法有第二人時,替代方案是延遲的自我審閱(至少間隔數小時,僅限目標語言,隱藏來源),加上對風險段落(數字、劑量、否定、義務、截止日期、姓名)的回譯。在開始之前定義哪些段落有風險,而非之後才定義(
quality.md)。
錯誤症狀與含義
解碼規則:顯示損壞的層級說明了原因。亂碼是位元組問題;數字周圍的錯誤語法是複數規則問題;從未更改的字串表示從未被提取。
| 症狀 | 最可能的原因 | 第一步 |
|---|---|---|
é、’、ñ | 鏈中的某處將 UTF-8 位元組解碼為 Latin-1 | 找出那個假設使用舊編碼的跳躍點;切勿透過重新打字來「修正」(rtl-and-scripts.md) |
文字應出現處出現 ????? 或 _____ | 轉換為單一位元組字元集時發生有損轉換,通常在資料庫或匯出邊界 | 檢查資料行字元集和連線字元集,然後從來源重新匯出 |
| 空方塊(豆腐塊)或後備字體 | 字體缺少該書寫系統 — 這是渲染問題,而非編碼問題 | 檢查字體對該書寫系統的覆蓋範圍,而非檔案 |
| 無論地區設定為何,字串始終維持英文 | 從未被提取,或框架從未獲得地區設定 | 在原始碼中搜尋該字串;然後在執行時期確認解析後的地區設定(software-strings.md) |
翻譯後出現崩潰或 %!s(MISSING) | 目標語言中的佔位符數量或順序發生變化 | 每個段落的佔位符一致性檢查(輸出閘道);使用位置形式(例如 %1$s) |
| 在 2、21 或 101 個項目時出現錯誤語法 | 目錄中缺少目標語言的 CLDR 類別 | 在檔案層級添加缺失的類別(規則 4) |
韓文文字顯示 이(가) 或 을(를) | 助詞由前一個音節的終聲所決定,無法透過串接實現 | 改寫句子以避免使用該助詞,或使用能進行詞形變化的框架(locales.md) |
| 阿拉伯語句子以句號在左側結尾 | 雙向演算法在文字上正確運作 |
...(為翻譯而截斷)