本文参考https://translations.readthedocs.io/en/latest/flask-babel.html做了修改,如有疑问请指正。
修改如下:
在终l端执行pybabel --list-locales命令,查看本机支持的语言,发现中文支持是zh_Hans_CN,而非zh_CN。所以在以下文章中,把zh_CN做下修改即可。修改的地方有两处,一处是命令,一处是文件。
安装 Flask-Babel
Flask-Babel是 Flask 的翻译扩展工具。安装命令如下:
pip install flask-babel
安装它的时候会顺便安装Babel、pytz、speaklater这三个包,其中 Babel 是 Python 的一个国际化工具包。pytz 是处理时区的工具包,speaklater 相当于是 Babel 的一个辅助工具,我们这里集中在翻译流程上,这几个工具就供以后进一步了解吧。
Hello, World
接下来我们做一个简单的 Hello World 程序,新建一个叫 hello 的文件夹,在其中创建一个叫 hello.py 的文件,内容如下:
image
然后在 hello.py 的同一级目录下创建一个叫 templates 的文件夹,在其中写一个 index.html,内容如下:
image
很简单的 Hello World 程序,接下来我们要做的是让这个站变成中文站。
更新程序和模板
再接下来就是翻译了。翻译需要用到 flask-babel 这个 flask 扩展。首先我们将这个 app “国际化”,为模板和 .py 文件中的每一个字符串添加一个 gettext 函数,由于 gettext 函数被引用的次数太多了,为了方便手写,就将其 import 为 “_”:
image
然后修改模板:
image
你可以注意到我们对 app 的 locale 做了配置,然后用 babel 扩展将 app 再次初始化,并且将 .py 和 .html 中的字符串做了配置,让它们都使用gettext这个函数。其中值得注意的是gettext的格式化字符串的参数。如果直接用类似"It's %s today"% day是不行的。
这么一来,app 的语言其实是被写死成中文了。其实你可以在 flask 程序中让用户选择自己喜好的语言,或者依据浏览器设置用户优先显示的语言,详细做法可以参考官方文档中提到localeselector的部分。
设置 Babel
接下来我们要做的是 babel 的配置。在 hello.py 的同级目录创建一个叫 babel.cfg 的文件,内容如下:
image
生成翻译模板
这样 babel 就知道要从哪些位置搜索要翻译的字符串了。然后我们用 pybabel 生成要翻译的 PO 模板文件,这个命令是 babel 这个工具包带来的,生成翻译模板命令如下:
$ pybabel extract -F babel.cfg -o messages.pot .
注意结尾的点“.”,这个点表示当前目录,目录是 pybabel 必须的参数,官方文档中缺少这个点,所以命令是无法执行成功的。messages.pot 就是我们生成的翻译模板文件,内容大致如下:
#Translations template for PROJECT.
# Copyright (C) 2017 ORGANIZATION
# This file is distributed under the same license as the PROJECT project.
# FIRST AUTHOR , 2017.
#
#, fuzzy
msgid""
msgstr""
"Project-Id-Version: PROJECT VERSIONn"
"Report-Msgid-Bugs-To: EMAIL@ADDRESSn"
"POT-Creation-Date: 2017-03-22 13:46 0800n"
"PO-Revision-Date: YEAR-MO-DA HO:MI ZONEn"
"Last-Translator: FULL NAME n"
"Language-Team: LANGUAGE n"
"MIME-Version: 1.0n"
"Content-Type: text/plain; charset=utf-8n"
"Content-Transfer-Encoding: 8bitn"
"Generated-By: Babel 2.3.4n"
#: hello.py:10
msgid"Saturday"
msgstr""
#: templates/index.html:1
msgid"Flask International"
msgstr""
#: templates/index.html:2
msgid"Hello, World!"
msgstr""
#: templates/index.html:3
#, python-format
msgid"It's %(day)s today"
msgstr""
你可以修改里边头文件的信息,把个人和项目相关的资料加进去。
翻译
接下来我们创建中文翻译:
$ pybabel init -i messages.pot -d translations -l zh_Hans_CN
这句命令会在 hello 文件夹中生成一个 translations 文件夹,要确保 flask 能找到翻译内容,translations文件夹要和 templates 文件夹在同一个目录中。接下来我们就可以进行翻译了,修改translations/zh_Hans_CN/LC_MESSAGES/messages.po文件,将其中的内容翻译过来:
# Chinese (Simplified, China) translations for PROJECT.
# Copyright (C) 2017 ORGANIZATION
# This file is distributed under the same license as the PROJECT project.
# FIRST AUTHOR , 2017.
#
msgid""
msgstr""
"Project-Id-Version: PROJECT VERSIONn"
"Report-Msgid-Bugs-To: EMAIL@ADDRESSn"
"POT-Creation-Date: 2017-03-22 13:46 0800n"
"PO-Revision-Date: 2017-03-22 13:42 0800n"
"Last-Translator: n"
"Language: zh_Hans_CNn"
"Language-Team: zh_Hans_CN n"
"Plural-Forms: nplurals=1; plural=0n"
"MIME-Version: 1.0n"
"Content-Type: text/plain; charset=utf-8n"
"Content-Transfer-Encoding: 8bitn"
"Generated-By: Babel 2.3.4n"
#: hello.py:10
msgid"Saturday"
msgstr"星期六"
#: templates/index.html:1
msgid"Flask International"
msgstr"Flask国际化"
#: templates/index.html:2
msgid"Hello, World!"
msgstr"哈喽,世界"
#: templates/index.html:3
#, python-format
msgid"It's %(day)s today"
msgstr"今天是%(day)s"
PO文件的翻译其实可以用专门的工具来编辑,比如Poedit,不过小文件直接手译就可以了。
编译翻译结果
翻译完后执行下面的命令,为其编译出 message.mo 文件:
$ pybabel compile -d translations
如果上述命令无法生成 messages.mo 文件,那你需要将 message.po 中的#,fuzzy删除。
然后就算基本完成了。这时执行 python hello.py 就会看到翻译的中文页面了。
更新翻译
有时我们需要对程序和模板做修改,翻译也要随之更新。更新后需要用前面的命令重新生成 messages.pot 文件,然后使用下面的命令将更新的内容 merge 到原来的翻译中:
$ pybabel update -i messages.pot -d translations
最后再到对应 locale 的文件夹下更新翻译并 compile 即可。
项目结构: