技術文件目前產品線：Loco Translate 翻譯

Loco Translate 的 Sync（同步）功能教學

更新日期
閱讀時間
約 4 分鐘
來源狀態
generated-draft

本篇說明

Loco Translate 的檔案編輯器內建 Sync 按鈕，可將目前可用的原始字串套用到翻譯檔或範本檔，讓翻譯內容跟上主題或外掛的最新原始字串狀態。

適合誰使用

使用 Loco Translate 外掛管理網站多語系翻譯檔的 WordPress 網站管理員與翻譯人員

開始前準備

  • 需先了解 POT（範本）檔案的運作方式
  • 若無範本檔，需先閱讀如何在沒有翻譯範本時新增語言的說明

教學內容

Sync 功能的用途

Sync 按鈕位於檔案編輯器工具列中，功能是抓取目前可用的可翻譯原始字串並更新檔案

Sync 大致分成兩種：從範本更新翻譯檔（合併），以及從原始碼更新範本檔（擷取）

更新翻譯檔（PO 檔合併）

這個流程會抓取目前可用的原始字串並套用到現有的 PO 檔

先前不存在的新字串會被加入，並顯示為未翻譯狀態

範本中已不存在的字串可能會被移除

  1. 在後台開啟要同步的 PO 檔案編輯器
  2. 按下工具列中的 Sync 按鈕
  3. 編輯器更新後會顯示變更摘要，但尚未儲存到磁碟
  4. 確認變更無誤後按下 Save 儲存；若覺得有問題則不要儲存
  5. 若變更看起來不對，先開啟範本檔確認內容是否正確且為最新版本
  6. 若是與另一個 PO 檔同步而非使用範本，需先確認該檔案本身已是最新狀態

擷取字串（更新範本 POT 檔）

此功能主要提供給主題與外掛開發者使用，官方建議翻譯人員與網站擁有者改用 Copy 功能，不要自行產生範本

此流程會從外掛或主題套件的 PHP 檔案抓取最新原始字串

原始碼中已不存在的可翻譯字串會被移除，新字串則會被加入

  1. 點選 Edit template 以在檔案編輯器中開啟範本檔
  2. 按下工具列中的 Sync 按鈕
  3. 確認編輯器顯示的變更摘要，滿意後按下 Save 儲存

保持檔案同步的注意事項

每次更新 WordPress 後都必須手動執行同步，因為主題或外掛的原始字串可能已改變

Loco Translate 刻意不自動執行同步，以避免在使用者不知情的情況下產生錯誤

自 2.4.5 版起提供兩個 WP-CLI 指令可用於擷取字串與同步翻譯，可一次同步所有套件，但使用時須小心

模糊比對（Fuzzy matching）

Sync 過程中若原始字串已有些微變動，系統會嘗試模糊比對，將舊翻譯保留並標記為 Fuzzy 提醒需要覆核

自 2.4.5 版起可在外掛設定中調整模糊比對的容許度百分比（0-100），數值為 0 表示完全停用模糊比對

此功能使用 Levenshtein distance 演算法比較新舊字串的相似度，找出容許範圍內最相似的配對

介面名稱對照

  • Sync：檔案編輯器工具列中的按鈕，用來抓取目前可用的原始字串並更新翻譯檔或範本檔
  • Save：儲存按鈕，Sync 後需按下此按鈕才會將變更寫入磁碟
  • Edit template：用來在檔案編輯器中開啟範本（POT）檔案的選項
  • Fuzzy：標記翻譯字串為模糊狀態，代表原始字串已變動，需要人工覆核翻譯內容
  • WP-CLI：命令列工具，2.4.5 版起可用其指令批次擷取字串與同步翻譯

注意事項

注意

Sync 之後的變更不會立即儲存，務必確認內容正確後才按 Save，否則可能誤存不正確的翻譯結果

注意

官方不建議翻譯人員或網站擁有者自行產生 POT 範本檔，應改用 Copy 功能

注意

執行 WP-CLI 的同步指令前，建議先備份網站，因為這類操作仍可能出錯

注意

模糊比對的相似度比較不區分英數字大小寫，但對多位元組字元（如重音符號）不完全安全

常見問題

Sync 之後如果覺得結果不對該怎麼辦？

不要按下 Save 儲存。應先開啟範本檔案，確認其內容是否正確且為最新版本；若範本內容與預期不符，應聯繫提供範本的人員確認。

為什麼 Loco Translate 不會自動同步檔案？

因為官方認為自動同步容易在使用者不知情的情況下產生錯誤，且無法保證所有主題與外掛的檔案都是正確且最新的，因此刻意設計為需要手動執行。

什麼情況下翻譯字串會被標記為 Fuzzy？

當原始字串只有些微變動時，系統可能判斷新字串是舊字串的修改版，此時會保留舊翻譯內容並標記為 Fuzzy，提示翻譯人員應對照最新原文重新檢查。

官方來源

還是卡住了？

先把問題問清楚，通常比直接開工單更快。複製下面的結構，補上你的情況後送出。

用 AI 先釐清問題

/ai 我正在閱讀「Loco Translate 的 Sync（同步）功能教學」，目前卡在：

我已嘗試：

我看到的畫面／錯誤訊息：

請用一步一步的方式告訴我下一步。

需要我們實際進入網站調整設定、修改佈景主題或處理資料時，再建立 /task 工單。