Gin 如何配置 I18N的

转自： http://wjp2013.github.io/go/gin-i18n/

其实i18n是 Internationalization 这个英文的简写，国际化的意思，数一数，Internationalization去掉头尾的i和n刚好还剩下18个字符。

通常我们会遇到两个问题：

1. 动态信息，如新闻、产品资料的多语言版本。
2. 静态信息，如错误提示、页面固定元素的翻译。

动态信息

在数据库对应表中添加 locale 字段，并根据 request 的 header 或 paramters 的 locale 值从数据库中获取不同的语言版本数据集。

locale 字段的内容有两个方案。

方案 1

存 language + region 的编码组合，因为即便是使用相同的文字，不同的地区语法习惯仍然会不一致，有些场景要求我们针对不同的地区提供不同的翻译版本，以便软件用户获得更好的体验。更多阐述可以参考 Rails Internationalization (I18n) API 中的解释。

locale 的编码有两部分组成：

1. The language tag which is generally defined by ISO 639-1 alpha-2
2. The region tag which is generally defined by ISO 3166-1 alpha-2

这里有相关的讨论 Where can I find a list of language + region codes?。为了快速查询对应编码，也可访问 Online Browsing Platform。

方案 2

直接照抄 golang 的实践。

var supported = []language.Tag{
    language.AmericanEnglish,    // en-US: first language is fallback
    language.German,             // de
    language.Dutch,              // nl
    language.Portuguese          // pt (defaults to Brazilian)
    language.EuropeanPortuguese, // pt-pT
    language.Romanian            // ro
    language.Serbian,            // sr (defaults to Cyrillic script)
    language.SerbianLatin,       // sr-Latn
    language.SimplifiedChinese,  // zh-Hans
    language.TraditionalChinese, // zh-Hant
}
var matcher = language.NewMatcher(supported)

最后选定这个方案。

步骤

阅读 Accept-Language 了解其组成。

首先我给数据表增加了一个 locale 的 varchar 类型字段，默认值为 zh-Hans。接下来我希望在用户请求 API 的时候，若 locale 参数或 Accept-Language header 为空的时候，能直接用默认值去捞数据。

接下来参考 Language and Locale Matching in Go 撸一个 Gin 的 middleware。

还参考了如下代码：

• https://gist.github.com/hnakamur/92d283d5700507cc2a0df7bb1401478a
• https://siongui.github.io/2015/02/22/go-parse-accept-language/

package middleware

import (
    "fmt"

    "github.com/gin-gonic/gin"
    "golang.org/x/text/language"
    "golang.org/x/text/language/display"
)

func getAcceptLanguage(acceptLanguate string) {
    var serverLangs = []language.Tag{
        language.SimplifiedChinese, // zh-Hans fallback
        language.AmericanEnglish,   // en-US
        language.Korean,            // de
    }

  // 也可以不定义 serverLangs 用下面一行选择支持所有语种。
    // var matcher = language.NewMatcher(message.DefaultCatalog.Languages())
    var matcher = language.NewMatcher(serverLangs)
    t, _, _ := language.ParseAcceptLanguage(acceptLanguate)
    tag, index, confidence := matcher.Match(t...)

    fmt.Printf("best match: %s (%s) index=%d confidence=%v\n",
        display.English.Tags().Name(tag),
        display.Self.Name(tag),
        index, confidence)

    str := fmt.Sprintf("tag is %s", tag)
    fmt.Println(str)
    fmt.Printf("best match: %s\n", display.Self.Name(tag))
}

func I18nMiddleware() gin.HandlerFunc {
    return func(c *gin.Context) {
        locale := c.Query("locale")
        if locale != "" {
            c.Request.Header.Set("Accept-Language", locale)
        }
        lang := getAcceptLanguage(c.GetHeader("Accept-Language"))

        // NOTE: On June 2012, the deprecation of recommendation to use the "X-" prefix has become official as RFC 6648.
        // https://stackoverflow.com/questions/3561381/custom-http-headers-naming-conventions
        c.Request.Header.Set("I18n-Language", lang)
        c.Next()
    }
}

静态信息

todo.

---

参考：

Localization Management
I18N
A Step-by-Step Guide to Go Internationalization (i18n) & Localization (l10n)
[译] 手把手教你 Go 程序的国际化和本土化
Go Web 编程 - 国际化和本地化
Parse Accept-Language in HTTP Request Header
Gin - 高性能 Golang Web 框架的介绍和使用