i18n

Documentation

Overview

Package i18n provides internationalization support for applications.

Index

• Constants
• Variables
• func Locale() string
• func Text(text string) string

Constants

const (
	// Extension is the file name extension required on localization files.
	Extension = ".i18n"
)

Variables

var (
	// Dir is the directory to scan for localization files. This will occur
	// only once, the first time a call to Text() is made. If you do not set
	// this prior to the first call, a directory in the same location as the
	// executable with "_i18n" appended to the executable name (sans any
	// extension) will be used.
	Dir string
	// Language is the language that should be used for text returned from
	// calls to Text(). It is initialized to the result of calling Locale().
	// You may set this at runtime, forcing a particular language for all
	// subsequent calls to Text().
	Language = Locale()
	// Languages is a slice of languages to fall back to should the one
	// specified in the Language variable not be available. It is initialized
	// to the value of the LANGUAGE environment variable.
	Languages = strings.Split(os.Getenv("LANGUAGE"), ":")
	// Log is set to discard by default.
	Log logadapter.ErrorLogger = &logadapter.Discarder{}
)

Functions

func Locale

func Locale() string

Locale returns the value of the LC_ALL environment variable, if set. If not, then it falls back to the value of the LANG environment variable. If that is also not set, then it returns "en_US.UTF-8".

func Text

func Text(text string) string

Text returns a localized version of the text if one exists, or the original text if not.