Flask-AppBuilder 国际化(i18n)支持详解-优快云博客

Flask-AppBuilder 国际化(i18n)支持详解

Flask-AppBuilder Simple and rapid application development framework, built on top of Flask. includes detailed security, auto CRUD generation for your models, google charts and much more. Demo (login with guest/welcome) - http://flaskappbuilder.pythonanywhere.com/ 项目地址: https://gitcode.com/gh_mirrors/fl/Flask-AppBuilder

什么是国际化(i18n)支持

国际化(Internationalization，简称i18n)是指让软件能够适应不同语言和地区需求的技术方案。在Flask-AppBuilder框架中，内置了完善的国际化支持，开发者可以轻松实现多语言界面。

框架内置语言支持

Flask-AppBuilder目前支持16种语言的界面翻译，包括：

中文
荷兰语
英语
法语
德语
日语
波兰语
葡萄牙语
巴西葡萄牙语
俄语
斯洛文尼亚语
西班牙语
希腊语
韩语
意大利语
土耳其语

这些翻译涵盖了框架内置的所有消息和界面元素。

配置国际化环境

初始化Babel配置

首先需要在项目根目录下创建babel目录，并添加babel.cfg配置文件：

[python: **.py]
[jinja2: **/templates/**.html]
encoding = utf-8

这个配置文件告诉Babel工具：

扫描所有.py文件
扫描templates目录下的所有HTML模板文件
使用UTF-8编码处理文件

初始化翻译文件

要为特定语言创建翻译文件，可以使用以下命令：

pybabel init -i ./babel/messages.pot -d app/translations -l pt  # 葡萄牙语
pybabel init -i ./babel/messages.pot -d app/translations -l es  # 西班牙语
pybabel init -i ./babel/messages.pot -d app/translations -l de  # 德语

实际开发中的国际化实践

标记需要翻译的文本

在代码中使用Flask-Babel的lazy_gettext函数标记需要翻译的文本：

from flask_babel import lazy_gettext as _

class GroupModelView(ModelView):
    datamodel = SQLAInterface(ContactGroup)
    related_views = [ContactModelView]
    label_columns = {'name':_('Name')}  # 标记需要翻译的字段名

genapp.add_view(GroupModelView(), "List Groups", icon="th-large", 
               label=_('List Groups'),  # 标记需要翻译的菜单项
               category="Contacts", category_icon='fa-envelope', 
               category_label=_('Contacts'))  # 标记需要翻译的菜单分类

提取翻译字符串

使用框架提供的命令提取所有标记过的字符串：

flask fab babel-extract

这会生成一个.pot文件，包含所有需要翻译的字符串。

编辑翻译文件

在对应语言的.po文件中添加翻译：

msgid "Name"
msgstr "Nome"  # 葡萄牙语翻译

msgid "Contacts"    
msgstr "Contactos"

msgid "List Groups"
msgstr "Lista de Grupos"

msgid "List Contacts"
msgstr "Lista de Contactos"

编译翻译文件

完成翻译后，需要编译.po文件为.mo文件：

flask fab babel-compile

配置支持的语言

最后，在配置文件中声明支持的语言：

LANGUAGES = {
   'en': {'flag':'gb', 'name':'English'},
   'pt': {'flag':'pt', 'name':'Portuguese'},
   'es': {'flag':'es', 'name':'Spanish'},
   'de': {'flag':'de', 'name':'German'}
}