当前位置: 首页 > 工具软件 > gettext-go > 使用案例 >

Golang基于GNU gettext方式的i18n国际化多语言集成方式总结

越昊穹
2023-12-01

Golang基于GNU gettext方式的i18n国际化多语言集成方式总结

18n国际化多语言本质上就是先写好一堆映射,在根据想要的语言取对应的文字。

Golang的i18n网上查了一下,文章都讲的不太细致,而且代码看起来也不太好理解。

之前写Python代码时有使用过babel做多语言集成,通过命令生存pot、po、mo等文件,然后动态获取即可,当时没有详细去研究其原理,今天了解了一下,其实是封装的的GNU gettext,gettext就是专门用来做多语言的,它由一系列命令行工具,比如xgettext、msginit、msgmerge、msgfmt等,像linux和mac默认都自带安装好了。

Python的babel流程主要是先提取代码中需要设置多语言的文字生成一个.pot格式的模板文件,然后根据这个模板创建对应语言的.po翻译文件,然后把.po文件编译成.mo文件就可以被函数动态读取。当代码中的多语言文字修改或新增了,就需要再次生成一下新的pot模板文件,把新增的多语言文字加到模板中,然后讲新模板和之前翻译好的po文件进行合并,合并后原来的po文件会将本次新增的多语言加入进来,然后对其进行翻译,完成后编译新的mo文件。

以上这个流程在gettext命令工具中分别需要使用xgettext提取代码中的多语言生成模板、msginit创建po文件、msgfmt编译为mo文件、msgmerge合并新的po文件。当拥有po、mo文件时,就能使用多种支持的语言进行读取了。

由于比较熟悉这一套流程,因此研究了一下在golang和其web框架比如gin中如何使用gettext实现多语言集成,这里记录一下要点。

golang的库也有好几个,这里我选择使用GitHub - chai2010/gettext-go: GNU gettext for Go (Imported By Kubernetes),代码比较简洁而且支持embed。唯一折腾了半天的是mo文件的路径问题,必要按固定规则才行,尝试了很多遍才成功。

Golang中使用的大致流程说明:

  1. 生成你的po、mo文件。
  2. 必须先绑定你的mo翻译文件:gettext.BindLocale(gettext.New("domain", "path")),这里的domain和path一定要注意命名,domain你可以记忆为mo文件的名称,path是存放你所有多语言的父目录路径,整个路径为 path/xx/LC_MESSSAGES/yy.mo,其中path就是New方法中的参数路径,xx为任意名字标识语言,LC_MESSSAGES路径必须要,yy为domain参数值,只有这样才能读取到。
  3. 完成绑定后调用gettext.SetLanguage("xx")指定你要取的目标语言
  4. 再调用gettext.Gettext传入po文件中msgid的值就能返回对应语言的msgstr

gin中集成i18n:

golang中获取多语言成功了,在gin中就容易了。可以使用中间件获取用户指定的获取可能的语言来设置目标语言,代码中的返回都使用gettext.Gettext获取即可,需要注意的时gettext.Gettext的参数必须有对应的翻译文字才行。

获取用户的语言首先用户可以通过url参数指定语言,一旦指定语言,就将该语言保存到cookie中,下次从cookie获取,如果cookie没有则获取用户请求头中的Accept-Language,可以使用golang.org/x/text/language这个包提供的ParseAcceptLanguage方法获取最匹配的语言作为用户语言。

中间件实现可参考pink-lady GinSetLanguage中间件设置i18n语言

如果要在html模板中替换多语言,可以将gettext.Gettext注册到gin的自定义模板方法中,然后在html中所有需要被翻译的地方都使用这个模板方法处理一下,这样就能得到多语言。

模板注册参考pink-lady模板方法注册

关于自动提取代码中的待翻译的文字生成pot模板:

通过xgettext无法直接提取golang代码和golang html模板中的翻译文字,解决办法是sed替换为xgettext能识别的字符,然后再提取。

比如html模板中的模板方法写法{{ _text "翻译我"}}无法被识别,可以替换为c语言版本的gettext("翻译我")后在提取为html.pot:

find . -name "*.html" | xargs perl -pe "s/{{\s*_text [\"\`](.+?)[\"\`]\s*}}/{{ gettext(\"\1\") }}/g" | xgettext --no-wrap --no-location --language=
   │ c --from-code=UTF-8 --output=html.pot -

go文件中也无法识别,同样操作替换后再提取为go.pot

find . -name "*.go" | xargs perl -pe "s/gettext.Gettext/gettext/g"  | xgettext --no-wrap --no-location --language=c --from-code=UTF-8 --output=go.pot -

然后再把两个pot合并为一个pot文件(messages.pot):

xgettext --no-wrap --no-location *.pot -o messages.pot

最后我们统一使用这个pot生成各种语言的翻译文件后编译即可。

 类似资料: