diff --git a/zh/10.3.md b/zh/10.3.md index fdadae76..83f8a1f0 100644 --- a/zh/10.3.md +++ b/zh/10.3.md @@ -5,103 +5,103 @@ 在开发一个应用的时候，首先我们要决定是只支持一种语言，还是多种语言，如果要支持多种语言，我们则需要制定一个组织结构，以方便将来更多语言的添加。在此我们设计如下：Locale有关的文件放置在config/locales下，假设你要支持中文和英文，那么你需要在这个文件夹下放置en.json和zh.json。大概的内容如下所示： ```json - # zh.json +# zh.json - { - "zh": { - "submit": "提交", - "create": "创建" - } +{ +"zh": { + "submit": "提交", + "create": "创建" } +} - #en.json +#en.json - { - "en": { - "submit": "Submit", - "create": "Create" - } +{ +"en": { + "submit": "Submit", + "create": "Create" } +} ``` 为了支持国际化，在此我们使用了一个国际化相关的包——[go-i18n](https://github.com/astaxie/go-i18n)，首先我们向go-i18n包注册config/locales这个目录,以加载所有的locale文件 ```Go - Tr:=i18n.NewLocale() - Tr.LoadPath("config/locales") +Tr:=i18n.NewLocale() +Tr.LoadPath("config/locales") ``` 这个包使用起来很简单，你可以通过下面的方式进行测试： ```Go - fmt.Println(Tr.Translate("submit")) - //输出Submit - Tr.SetLocale("zh") - fmt.Println(Tr.Translate("submit")) - //输出“递交” +fmt.Println(Tr.Translate("submit")) +//输出Submit +Tr.SetLocale("zh") +fmt.Println(Tr.Translate("submit")) +//输出“递交” ``` ## 自动加载本地包 上面我们介绍了如何自动加载自定义语言包，其实go-i18n库已经预加载了很多默认的格式信息，例如时间格式、货币格式，用户可以在自定义配置时改写这些默认配置，请看下面的处理过程： ```Go - //加载默认配置文件，这些文件都放在go-i18n/locales下面 +//加载默认配置文件，这些文件都放在go-i18n/locales下面 - //文件命名zh.json、en-json、en-US.json等，可以不断的扩展支持更多的语言 +//文件命名zh.json、en-json、en-US.json等，可以不断的扩展支持更多的语言 - func (il *IL) loadDefaultTranslations(dirPath string) error { - dir, err := os.Open(dirPath) - if err != nil { - return err - } - defer dir.Close() +func (il *IL) loadDefaultTranslations(dirPath string) error { + dir, err := os.Open(dirPath) + if err != nil { + return err + } + defer dir.Close() - names, err := dir.Readdirnames(-1) + names, err := dir.Readdirnames(-1) + if err != nil { + return err + } + + for _, name := range names { + fullPath := path.Join(dirPath, name) + + fi, err := os.Stat(fullPath) if err != nil { return err } - for _, name := range names { - fullPath := path.Join(dirPath, name) - - fi, err := os.Stat(fullPath) + if fi.IsDir() { + if err := il.loadTranslations(fullPath); err != nil { + return err + } + } else if locale := il.matchingLocaleFromFileName(name); locale != "" { + file, err := os.Open(fullPath) if err != nil { return err } + defer file.Close() - if fi.IsDir() { - if err := il.loadTranslations(fullPath); err != nil { - return err - } - } else if locale := il.matchingLocaleFromFileName(name); locale != "" { - file, err := os.Open(fullPath) - if err != nil { - return err - } - defer file.Close() - - if err := il.loadTranslation(file, locale); err != nil { - return err - } + if err := il.loadTranslation(file, locale); err != nil { + return err } } - - return nil } + return nil +} + ``` 通过上面的方法加载配置信息到默认的文件，这样我们就可以在我们没有自定义时间信息的时候执行如下的代码获取对应的信息: ```Go - //locale=zh的情况下，执行如下代码： +//locale=zh的情况下，执行如下代码： - fmt.Println(Tr.Time(time.Now())) - //输出：2009年1月08日 星期四 20:37:58 CST +fmt.Println(Tr.Time(time.Now())) +//输出：2009年1月08日 星期四 20:37:58 CST - fmt.Println(Tr.Time(time.Now(),"long")) - //输出：2009年1月08日 +fmt.Println(Tr.Time(time.Now(),"long")) +//输出：2009年1月08日 - fmt.Println(Tr.Money(11.11)) - //输出:￥11.11 +fmt.Println(Tr.Money(11.11)) +//输出:￥11.11 ``` ## template mapfunc 上面我们实现了多个语言包的管理和加载，而一些函数的实现是基于逻辑层的，例如："Tr.Translate"、"Tr.Time"、"Tr.Money"等，虽然我们在逻辑层可以利用这些函数把需要的参数进行转换后在模板层渲染的时候直接输出，但是如果我们想在模版层直接使用这些函数该怎么实现呢？不知你是否还记得，在前面介绍模板的时候说过：Go语言的模板支持自定义模板函数，下面是我们实现的方便操作的mapfunc： @@ -111,28 +111,28 @@ 文本信息调用`Tr.Translate`来实现相应的信息转换，mapFunc的实现如下： ```Go - func I18nT(args ...interface{}) string { - ok := false - var s string - if len(args) == 1 { - s, ok = args[0].(string) - } - if !ok { - s = fmt.Sprint(args...) - } - return Tr.Translate(s) +func I18nT(args ...interface{}) string { + ok := false + var s string + if len(args) == 1 { + s, ok = args[0].(string) } + if !ok { + s = fmt.Sprint(args...) + } + return Tr.Translate(s) +} ``` 注册函数如下： ```Go - t.Funcs(template.FuncMap{"T": I18nT}) +t.Funcs(template.FuncMap{"T": I18nT}) ``` 模板中使用如下： ```Go - {{.V.Submit | T}} +{{.V.Submit | T}} ``` 2. 时间日期 @@ -140,54 +140,54 @@ 时间日期调用`Tr.Time`函数来实现相应的时间转换，mapFunc的实现如下： ```Go - func I18nTimeDate(args ...interface{}) string { - ok := false - var s string - if len(args) == 1 { - s, ok = args[0].(string) - } - if !ok { - s = fmt.Sprint(args...) - } - return Tr.Time(s) +func I18nTimeDate(args ...interface{}) string { + ok := false + var s string + if len(args) == 1 { + s, ok = args[0].(string) } + if !ok { + s = fmt.Sprint(args...) + } + return Tr.Time(s) +} ``` 注册函数如下： ```Go - t.Funcs(template.FuncMap{"TD": I18nTimeDate}) +t.Funcs(template.FuncMap{"TD": I18nTimeDate}) ``` 模板中使用如下： ```Go - {{.V.Now | TD}} +{{.V.Now | TD}} ``` 3. 货币信息 货币调用`Tr.Money`函数来实现相应的时间转换，mapFunc的实现如下： ```Go - func I18nMoney(args ...interface{}) string { - ok := false - var s string - if len(args) == 1 { - s, ok = args[0].(string) - } - if !ok { - s = fmt.Sprint(args...) - } - return Tr.Money(s) +func I18nMoney(args ...interface{}) string { + ok := false + var s string + if len(args) == 1 { + s, ok = args[0].(string) } + if !ok { + s = fmt.Sprint(args...) + } + return Tr.Money(s) +} ``` 注册函数如下： ```Go - t.Funcs(template.FuncMap{"M": I18nMoney}) +t.Funcs(template.FuncMap{"M": I18nMoney}) ``` 模板中使用如下： ```Go - {{.V.Money | M}} +{{.V.Money | M}} ``` ## 总结 通过这小节我们知道了如何实现一个多语言包的Web应用，通过自定义语言包我们可以方便的实现多语言，而且通过配置文件能够非常方便的扩充多语言，默认情况下，go-i18n会自定加载一些公共的配置信息，例如时间、货币等，我们就可以非常方便的使用，同时为了支持在模板中使用这些函数，也实现了相应的模板函数，这样就允许我们在开发Web应用的时候直接在模板中通过pipeline的方式来操作多语言包。