Example

  1. package main
  3. import (
  4.     "github.com/kataras/iris/v12"
  5. )
  7. func newApp() *iris.Application {
  8.     app := iris.New()
  10.     // Configure i18n.
  11.     // First parameter: Glob filpath patern,
  12.     // Second variadic parameter: Optional language tags, the first one is the default/fallback one.
  13.     app.I18n.Load("./locales/*/*.ini", "en-US", "el-GR", "zh-CN")
  14.     // app.I18n.LoadAssets for go-bindata.
  16.     // Default values:
  17.     // app.I18n.URLParameter = "lang"
  18.     // app.I18n.Subdomain = true
  19.     //
  20.     // Set to false to disallow path (local) redirects,
  21.     // see https://github.com/kataras/iris/issues/1369.
  22.     // app.I18n.PathRedirect = true
  24.     app.Get("/", func(ctx iris.Context) {
  25.         hi := ctx.Tr("hi", "iris")
  27.         locale := ctx.GetLocale()
  29.         ctx.Writef("From the language %s translated output: %s", locale.Language(), hi)
  30.     })
  32.     app.Get("/some-path", func(ctx iris.Context) {
  33.         ctx.Writef("%s", ctx.Tr("hi", "iris"))
  34.     })
  36.     app.Get("/other", func(ctx iris.Context) {
  37.         language := ctx.GetLocale().Language()
  39.         fromFirstFileValue := ctx.Tr("key1")
  40.         fromSecondFileValue := ctx.Tr("key2")
  41.         ctx.Writef("From the language: %s, translated output:\n%s=%s\n%s=%s",
  42.             language, "key1", fromFirstFileValue,
  43.             "key2", fromSecondFileValue)
  44.     })
  46.     // using in inside your views:
  47.     view := iris.HTML("./views", ".html")
  48.     app.RegisterView(view)
  50.     app.Get("/templates", func(ctx iris.Context) {
  51.         ctx.View("index.html", iris.Map{
  52.             "tr": ctx.Tr, // word, arguments... {call .tr "hi" "iris"}}
  53.         })
  55.         // Note that,
  56.         // Iris automatically adds a "tr" global template function as well,
  57.         // the only difference is the way you call it inside your templates and
  58.         // that it accepts a language code as its first argument.
  59.     })
  60.     //
  62.     return app
  63. }
  65. func main() {
  66.     app := newApp()
  68.     // go to http://localhost:8080/el-gr/some-path
  69.     // ^ (by path prefix)
  70.     //
  71.     // or http://el.mydomain.com8080/some-path
  72.     // ^ (by subdomain - test locally with the hosts file)
  73.     //
  74.     // or http://localhost:8080/zh-CN/templates
  75.     // ^ (by path prefix with uppercase)
  76.     //
  77.     // or http://localhost:8080/some-path?lang=el-GR
  78.     // ^ (by url parameter)
  79.     //
  80.     // or http://localhost:8080 (default is en-US)
  81.     // or http://localhost:8080/?lang=zh-CN
  82.     //
  83.     // go to http://localhost:8080/other?lang=el-GR
  84.     // or http://localhost:8080/other (default is en-US)
  85.     // or http://localhost:8080/other?lang=en-US
  86.     //
  87.     // or use cookies to set the language.
  88.     app.Listen(":8080", iris.WithSitemap("http://localhost:8080"))
  89. }