I18n

Use INI files, simple i18n manager implement.

中文说明

Features

• Easy to use, supports loading multiple languages, multiple files
• Two data loading modes: single file FileMode, folder DirMode; default is folder mode
• Support to set the default language and fallback language; when the default language data is not found, it will automatically try to find the fallback language
• Support parameter replacement, there are two modes: SprintfMode replaces parameters via fmt.Sprintf, ReplaceMode uses strings.Replacer

Install

go get github.com/gookit/i18n

Godoc

• godoc for gopkg
• godoc for github

Usage

lang/
    en/
        default.ini
        ...
    zh-CN/
        default.ini
        ...

Init i18n

    import "github/gookit/i18n"

    languages := map[string]string{
        "en": "English",
        "zh-CN": "简体中文",
        // "zh-TW": "繁体中文",
    }

    // The default instance initialized directly here
    i18n.Init("conf/lang", "en", languages)
    
    // Create a custom new instance
    // i18n.New(langDir string, defLang string, languages)
    // i18n.NewEmpty()

Translate

    // translate from special language
    msg := i18n.Tr("en", "key")

    // translate from default language
    msg = i18n.DefTr("key")
    // with arguments. 
    msg = i18n.DefTr("key1", "arg1", "arg2")

Parameter replacement mode

Use SprintfMode(defaults):

# en.ini
desc = I am %s, age is %d

Usage with parameters like sprintf:

msg := i18n.Tr("en", "desc", "tom", 22)
// Output: "I am tom, age is 22"

Use ReplaceMode:

# en.ini
desc = I am {name}, age is {age}

Usage with parameters:

// "name": "tom", "age": 22
msg := i18n.Tr("en", "desc", "name", "tom", "age", 22)
// Output: "I am tom, age is 22"

Usage with map[string]interface{} params:

i18n.TransMode = i18n.ReplaceMode

msg := i18n.Tr("en", "desc", "desc", map[string]interface{}{
    "name": "tom",
    "age": 22,
})
// Output: "I am tom, age is 22"

Tests

go test -cover

Dep packages

• gookit/ini is an INI config file/data manage implement

License

MIT