Golang实现GNU gettext国际化文本处理的插件库gotext的使用

简介

Gotext是一个用于Go语言的GNU gettext工具实现，支持PO文件格式和国际化文本处理。

特性

• 原生Go实现的GNU gettext支持
• 完整支持PO文件，包括：
  • 多行字符串和头部支持
  • 使用Go的fmt语法在翻译字符串中支持变量
  • 支持复数形式规则
  • 支持消息上下文
• 支持MO文件
• 线程安全：可在多个goroutine中并发使用
• 使用UTF-8编码
• 语言代码自动简化（如en_UK到en）
• 可在Go模板中使用
• 对象可序列化为[]byte以便缓存
• 支持Go Modules

安装

go get github.com/leonelquinteros/gotext

使用示例

单语言/域设置

import (
    "fmt"
    "github.com/leonelquinteros/gotext"
)

func main() {
    // 配置包
    gotext.Configure("/path/to/locales/root/dir", "en_UK", "domain-name")

    // 从默认域翻译文本
    fmt.Println(gotext.Get("My text on 'domain-name' domain"))

    // 不重新配置从不同域翻译文本
    fmt.Println(gotext.GetD("domain2", "Another text on a different domain"))
}

使用动态变量

import (
    "fmt"
    "github.com/leonelquinteros/gotext"
)

func main() {
    // 配置包
    gotext.Configure("/path/to/locales/root/dir", "en_UK", "domain-name")

    // 设置变量
    name := "John"

    // 翻译带变量的文本
    fmt.Println(gotext.Get("Hi, my name is %s", name))
}

使用Locale对象

import (
    "fmt"
    "github.com/leonelquinteros/gotext"
)

func main() {
    // 创建Locale对象
    l := gotext.NewLocale("/path/to/locales/root/dir", "es_UY")

    // 加载域 '/path/to/locales/root/dir/es_UY/default.po'
    l.AddDomain("default")

    // 从默认域翻译文本
    fmt.Println(l.Get("Translate this"))

    // 加载不同域
    l.AddDomain("translations")

    // 从域翻译文本
    fmt.Println(l.GetD("translations", "Translate this"))
}

在模板中使用

{{ .Loc.Get "Translate this" }}

使用Po对象处理.po文件

import (
    "fmt"
    "github.com/leonelquinteros/gotext"
)

func main() {
    // 设置PO内容
    str := `
msgid "Translate this"
msgstr "Translated text"

msgid "Another string"
msgstr ""

msgid "One with var: %s"
msgstr "This one sets the var: %s"
`

    // 创建Po对象
    po := gotext.NewPo()
    po.Parse(str)

    fmt.Println(po.Get("Translate this"))
}

使用复数形式

import (
    "fmt"
    "github.com/leonelquinteros/gotext"
)

func main() {
    // 设置PO内容
    str := `
msgid ""
msgstr ""

# Header below
"Plural-Forms: nplurals=2; plural=(n != 1);\n"

msgid "Translate this"
msgstr "Translated text"

msgid "Another string"
msgstr ""

msgid "One with var: %s"
msgid_plural "Several with vars: %s"
msgstr[0] "This one is the singular: %s"
msgstr[1] "This one is the plural: %s"
`

    // 创建Po对象
    po := new(gotext.Po)
    po.Parse(str)

    fmt.Println(po.GetN("One with var: %s", "Several with vars: %s", 54, v))
    // 输出: "This one is the plural: Variable"
}

目录结构

Gotext假设的目录结构如下：

/path/to/locales
/path/to/locales/en_US
/path/to/locales/en_US/LC_MESSAGES
/path/to/locales/en_US/LC_MESSAGES/default.po
/path/to/locales/en_US/LC_MESSAGES/extras.po
/path/to/locales/en_UK
/path/to/locales/en_UK/LC_MESSAGES
/path/to/locales/en_UK/LC_MESSAGES/default.po
/path/to/locales/en_UK/LC_MESSAGES/extras.po
/path/to/locales/en_AU
/path/to/locales/en_AU/LC_MESSAGES
/path/to/locales/en_AU/LC_MESSAGES/default.po
/path/to/locales/en_AU/LC_MESSAGES/extras.po
/path/to/locales/es
/path/to/locales/es/default.po
/path/to/locales/es/extras.po
/path/to/locales/es_ES
/path/to/locales/es_ES/default.po
/path/to/locales/es_ES/extras.po
/path/to/locales/fr
/path/to/locales/fr/default.po
/path/to/locales/fr/extras.po

贡献

• 欢迎贡献
• 在你的项目中使用这个包
• 在Github上报告问题
• 提交bug修复和改进的pull请求
• 在Github issues上提出建议