Flask - Babel

文檔:https://pythonhosted.org/Flask-Babel/




安裝 Flask-Babel

Flask-Babel 是 Flask 的翻譯擴(kuò)展工具置鼻。安裝命令如下:

pip install flask-babel

安裝它的時(shí)候會(huì)順便安裝 Babelpytz蘸嘶、speaklater 這三個(gè)包,其中 Babel 是 Python 的一個(gè)國(guó)際化工具包。pytz 是處理時(shí)區(qū)的工具包,speaklater 相當(dāng)于是 Babel 的一個(gè)輔助工具活箕。




在 flask 項(xiàng)目應(yīng)用 babel

新建一個(gè) app.py 文件:

from flask import Flask, render_template, request

from flask_babel import Babel, gettext as _

app = Flask(__name__)
app.config['BABEL_DEFAULT_LOCALE'] = 'en'
app.config['BABEL_DEFAULT_TIMEZONE'] = 'UTC'

babel = Babel(app)


@babel.localeselector
def get_locale():
    return request.accept_languages.best_match(['zh', 'en'])

@app.route('/')
def hello():
    day = _("Saturday")
    return render_template('index.html', day=day)

if __name__ == '__main__':
    app.debug = True
    app.run()

flask_babel 引入 Babel 模塊和 gettext 函數(shù),因?yàn)?gettext 函數(shù)被引用的次數(shù)太多了,為了方便手寫(xiě)晴埂,就將其 import 為 “_”齐遵。

通過(guò)下列方式初始化 babel 應(yīng)用:

babel = Babel(app)

設(shè)置 babel 的配置項(xiàng):

app.config['BABEL_DEFAULT_LOCALE'] = 'en'
app.config['BABEL_DEFAULT_TIMEZONE'] = 'UTC'

默認(rèn)語(yǔ)言設(shè)置為英語(yǔ),默認(rèn)時(shí)區(qū)設(shè)置為 UTC规辱。

我們需要定義一個(gè)函數(shù)來(lái)讓 babel 獲取當(dāng)前的語(yǔ)言選項(xiàng):

@babel.localeselector
def get_locale():
    return request.accept_languages.best_match(['zh', 'en'])

該函數(shù)從瀏覽器的 cookies 中的 accept_languages 獲取語(yǔ)言設(shè)置,視情況返回 zh(中文)或 en(英文)。

下劃線函數(shù)摸恍,如:_("Saturday"),就是需要被翻譯的字符串赤屋。

現(xiàn)在新建 templates 目錄立镶,在里面新建 index.html 文件:

<head>
    <meta charset="UTF-8">
    <title>index</title>
</head>

<p>{{ _("Hello, world!") }}</p>
<p>{{ _("It's %(day)s today", day=day) }}</p>




設(shè)置 Babel

接下來(lái)我們要做的是 babel 的配置。在 app.py 的同級(jí)目錄創(chuàng)建一個(gè)叫 babel.cfg 的文件类早,內(nèi)容如下:

[python: **.py]
[jinja2: **/templates/**.html]
extensions=jinja2.ext.autoescape,jinja2.ext.with_




生成翻譯模板

$ pybabel extract -F babel.cfg -o messages.pot .

執(zhí)行上述命令后會(huì)生成 messages.pot 文件媚媒,這就是我們的的翻譯模板文件。內(nèi)容大致這樣:

# Translations template for PROJECT.
# Copyright (C) 2018 ORGANIZATION
# This file is distributed under the same license as the PROJECT project.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2018.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PROJECT VERSION\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
"POT-Creation-Date: 2018-10-26 10:04+0800\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.6.0\n"

#: app.py:13
msgid "Saturday"
msgstr ""

#: templates/index.html:1
msgid "Hello, world!"
msgstr ""

#: templates/index.html:2
#, python-format
msgid "It's %(day)s today"
msgstr ""




翻譯

接下來(lái)我們創(chuàng)建中文翻譯:

$ pybabel init -i messages.pot -d translations -l zh

執(zhí)行命令后會(huì)生成一個(gè) translations 文件夾涩僻,翻譯模板就在
translations/zh/LC_MESSAGES/messages.po 文件里缭召。

在該文件中我們可以給需要翻譯的字符串進(jìn)行翻譯:

# Chinese translations for PROJECT.
# Copyright (C) 2018 ORGANIZATION
# This file is distributed under the same license as the PROJECT project.
# FIRST AUTHOR <EMAIL@ADDRESS>, 2018.
#
msgid ""
msgstr ""
"Project-Id-Version: PROJECT VERSION\n"
"Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
"POT-Creation-Date: 2018-10-26 10:04+0800\n"
"PO-Revision-Date: 2018-10-26 10:03+0800\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: zh\n"
"Language-Team: zh <LL@li.org>\n"
"Plural-Forms: nplurals=1; plural=0\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.6.0\n"

#: app.py:13
msgid "Saturday"
msgstr "星期六"

#: templates/index.html:1
msgid "Hello, world!"
msgstr "哈嘍栈顷,世界!"

#: templates/index.html:2
#, python-format
msgid "It's %(day)s today"
msgstr "今天是%(day)s"




編譯翻譯結(jié)果

翻譯完后執(zhí)行下面的命令:

$ pybabel compile -d translations

這時(shí)會(huì)編譯出 message.mo 文件嵌巷。如果上述命令無(wú)法生成 messages.mo 文件萄凤,那你需要將 message.po 中的 #, fuzzy 刪除。

編譯完成后翻譯就已經(jīng)生效了搪哪,這時(shí)來(lái)看看我們的網(wǎng)頁(yè):

看看瀏覽器的 accept_languages 信息靡努,可以看到是中文:




更新翻譯

當(dāng)我們修改了 messages.po 文件中的翻譯時(shí),可用以下命令更新:

pybabel update -i messages.pot -d translations

然后重新執(zhí)行編譯命令:

pybabel compile -d translations
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末晓折,一起剝皮案震驚了整個(gè)濱河市颤难,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌已维,老刑警劉巖行嗤,帶你破解...
    沈念sama閱讀 219,188評(píng)論 6 508
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異垛耳,居然都是意外死亡栅屏,警方通過(guò)查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,464評(píng)論 3 395
  • 文/潘曉璐 我一進(jìn)店門(mén)堂鲜,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)栈雳,“玉大人,你說(shuō)我怎么就攤上這事缔莲「缛遥” “怎么了?”我有些...
    開(kāi)封第一講書(shū)人閱讀 165,562評(píng)論 0 356
  • 文/不壞的土叔 我叫張陵痴奏,是天一觀的道長(zhǎng)蛀骇。 經(jīng)常有香客問(wèn)我,道長(zhǎng)读拆,這世上最難降的妖魔是什么擅憔? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 58,893評(píng)論 1 295
  • 正文 為了忘掉前任,我火速辦了婚禮檐晕,結(jié)果婚禮上暑诸,老公的妹妹穿的比我還像新娘。我一直安慰自己辟灰,他們只是感情好个榕,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,917評(píng)論 6 392
  • 文/花漫 我一把揭開(kāi)白布。 她就那樣靜靜地躺著芥喇,像睡著了一般西采。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上乃坤,一...
    開(kāi)封第一講書(shū)人閱讀 51,708評(píng)論 1 305
  • 那天苛让,我揣著相機(jī)與錄音沟蔑,去河邊找鬼。 笑死狱杰,一個(gè)胖子當(dāng)著我的面吹牛瘦材,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播仿畸,決...
    沈念sama閱讀 40,430評(píng)論 3 420
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼食棕,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來(lái)了错沽?” 一聲冷哼從身側(cè)響起簿晓,我...
    開(kāi)封第一講書(shū)人閱讀 39,342評(píng)論 0 276
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎千埃,沒(méi)想到半個(gè)月后憔儿,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 45,801評(píng)論 1 317
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡放可,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,976評(píng)論 3 337
  • 正文 我和宋清朗相戀三年谒臼,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片耀里。...
    茶點(diǎn)故事閱讀 40,115評(píng)論 1 351
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡蜈缤,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出冯挎,到底是詐尸還是另有隱情底哥,我是刑警寧澤,帶...
    沈念sama閱讀 35,804評(píng)論 5 346
  • 正文 年R本政府宣布房官,位于F島的核電站趾徽,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏易阳。R本人自食惡果不足惜附较,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,458評(píng)論 3 331
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望潦俺。 院中可真熱鬧,春花似錦徐勃、人聲如沸事示。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 32,008評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)肖爵。三九已至,卻和暖如春臀脏,著一層夾襖步出監(jiān)牢的瞬間劝堪,已是汗流浹背冀自。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 33,135評(píng)論 1 272
  • 我被黑心中介騙來(lái)泰國(guó)打工, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留秒啦,地道東北人熬粗。 一個(gè)月前我還...
    沈念sama閱讀 48,365評(píng)論 3 373
  • 正文 我出身青樓,卻偏偏與公主長(zhǎng)得像余境,于是被迫代替她去往敵國(guó)和親驻呐。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,055評(píng)論 2 355

推薦閱讀更多精彩內(nèi)容