gettext模塊實現Python國際化支持

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

wKioL1WDhE3CLn17AADJcWAjfXI010.jpg

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

# -*- coding: utf-8 -*-

import gettext

_ = gettext.gettext

if __name__ == "__main__":
    print _("hello world")

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

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

wKiom1WDguHzRci0AADH-xP3uNM159.jpg(d)用msginit生成對應於不同語言翻譯的文件.po,例如簡體中文zh_CN和英文en:

wKiom1WDgz6gdpv-AALr-syQif8893.jpg

wKiom1WDhtHS6KrMAALkxrIkWik590.jpg注意過程中,可能會詢問你的email地址,直接回車即可

(e)編輯po文件,填寫需要翻譯的字符串對應的譯文字符串,例如zh_CN.po:

wKioL1WDicqihPXtAAMHbJqjuSU263.jpg這裏msgid後面的字符串就是需要翻譯的字符串,msgstr後面就是譯文字符串。對en.po重複(e)操作

(f)使用msgfmt命令從po生成二進制文件mo,也是應用程序需要使用的文件。

先在工程目錄下創建存放mo文件的locale目錄,目錄結構要和系統的locale目錄結構一樣:

wKioL1WDwoWyf5RbAACi_Xq8OCY963.jpg

然後在對應目錄下生成不同的mo文件

wKiom1WDyU2B_qPiAADTVvh4PeM059.jpg

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

補充:

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

另外,一旦python代碼中要翻譯的字符串發生變化(修改、增刪),需要重新生成po文件時,可以用msgmerge命令來代替msginit命令,例如:

msgmerge -U zh_CN.po my_app.pot

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

    第一部分介紹gettext模塊時,gettext模塊有兩種使用方式。第一種是根據用戶系統的語言配置(系統的環境變量LANGUAGELC_ALLLC_MESSAGESLANG),自動選擇語言;第二種是在程序中實時切換語言。

(1)根據用戶系統的語言配置自動選擇語言

打開my_app.py, 編輯代碼並保存:

# -*- coding: utf-8 -*-

import os
import gettext

APP_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.gettext

if __name__ == "__main__":
    print _("hello world")

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

wKioL1WD1HzCdiBwAAC21atLpyA238.jpg

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

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

wKiom1WD0yrTOrXiAADT7OEFNgk237.jpg

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

(2)在程序中實時切換語言

打開my_app.py, 編輯代碼並保存:

# -*- coding: utf-8 -*-
import os
import gettext

APP_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,運行結果如下:

wKiom1WD1hfw25zDAAB3Lm6gPAM378.jpg

可以看到,可以在程序中同時輸出中文和英文。


到此爲止,兩種在python中添加國際化支持的方式介紹完畢。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章