专栏首页sktjflask babel国际化(flask 101)

flask babel国际化(flask 101)

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


安装 Flask-Babel

Flask-Babel 是 Flask 的翻译扩展工具。安装命令如下:

pip install flask-babel

安装它的时候会顺便安装 Babelpytzspeaklater 这三个包,其中 Babel 是 Python 的一个国际化工具包。pytz 是处理时区的工具包,speaklater 相当于是 Babel 的一个辅助工具。


在 flask 项目应用 babel

新建一个 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 函数,因为 gettext 函数被引用的次数太多了,为了方便手写,就将其 import 为 “_”。

通过下列方式初始化 babel 应用:

babel = Babel(app)

设置 babel 的配置项:

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

默认语言设置为英语,默认时区设置为 UTC。

我们需要定义一个函数来让 babel 获取当前的语言选项:

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

该函数从浏览器的 cookies 中的 accept_languages 获取语言设置,视情况返回 zh(中文)或 en(英文)。

下划线函数,如:_("Saturday"),就是需要被翻译的字符串。

现在新建 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>

设置 Babel

接下来我们要做的是 babel 的配置。在 app.py 的同级目录创建一个叫 babel.cfg 的文件,内容如下:

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

生成翻译模板

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

执行上述命令后会生成 messages.pot 文件,这就是我们的的翻译模板文件。内容大致这样:

# 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 ""

翻译

接下来我们创建中文翻译:

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

执行命令后会生成一个 translations 文件夹,翻译模板就在 translations/zh/LC_MESSAGES/messages.po 文件里。

在该文件中我们可以给需要翻译的字符串进行翻译:

# 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"

编译翻译结果

翻译完后执行下面的命令:

$ pybabel compile -d translations

这时会编译出 message.mo 文件。如果上述命令无法生成 messages.mo 文件,那你需要将 message.po 中的 #, fuzzy 删除。

编译完成后翻译就已经生效了,这时来看看我们的网页:

image

看看浏览器的 accept_languages 信息,可以看到是中文:

image


更新翻译

当我们修改了 messages.po 文件中的翻译时,可用以下命令更新:

pybabel update -i messages.pot -d translations

然后重新执行编译命令:

pybabel compile -d translations

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • flask babel使用(flask 107)

    本文参考https://translations.readthedocs.io/en/latest/flask-babel.html做了修改,如有疑问请指正。

    用户5760343
  • Flask-Admin修改成中文显示

    今天的文章的主题是国际化和本地化,通常简称 I18n 和 L10n。我们想要我们的 microblog 应用程序被尽可能多的用户使用,因为我们不能忘记有许多人是...

    菲宇
  • 带你认识 flask 国际化和本地化

    你猜对了,Flask-Babel正是用于简化翻译工作的。可以使用pip命令安装它:

    公众号---人生代码
  • mdwiki开发之路一技术选型

    mdwiki是一款markdown wiki系统,可以作为个人或小型团队的知识库管理系统。项目地址:本系列文章最后一篇给出(需要时间整理和测试)

    py3study
  • 一小时内搭建一个全栈Web应用框架

    把想法变为现实的能力是空想家与实干家的区别。不管你是在一家跨国公司工作,还是正在为自己的创业公司而努力,那些有能力将创意转化为真正产品的人,都具有宝贵的技能并拥...

    疯狂的技术宅
  • 使用Flask搭建个人博客

    我的个人博客从Hexo迁移到自建主机,主要是为了能自由的增减特性,和随时随地的更新博客(然而并没有)。所以考虑用Python的Web框架来写,由于我最开始是从F...

    岂不美哉Frost
  • 简单:SuperSet

    项目简介 本文是关于安装和配置直接从数据库中直接呈现的超酷和令人钦佩的D3图表,而无需任何特殊的API。这些工具名为 SuperSet,它来自Airbnb的团...

    py3study
  • 使用Flask和Vue.js开发一个单页面应用程序(一)

    首先,我会使用Vue CLI搭建一个新的Vue应用程序,然后通过Python和Flask支持的后端RESTful API执行基本的CRUD操作。

    TalkPython
  • python-成长之路

    ————————————–  https://github.com/Evlos/Python-Blog-RedisPress

    py3study
  • 001.Pip简介安装使用

    如果需要安装的包比较多的时候,单独安装比较繁琐,可通过一次安装的方法。首先新建一个文本文件,如:requirements.txt,然后将需要安装的包名保存到该文...

    木二
  • Flask+requests发起页面请求示例

    以登录禅道系统为例,传入post的参数包括url和data,data为json格式,包括:token、用户名、密码等,需要与实际接口传入的参数一致。

    乐大爷
  • flask_admin使用教程

    如果启动此应用程序并导航到http://localhost:5000/admin/,则应该会看到一个顶部带有导航栏的空白页。通过指定适合您需要的引导样本主题自...

    菲宇
  • istio-2:istio1.4.2-demo部署与体验,聊聊一些个人看法

    b.本文主要以《深入浅出Istio:Service Mesh快速入门与实践》中的python-flask-demo为例论述。

    Criss@陈磊
  • istio-2:istio1.4.2-demo部署与体验,聊聊一些个人看法

    b.本文主要以《深入浅出Istio:Service Mesh快速入门与实践》中的python-flask-demo为例论述。

    千里行走
  • Python Web 学习资料汇总

    image Test-Driven Development with Python

    马哥Python
  • 第 440 期 Python 周刊

    链接: https://adamj.eu/tech/2020/03/10/django-check-constraints-sum-percentage-fie...

    爱写bug
  • 【一周掌握Flask框架学习笔记】Flask概念及基础

    Web(World Wide Web)诞生最初的目的,是为了利用互联网交流工作文档。

    天道Vax的时间宝藏
  • 如何使用Flask编写Python Web API【Programming(Python)】

    在此快速教程中,使用Flask(增长最快的Python框架之一)从服务器获取数据。

    Potato
  • Flask-SQLALchemy 连接数据库

    在 Flask Web 框架中,Flask-SQLALchemy 扩展对数据库操作进行了封装,使用 Flask-SQLALchemy ,可以通过 Python ...

    Python碎片公众号

扫码关注云+社区

领取腾讯云代金券