部落格翻譯,SEO 最佳化翻譯
將現有部落格文章翻譯成一個或多個目標語言。與一般翻譯不同,此技能會產出 SEO 最佳化、可直接出版的內容,包含本地化的關鍵字、Meta 標籤與文化正確的格式設定。
主要參考資料
按需載入:
references/translation-rules.md,格式保留、每個地區的數字/日期/貨幣格式、引號處理、品質標準。references/cultural-adaptation.md,每個地區的文化設定檔(DACH、法語區、西班牙語區、日語、自訂)。此檔案與blog-localize共用(請勿重複)。
工作流程
階段 1:輸入解析
- 讀取來源檔案(Markdown、MDX 或 HTML)。
- 自動偵測來源語言。優先順序:
- Frontmatter 中的
lang欄位。 - HTML 的
lang屬性。 - 內容分析(文字系統、常見停用詞)。
- Frontmatter 中的
- 從
--to參數解析目標語言(以逗號分隔的 ISO 639-1 代碼,例如de,fr,es,ja,pt-BR)。如果缺少--to,則詢問使用者一次:「應翻譯成哪些語言?請提供 ISO 639-1 代碼(例如:de, fr, es, ja, pt-BR)。」 - 驗證每個代碼。拒絕無效代碼並提供建議(例如:
jp變成「您是否指的是ja(日語)?」)。如果目標語言與來源語言相同,則跳過該語言並發出通知。
階段 2:內容分析
提取可翻譯的文字層:
- Frontmatter:
title、description、tags、author(僅在可翻譯時,例如職稱標籤,非個人姓名)。 - 所有標題(H1、H2、H3)。
- 段落本文。
- 圖片的
alt文字及<figcaption>內容。 - 圖表中的
<text>與<tspan>內容;保留所有 SVG 屬性(x、y、font-size、fill、transform)。 - FAQ 問題與答案。
- 引用膠囊文字。
- 重點摘要或摘要框。
- CTA 文字。
- 內部連結區塊的錨點文字。
保持不變:
- Markdown 與 HTML 結構、標籤、屬性。
- 圖片 URL、連結 URL、frontmatter 鍵值。
- 程式碼區塊(僅在有意義時翻譯行內註解)。
- 內部連結區塊標記(
[INTERNAL-LINK: ...])。 - 引文中的組織名稱(Gartner、McKinsey 等)。
- 個人姓名。
- Schema JSON-LD 區塊(僅翻譯對使用者顯示的字串值)。
為階段 3 識別主要與次要關鍵字。
階段 3:關鍵字本地化
針對每個目標語言:
- 決定來源關鍵字在目標市場中是否為已建立的術語。如果是(例如「Content Marketing」在德文中保持不變),則保留。
- 如果在地對等詞具有真實搜尋行為,則替換為該詞。
- 對次要關鍵字應用相同邏輯。
- 記錄映射關係。翻譯代理將使用此映射一致地更新標題、Meta description 及 H2 標題。
階段 4:翻譯
為每個目標語言啟動 blog-translator 代理(透過 Task),並提供:
- 來源內容。
- 階段 3 的關鍵字本地化映射。
- 目標語言代碼。
- 指向
references/translation-rules.md的指標,以及references/cultural-adaptation.md中該目標地區的文化設定檔(如果存在)。
當翻譯為多種語言時,平行執行代理。
代理會回傳與輸入格式完全相同的已翻譯文章。
階段 5:後處理
對於每個翻譯版本:
- 新增或更新地區 frontmatter:
lang: "de" translatedFrom: "en" translatedDate: "YYYY-MM-DD" slug: "wie-man-ki-slop-vermeidet" - 驗證結構完整性:
- 與原文具有相同數量的 H2 與 H3 章節。
- 所有圖片皆存在且 alt 文字已翻譯。
- 所有 SVG 圖表皆存在且文字標籤已翻譯(長度調整:DE +30%,FR +15%,JA -20%,其他請參閱
references/translation-rules.md)。 - FAQ 數量相符。
- 每個 H2 中皆存在引用膠囊。
- 儲存翻譯檔案:
當從translations/ {lang}/{localized-slug}.{ext}blog-multilingual呼叫時,改為儲存至multilingual/{lang}/{localized-slug}.{ext}。
階段 6:翻譯品質護欄
在報告完成前掃描輸出,找出機器翻譯痕跡:
- 直譯的慣用語(英文慣用語被直譯,而非改寫)。
- 不自然的詞序(SOV 被翻譯成 SVO 到一個非 SVO 語言,或相反)。
- 混合語言句子(除了已建立的借詞)。
- 數字、日期或貨幣字串仍為來源格式。
- Frontmatter 字串仍為來源語言。
內聯標記每個問題(檔案路徑、行號、修正建議)。翻譯代理應在交付前重新處理任何被標記的段落。
階段 7:交付
## 翻譯完成:[原始標題]
### 來源
- 語言:[來源]
- 檔案:[來源路徑]
### 翻譯
| 語言 | 檔案 | 已適應關鍵字 | 狀態 |
|------|------|------------------|--------|
| de | translations/de/{slug}.md | [N] | ok |
| fr | translations/fr/{slug}.md | [N] | ok |
### 品質檢查
- 結構完整性:依語言顯示通過/失敗
- Meta 標籤已本地化:依語言顯示通過/失敗
- 數字、日期、貨幣格式已依地區設定:通過/失敗
- 關鍵字已本地化:[N] 個關鍵字已適應
- 機器翻譯痕跡標記:[N] 個(請參閱上方備註)
### 後續步驟
- 執行 `/blog localize <file> --locale <code>` 進行深度的文化適應。
- 執行 `/blog locale-audit translations/` 以驗證完整性。
- 使用 `/blog multilingual` 將寫作、翻譯、本地化、hreflang 結合在一個指令中。
錯誤處理
| 情境 | 動作 |
|---|---|
| 不支援的語言代碼 | 建議正確的 ISO 639-1 代碼 |
| 來源與目標相同 | 跳過並顯示「來源語言已是 [lang]」 |
| 找不到檔案 | 顯示錯誤並建議路徑 |
| 翻譯代理逾時 | 重試一次,然後回報部分結果 |
| 二進位或非文字檔案 | 顯示錯誤,建議正確檔案 |
交叉參考
- 下一步(文化深度):
/blog localize <file> --locale <code> - 所有語言版本的 QA 檢查:
/blog locale-audit <directory> - 單一指令管道:
/blog multilingual <topic> --languages <codes>