oslo_i18n学习小结

news2024/12/26 21:36:00

背景

代码均为开源代码

基于yoga版本，需要对openstack某服务做翻译，了解到oslo_i18n有翻译功能，配置oslo_i18n来给组件进行翻译

用法

每个服务自己会带一个i18n.py的文件，如果要对日志进行翻译，从i18n导入_，代码如下

from oslo_log import log

from ceilometer.i18n import _
text = "hello, world"

LOG = log.getLogger(__name__)

# not translate
LOG.info(text)
# translate
LOG.info(_(text))

官网oslo.i18n – Oslo Internationalization Utilities — oslo.i18n 3.12.1.dev4 documentation (openstack.org)

从pike版本后就不支持log翻译了，这个文档是ocata版本

定制修改

直接改po文件即可，改完po文件生成mo文件即可

配置

pike版本以后不支持log翻译了，使用翻译前需要配置

环境变量

参考如下官网配置How to Use oslo.i18n in Your Application or Library — oslo.i18n 3.12.1.dev4 documentation (openstack.org)

总的来说大概需要配两个环境变量，一个是你要翻译的目标语言类型，值可以是zh_CN, en_US等；一个是localedir，这个目录下存放的是mo和po文件，目录结构如下

po与mo文件配置

代码仓默认在各个语言的路径下只存在.po文件，如果要翻译需要先根据po文件生成mo文件，有了mo文件，才能翻译，通过命令msgfmt ceilometer.po -o ceilometer.mo生成.mo文件，mo文件需要在刚配置的环境变量localedir目录下，不然翻译的时候找不到mo文件就翻译不了

msgfmt ceilometer.po -o ceilometer.mo

msgfmt在debian需要先安装gettext：apt install gettext，不然msgfmt命令找不到报错

其他配置

rootwrap

生成mo目标文件的目录权限不够的话可以考虑配rootwrap

代码流程

oslo_i18n.TranslatorFactory

从服务.i18n导入_并使用，_实际是_translators.primary函数，_translator实际是oslo_i18n.TranslatorFactory的实例

_translator初始化需要传入domain参数，domain就是服务的名字，比如nova, neutron等，最后寻找.mo翻译文件的文件名就是domain.mo，可选参数localedir，即用来在localedir下寻找mo文件，不传入localedir参数的话会从环境变量寻找名为DOMAIN_LOCALEDIR变量的值，如果没配这个变量则为None，后续会处理这个None

oslo_i18n.TranslatorFactory.primary

primary流程如下，实际调用了gettext模块去翻译

注意到这个oslo_i18n._lazy.USE_LAZY，为全局bool类型，如果代码里用了oslo_i18n.enable_lazy()这样的函数会设置USE_LAZY为True，就会走到oslo_i18n._message.Message(msg, domain=domain)里，这个在yoga版本不会翻译成你的目标语言，即使配置了环境变量和mo文件