美文网首页
Flask - Babel

Flask - Babel

作者: SingleDiego | 来源:发表于2018-10-26 15:50 被阅读50次

    文档: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 删除。

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

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




    更新翻译

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

    pybabel update -i messages.pot -d translations
    

    然后重新执行编译命令:

    pybabel compile -d translations
    

    相关文章

      网友评论

          本文标题:Flask - Babel

          本文链接:https://www.haomeiwen.com/subject/jvzktqtx.html