登入

支援的引擎 · Gettext (.po / .mo)

完整支援,已重新封裝並實機執行

PO 檔翻譯器 - 翻譯遊戲的 gettext .po 與 .mo 語言檔

gettext 是大多數非日系獨立遊戲採用的在地化方式:Python 與 pygame 遊戲、Solarus、SDL 與 GTK 遊戲,以及任何用過 Poedit、Weblate 或 Crowdin 的專案。文字以 .po 原始檔和已編譯的 .mo 語言檔形式放在 locale 目錄裡。RuneTranslate 在建立專案時會辨認出它們,翻譯每一筆字串,再寫回一個可用的 .mo,也就是執行中的遊戲實際讀取的檔案。

此引擎的詞彙表提示

gettext 語言檔大多是介面文字:選單項目、按鈕標籤、提示和狀態列,會在多個畫面反覆出現。把你的名詞、道具名稱和關鍵動詞加進詞彙表一次,之後每次出現都會保持一致。這比對話更重要,因為同一個詞在一處寫「保存」、另一處寫「儲存」,選單看起來就像 bug。

詞彙表入門

如何翻譯 Gettext (.po / .mo)

  1. 步驟 1

    開啟遊戲資料夾

    把 RuneTranslate 指向遊戲目錄,也就是含有 locale/、lang/ 或 i18n/ 資料夾的那一個。辨識依據是檔案的實際位元組,而不是副檔名,所以實際上是 3D 場景的 .mo 會被忽略。只放著零散 .po 檔的資料夾也能使用。

  2. 步驟 2

    查看辨識結果

    在你確認建立之前,新增專案對話方塊會顯示讀到多少個語言檔、其中有多少是已編譯的 .mo、多少是 .po 原始檔、遊戲已內建哪些語言,以及字串總數。

  3. 步驟 3

    選擇語言與翻譯服務

    選擇目標語言與翻譯服務:免費的 Google 或 DeepL,或是你自己的 DeepL、OpenAI、Claude、DeepSeek 金鑰。格式預留位置(%s、%d、%(player)s、{count})會在翻譯前先遮蔽、翻譯後再還原,任何服務都無法刪除或改寫它們。

  4. 步驟 4

    在編輯器中校對

    字串依語言檔分組。每一筆都保留它的 gettext 上下文(msgctxt),這是開發者特地為該字串寫下的區分說明,讓你看得出同一個詞為什麼出現兩次,並分別給出正確的譯文。

  5. 步驟 5

    匯出可遊玩的版本

    匯出會產生遊戲的完整副本,裡面既有標準的 locale/<你的語言>/LC_MESSAGES/ 語言檔,也有遊戲原本載入的語言檔的更新版,所以不論遊戲用什麼方式選擇語言,譯文都會顯示出來。.po 與已編譯的 .mo 都會寫入。

支援內容

  • 已編譯的 .mo 語言檔:可讀可寫,支援兩種位元組順序,已在 43 個真實語言檔、93,717 筆項目上驗證
  • .po 原始檔,包括複數形式、msgctxt 上下文、標記與譯者註解
  • 標準的 locale/<語言>/LC_MESSAGES/<網域>.mo 結構,以及 lang/tr.po 這類扁平結構
  • 複數形式會依目標語言重新調整(英文 2 種 → 俄文 3 種 → 日文 1 種),並同步改寫檔案標頭
  • printf 與大括號預留位置(%s、%d、%(player)s、{count}、{0})在翻譯期間先遮蔽、之後還原
  • 匯出時既寫入新語言,也覆蓋遊戲原本載入的那個語言檔

限制

  • 在依賴它之前,請先確認匯出的版本能夠啟動並正確顯示文字
  • 只有已經存在於語言檔中的文字會被翻譯。開發者從未交給 gettext 處理的字串不在 .po/.mo 裡,自然也就取不到
  • msgid 視為原文,這是 gettext 的慣例;如果某個語言檔的 msgid 是英文,而真正的來源語言在 msgstr 裡,就會從英文翻譯
  • 以已直接支援的引擎(Godot、Unity、Ren’Py……)製作的遊戲,由該引擎負責處理,這樣其餘文字也能一併取得
  • 未翻譯的項目會保留遊戲原有的譯文,不會被清空

延伸閱讀

延伸閱讀

文件

其他支援的引擎