easy-i18n

Easy-i18n

Easy-i18n is a Go package and a command that helps you translate Go programs into multiple languages.

• Supports pluralized strings with =x or >x expression.
• Supports strings with similar to fmt.Sprintf format syntax.
• Supports message files of any format (e.g. JSON, TOML, YAML).

Package i18n

The i18n package provides support for looking up messages according to a set of locale preferences.

package main

import (
	"fmt"
	"os"

	_ "github.com/gioco-play/easy-i18n/example/locales"
	"github.com/gioco-play/easy-i18n/i18n"
	"golang.org/x/text/language"
)

func main() {

	i18n.SetLang(language.SimplifiedChinese)

	i18n.Printf(`hello world!`)
	fmt.Println()

	name := `Lukin`

	i18n.Printf(`hello %s!`, name)
	fmt.Println()

	i18n.Printf(`%s has %d cat.`, name, 1)
	fmt.Println()

	i18n.Printf(`%s has %d cat.`, name, 2, i18n.Plural(
		`%[2]d=1`, `%s has %d cat.`,
		`%[2]d>1`, `%s has %d cats.`,
	))
	fmt.Println()

	i18n.Fprintf(os.Stderr, `%s have %d apple.`, name, 2, i18n.Plural(
		`%[2]d=1`, `%s have an apple.`,
		`%[2]d=2`, `%s have two apples.`,
		`%[2]d>2`, `%s have %d apples.`,
	))
	fmt.Println()
}

Command easyi18n

The easyi18n command manages message files used by the i18n package.

go get -u github.com/gioco-play/easy-i18n/easyi18n
easyi18n -h

  update, u    merge translations and generate locales
  extract, e   extracts strings to be translated from code
  generate, g  generates code to insert translated messages

Extracting messages

Use easyi18n extract . ./locales/en.json to extract all i18n.Sprintf function literals in Go source files to a message file for translation.

./locales/en.json

{
  "%s has %d cat.": "%s has %d cat.",
  "%s has %d cats.": "%s has %d cats.",
  "%s have %d apples.": "%s have %d apples.",
  "%s have an apple.": "%s have an apple.",
  "%s have two apples.": "%s have two apples.",
  "hello %s!": "hello %s!",
  "hello world!": "hello world!"
}

Translating a new language

1. Create an empty message file for the language that you want to add (e.g. zh-Hans.json).

2. Run easyi18n update ./locales/en.json ./locales/zh-Hans.json to populate zh-Hans.json with the mesages to be translated.

   ./locales/zh-Hans.json

   {
     "%s has %d cat.": "%s有%d只猫。",
     "%s has %d cats.": "%s有%d只猫。",
     "%s have %d apples.": "%s有%d个苹果。",
     "%s have an apple.": "%s有一个苹果。",
     "%s have two apples.": "%s有两个苹果。",
     "hello %s!": "你好%s！",
     "hello world!": "你好世界！"
   }
   

3. After zh-Hans.json has been translated, run easyi18n generate --pkg=locales ./locales ./locales/locales.go.

4. Import locales package in main.go, example: import _ "github.com/gioco-play/easy-i18n/example/locales"

Translating new messages

If you have added new messages to your program:

1. Run easyi18n extract to update ./locales/en.json with the new messages.
2. Run easyi18n update ./locales/en.json to generate updated ./locales/new-language.json files.
3. Translate all the messages in the ./locales/new-language.json files.
4. Run easyi18n generate --pkg=locales ./locales ./locales/locales.go to merge the translated messages into the go files.

For examples:

• Look at an example application.

Thanks:

• https://xuanwo.io/2019/12/11/golang-i18n/
• https://github.com/qingstor/qsctl/tree/master/pkg/i18n
• https://github.com/golang/text
• https://github.com/nicksnyder/go-i18n

License

Easy-i18n is available under the MIT license. See the LICENSE file for more info.