gettext模組實現Python國際化支援

標籤：python   i18n   gettext   國際化   

1.gettext模組介紹

gettext模組為Python模組和應用程式提供國際化(i18n)和本地化(l10n)服務。它提供兩套API，一套高層的類似於GNU gettext的API和一套基於類的API。前者適用於單語言的情境，並且語言的選擇通常依賴於使用者的locale，會全域性地影響到你整個應用程式語言的轉譯。後者允許你在一個python模組內進行本地化，非常適用於在應用程式運行時切換你的語言。

2.通用步驟

（1）無論是使用哪一套API，都必須提取可以翻譯的字串並且產生一個翻譯模板檔案.pot

（2）然後產生對應於不同語言翻譯的檔案.po

（3）我們在應用程式中使用是的二進位格式的.mo檔案，由.po轉換而來

現在舉一個簡單例子來示範上述步驟

(a)建立一個工程目錄py_i18n，建立程式主檔案my_app.py

650) this.width=650;" src="http://s3.51cto.com/wyfs02/M00/6E/B2/wKioL1WDhE3CLn17AADJcWAjfXI010.jpg" title="g1.png" alt="wKioL1WDhE3CLn17AADJcWAjfXI010.jpg" />

(b)編輯my_app.py，先輸入以下內容

# -*- coding: utf-8 -*-import gettext_ = gettext.gettextif __name__ == "__main__":    print _("hello world")

這裡用_()括起來的字串就是需要翻譯的字串

(c)用xgetext來提取需要翻譯的字串產生翻譯模板

650) this.width=650;" src="http://s3.51cto.com/wyfs02/M02/6E/B6/wKiom1WDguHzRci0AADH-xP3uNM159.jpg" title="g2.png" alt="wKiom1WDguHzRci0AADH-xP3uNM159.jpg" />(d)用msginit產生對應於不同語言翻譯的檔案.po，例如簡體中文zh_CN和英文en：

650) this.width=650;" src="http://s3.51cto.com/wyfs02/M00/6E/B6/wKiom1WDgz6gdpv-AALr-syQif8893.jpg" title="g3.png" alt="wKiom1WDgz6gdpv-AALr-syQif8893.jpg" />

650) this.width=650;" src="http://s3.51cto.com/wyfs02/M00/6E/B6/wKiom1WDhtHS6KrMAALkxrIkWik590.jpg" title="g4.png" alt="wKiom1WDhtHS6KrMAALkxrIkWik590.jpg" />注意過程中，可能會詢問你的email地址，直接斷行符號即可

(e)編輯po檔案，填寫需要翻譯的字串對應的譯文字串,例如zh_CN.po：

650) this.width=650;" src="http://s3.51cto.com/wyfs02/M02/6E/B2/wKioL1WDicqihPXtAAMHbJqjuSU263.jpg" title="g5.png" alt="wKioL1WDicqihPXtAAMHbJqjuSU263.jpg" />這裡msgid後面的字串就是需要翻譯的字串，msgstr後面就是譯文字串。對en.po重複(e)操作

(f)使用msgfmt命令從po產生二進位檔案mo，也是應用程式需要使用的檔案。

先在工程目錄下建立存放mo檔案的locale目錄，目錄結構要和系統的locale目錄結構一樣：

650) this.width=650;" src="http://s3.51cto.com/wyfs02/M01/6E/B5/wKioL1WDwoWyf5RbAACi_Xq8OCY963.jpg" title="g6.png" alt="wKioL1WDwoWyf5RbAACi_Xq8OCY963.jpg" />

然後在對應目錄下產生不同的mo檔案

650) this.width=650;" src="http://s3.51cto.com/wyfs02/M01/6E/B9/wKiom1WDyU2B_qPiAADTVvh4PeM059.jpg" title="g7.png" alt="wKiom1WDyU2B_qPiAADTVvh4PeM059.jpg" />

ok! 到目前為止所有準備工作完成

補充：

注:上面的步驟也可以用poedit這款軟體完成，官網上有詳細的使用教程

另外，一旦python代碼中要翻譯的字串發生變化（修改、增刪），需要重建po檔案時，可以用msgmerge命令來代替msginit命令，例如:

msgmerge -U zh_CN.po my_app.pot

3.在Python代碼中添加國際化支援

    在第一部分介紹gettext模組時，gettext模組有兩種使用方式。第一種是根據使用者系統的語言配置（系統的環境變數LANGUAGE, LC_ALL, LC_MESSAGES, LANG），自動選擇語言；第二種是在程式中即時切換語言。

（1）根據使用者系統的語言配置自動選擇語言

開啟my_app.py, 編輯代碼並儲存:

# -*- coding: utf-8 -*-import osimport gettextAPP_NAME = "my_app"LOCALE_DIR = os.path.abspath("locale")# 將域APP_NAME與LOCALE_DIR目錄綁定，# 這樣gettext函數會在LOCALE_DIR目錄下搜尋對應語言的二進位APP_NAME.mo檔案gettext.bindtextdomain(APP_NAME, LOCALE_DIR)# 聲明使用現在的域，可以使用多個域，便可以為同一種語言提供多套翻譯，# 本程式只使用了一個域gettext.textdomain(APP_NAME)_ = gettext.gettextif __name__ == "__main__":    print _("hello world")

然後回到命令列視窗，檢查一下現在的語言配置，並運行python my_app.py:

650) this.width=650;" src="http://s3.51cto.com/wyfs02/M00/6E/B6/wKioL1WD1HzCdiBwAAC21atLpyA238.jpg" title="g8.png" alt="wKioL1WD1HzCdiBwAAC21atLpyA238.jpg" />

ok, 得到了正確的翻譯輸出！

我們可以嘗試切換語言，直接修改系統的環境變數:

650) this.width=650;" src="http://s3.51cto.com/wyfs02/M02/6E/BA/wKiom1WD0yrTOrXiAADT7OEFNgk237.jpg" title="g9.png" alt="wKiom1WD0yrTOrXiAADT7OEFNgk237.jpg" />

可以看到我們並未修改代碼，但是程式已經自動的輸出英文

（2）在程式中即時切換語言

開啟my_app.py, 編輯代碼並儲存:

# -*- coding: utf-8 -*-import osimport gettextAPP_NAME = "my_app"LOCALE_DIR = os.path.abspath("locale")# 這條語句會將_()函數自動放到python的內建命名空間中gettext.install(APP_NAME, LOCALE_DIR)# 擷取簡體中文翻譯類的執行個體lang_zh_CN = gettext.translation(APP_NAME, LOCALE_DIR, ["zh_CN"])# 擷取英文翻譯類的執行個體lang_en = gettext.translation(APP_NAME, LOCALE_DIR, ["en"])if __name__ == "__main__":    # 安裝中文    lang_zh_CN.install()    print _("hello world")    # 安裝英文（程式中即時切換回英文）    lang_en.install()    print _("hello world")

回到命令列直接運行python my_app.py，運行結果如下：

650) this.width=650;" src="http://s3.51cto.com/wyfs02/M01/6E/BA/wKiom1WD1hfw25zDAAB3Lm6gPAM378.jpg" title="g10.png" alt="wKiom1WD1hfw25zDAAB3Lm6gPAM378.jpg" />

可以看到，可以在程式中同時輸出中文和英文。

到此為止，兩種在python中添加國際化支援的方式介紹完畢。

本文出自 “UnderTheHood” 部落格，謝絕轉載！

gettext模組實現Python國際化支援