README.zh-Hans.md

go-i18n

go-i18n 是一个帮助您将 Go 程序翻译成多种语言的 Go 包 和 命令。

• 支持 Unicode Common Locale Data Repository (CLDR) 中所有 200 多种语言的 复数字符。
  • 代码和测试是从 CLDR 数据 中 自动生成 的。
• 使用 text/template 语法支持带有命名变量的字符串。
• 支持任何格式的消息文件（例如：JSON、TOML、YAML）。

English · 简体中文

Package i18n

i18n 包支持根据一组语言环境首选项查找消息。

import "github.com/nicksnyder/go-i18n/v2/i18n"

创建一个 Bundle 以在应用程序的整个生命周期中使用。

bundle := i18n.NewBundle(language.English)

在初始化期间将翻译加载到您的 bundle 中。

bundle.RegisterUnmarshalFunc("toml", toml.Unmarshal)
bundle.LoadMessageFile("es.toml")

// 如果使用 go:embed
//go:embed locale.*.toml
var LocaleFS embed.FS

bundle.RegisterUnmarshalFunc("toml", toml.Unmarshal)
bundle.LoadMessageFileFS(LocaleFS, "locale.es.toml")

创建一个 Localizer 以用于一组语言首选项。

func(w http.ResponseWriter, r *http.Request) {
    lang := r.FormValue("lang")
    accept := r.Header.Get("Accept-Language")
    localizer := i18n.NewLocalizer(bundle, lang, accept)
}

使用 Localizer 查找消息。

localizer.Localize(&i18n.LocalizeConfig{
    DefaultMessage: &i18n.Message{
        ID: "PersonCats",
        One: "{{.Name}} has {{.Count}} cat.",
        Other: "{{.Name}} has {{.Count}} cats.",
    },
    TemplateData: map[string]interface{}{
        "Name": "Nick",
        "Count": 2,
    },
    PluralCount: 2,
}) // Nick has 2 cats.

goi18n 命令

goi18n 命令管理 i18n 包使用的消息文件。

go install -v github.com/nicksnyder/go-i18n/v2/goi18n@latest
goi18n -help

提取消息

使用 goi18n extract 将 Go 源文件中的所有 i18n.Message 结构文字提取到消息文件中以进行翻译。

# active.en.toml
[PersonCats]
description = "The number of cats a person has"
one = "{{.Name}} has {{.Count}} cat."
other = "{{.Name}} has {{.Count}} cats."

翻译一种新语言

1. 为您要添加的语言创建一个空消息文件（例如：translate.es.toml）。

2. 运行 goi18n merge active.en.toml translate.es.toml 以填充 translate.es.toml 要翻译的消息。

   # translate.es.toml
   [HelloPerson]
   hash = "sha1-5b49bfdad81fedaeefb224b0ffc2acc58b09cff5"
   other = "Hello {{.Name}}"

3. 翻译完成 translate.es.toml 后，将其重命名为 `active.es.toml``。

   # active.es.toml
   [HelloPerson]
   hash = "sha1-5b49bfdad81fedaeefb224b0ffc2acc58b09cff5"
   other = "Hola {{.Name}}"

4. 加载 active.es.toml 到您的 bundle 中。

   bundle.RegisterUnmarshalFunc("toml", toml.Unmarshal)
   bundle.LoadMessageFile("active.es.toml")

翻译新消息

如果您在程序中添加了新消息：

1. 运行 goi18n extract 以使用新消息更新 active.en.toml。
2. 运行 goi18n merge active.*.toml 以生成更新的 translate.*.toml 文件。
3. 翻译 translate.*.toml 文件中的所有消息。
4. 运行 goi18n merge active.*.toml translate.*.toml 将翻译后的消息合并到 active 消息文件中。

有关更多信息和示例：

• 阅读 文档。
• 查看 代码示例 和 测试。
• 查看一个示例 程序。

许可证

go-i18n 在 MIT 许可下可用。有关更多信息，请参阅 许可证 文件。