Awesome
i18n
Usage
Download and install it:
go get github.com/gin-contrib/i18n
Import it in your code:
import ginI18n "github.com/gin-contrib/i18n"
Canonical example:
package main
import (
"log"
"net/http"
ginI18n "github.com/gin-contrib/i18n"
"github.com/gin-gonic/gin"
"github.com/nicksnyder/go-i18n/v2/i18n"
)
func main() {
// new gin engine
gin.SetMode(gin.ReleaseMode)
router := gin.New()
// apply i18n middleware
router.Use(ginI18n.Localize())
router.GET("/", func(ctx *gin.Context) {
ctx.String(http.StatusOK, ginI18n.MustGetMessage(ctx, "welcome"))
})
router.GET("/:name", func(ctx *gin.Context) {
ctx.String(http.StatusOK, ginI18n.MustGetMessage(
ctx,
&i18n.LocalizeConfig{
MessageID: "welcomeWithName",
TemplateData: map[string]string{
"name": ctx.Param("name"),
},
}))
})
if err := router.Run(":8080"); err != nil {
log.Fatal(err)
}
}
Customized Bundle
package main
import (
"encoding/json"
"log"
"net/http"
ginI18n "github.com/gin-contrib/i18n"
"github.com/gin-gonic/gin"
"github.com/nicksnyder/go-i18n/v2/i18n"
"golang.org/x/text/language"
)
func main() {
// new gin engine
gin.SetMode(gin.ReleaseMode)
router := gin.New()
// apply i18n middleware
router.Use(ginI18n.Localize(ginI18n.WithBundle(&ginI18n.BundleCfg{
RootPath: "./testdata/localizeJSON",
AcceptLanguage: []language.Tag{language.German, language.English},
DefaultLanguage: language.English,
UnmarshalFunc: json.Unmarshal,
FormatBundleFile: "json",
})))
router.GET("/", func(ctx *gin.Context) {
ctx.String(http.StatusOK, ginI18n.MustGetMessage(ctx, "welcome"))
})
router.GET("/:name", func(ctx *gin.Context) {
ctx.String(http.StatusOK, ginI18n.MustGetMessage(
ctx,
&i18n.LocalizeConfig{
MessageID: "welcomeWithName",
TemplateData: map[string]string{
"name": ctx.Param("name"),
},
}))
})
if err := router.Run(":8080"); err != nil {
log.Fatal(err)
}
}
Customized Get Language Handler
package main
import (
"log"
"net/http"
ginI18n "github.com/gin-contrib/i18n"
"github.com/gin-gonic/gin"
"github.com/nicksnyder/go-i18n/v2/i18n"
)
func main() {
// new gin engine
gin.SetMode(gin.ReleaseMode)
router := gin.New()
// apply i18n middleware
router.Use(ginI18n.Localize(
ginI18n.WithGetLngHandle(
func(context *gin.Context, defaultLng string) string {
lng := context.Query("lng")
if lng == "" {
return defaultLng
}
return lng
},
),
))
router.GET("/", func(ctx *gin.Context) {
ctx.String(http.StatusOK, ginI18n.MustGetMessage(ctx, "welcome"))
})
router.GET("/:name", func(ctx *gin.Context) {
ctx.String(http.StatusOK, ginI18n.MustGetMessage(
ctx,
&i18n.LocalizeConfig{
MessageID: "welcomeWithName",
TemplateData: map[string]string{
"name": ctx.Param("name"),
},
}))
})
if err := router.Run(":8080"); err != nil {
log.Fatal(err)
}
}
License
This project is under MIT License. See the LICENSE file for the full license text.