使用 Loco Translate 上傳外掛中文化 PO 檔時,檔名不要更改

使用 Loco Translate 上傳外掛中文化 PO 檔時,檔名不要更改

在 WordPress 裡做外掛中文化時,很多人會使用 Loco Translate 來管理翻譯檔。Loco Translate 可以讓我們在後台編輯 PO 檔、產生 MO 檔,也可以用來上傳或匯入外掛的翻譯檔。

不過使用 Loco Translate 上傳 PO 檔時,有一個很重要的小細節:PO 檔的檔名不可以隨便更改

有時候翻譯內容明明已經修好,台灣用語也調整好了,可是上傳到 Loco Translate 之後,網站卻沒有正確套用翻譯。這時候不一定是翻譯內容有問題,也可能只是檔名被改掉了。

為什麼用 Loco Translate 上傳 PO 檔時,檔名很重要?

WordPress 外掛中文化檔案通常會依照「外掛文字網域」和「語系代碼」命名。Loco Translate 在辨識語言檔時,也會根據這些資訊來判斷這個翻譯檔要套用在哪個外掛、哪個語言。

以 WooCommerce 的台灣繁體中文 PO 檔為例,正確檔名應該是:

woocommerce-zh_TW.po

對應的 MO 檔則應該是:

woocommerce-zh_TW.mo

這個檔名不是只是方便辨識而已,它會影響 WordPress 和 Loco Translate 是否能正確對應這份外掛中文化檔案。

最常見的問題:下載後檔名變成 (1) 或 (2)

使用 Loco Translate 上傳 PO 檔前,很多人會先從網路下載修正版中文化檔案。這時候常見的問題是,原本檔名應該是:

woocommerce-zh_TW.po

可是下載到電腦後,卻變成:

woocommerce-zh_TW(1).po
woocommerce-zh_TW(2).po

這通常不是 PO 檔內容壞掉,而是因為你的電腦下載資料夾裡已經有同名檔案,瀏覽器為了避免覆蓋舊檔,就自動在檔名後面加上 (1)(2)

但是這種檔名不適合直接上傳到 Loco Translate。因為檔名已經不是外掛原本應該使用的語言檔名稱,可能會造成翻譯沒有正確套用。

上傳到 Loco Translate 前,一定要先改回正確檔名

如果你下載後看到檔名變成:

woocommerce-zh_TW(2).po

請不要直接上傳到 Loco Translate。正確做法是先把檔名改回:

woocommerce-zh_TW.po

如果你同時有 MO 檔,也要確認 MO 檔名稱正確,例如:

woocommerce-zh_TW.mo

簡單來說,翻譯內容可以修正,但檔案名稱要維持原本格式。

不要把檔名改成 corrected、fixed 或新版

有些人在整理外掛中文化檔案時,會為了方便辨識,把檔名改成:

woocommerce-zh_TW-corrected.po
woocommerce-zh_TW-fixed.po
woocommerce-zh_TW-new.po
woocommerce-zh_TW-修正版.po

這樣在自己電腦裡備份可以理解,但如果要上傳到 Loco Translate 使用,就不建議這樣做。

Loco Translate 要讀取的是外掛對應的正確語言檔名稱。檔名多了一段文字,就可能變成無法正確對應的檔案。

PO 檔和 MO 檔都要注意

外掛中文化常見會有兩種檔案:PO 檔和 MO 檔。

PO 檔是可以編輯的翻譯檔,裡面會有原文和翻譯文字。MO 檔則是 WordPress 實際讀取的編譯檔。

使用 Loco Translate 編輯翻譯後,通常會產生或更新對應的 MO 檔。如果你是手動上傳翻譯檔,也要注意 PO 和 MO 的檔名都要正確。

以 WooCommerce 為例,正確應該是:

woocommerce-zh_TW.po
woocommerce-zh_TW.mo

不要變成:

woocommerce-zh_TW(1).po
woocommerce-zh_TW(1).mo

檔名錯誤可能造成翻譯沒有生效

如果使用 Loco Translate 上傳 PO 檔後,發現外掛後台還是英文,或部分翻譯沒有套用,可以先檢查檔名是否正確。

檔名錯誤時,可能會出現這些情況:

  • 外掛中文化沒有生效。
  • 後台還是顯示英文。
  • Loco Translate 找不到正確的語言檔。
  • 翻譯已經修改,但網站畫面沒有變化。
  • 以為 PO 檔壞掉,其實只是檔名被改了。

所以遇到外掛中文化沒有生效時,不要只檢查翻譯內容,也要先看檔名有沒有被瀏覽器自動加上 (1)(2)

比較保險的下載與上傳方式

為了避免上傳到 Loco Translate 時檔名出錯,建議可以這樣做:

  1. 下載 PO 檔前,先清理下載資料夾裡的舊語言檔。
  2. 下載後先確認檔名是否正確。
  3. 如果檔名多了 (1)(2),先手動改回原本名稱。
  4. 再進入 WordPress 後台的 Loco Translate 上傳或匯入 PO 檔。
  5. 上傳後儲存翻譯,確認 MO 檔也有正確產生。

如果瀏覽器一直自動改檔名,也可以使用「另存連結為」的方式下載,並手動指定正確檔名。

外掛中文化檔案可以放資料夾分類,但不要改檔名

如果你會整理很多外掛中文化檔案,可以用資料夾分類,例如:

WooCommerce 中文化檔案
Elementor Pro 中文化檔案
FluentCRM 中文化檔案

這樣管理沒有問題。

但資料夾裡面的 PO / MO 檔名稱,還是要維持外掛原本需要的檔名格式。也就是說,可以改資料夾名稱,但不要改語言檔本身的檔名。

結論:用 Loco Translate 上傳 PO 檔前,先確認檔名

使用 Loco Translate 做外掛中文化時,除了翻譯內容要正確,檔名也很重要。

請記得一個原則:

翻譯內容可以修正,但 PO 檔和 MO 檔的檔名不要更改。

如果下載後檔名變成 (1)(2),請先手動改回正確名稱,再上傳到 Loco Translate。這個動作很小,但可以避免很多外掛中文化無法生效的問題。


元氣站長
元氣站長

經營網路事業,賺取持續收入!
網路賺錢修煉,成就理想人生!