i18n

Internationalization (i18n) Example

This is an example app demonstrating translating rule sets for internationalization (i18n).

It uses the text/messages package to perform the translations.

Some things you may want to improve when using in your production application:

• Customize the default (US English / en-US) error messages to fit your product voice.
• Update translations to support plural messages. For example: 1 characters may become 1 character.

Getting Started

1st, if you don't already, install gotext:

go install golang.org/x/text/cmd/gotext@latest

2nd, cd into the example directory and run go generate and go run:

# Create the catalog.go file and locales directory
go generate translations/translations.go

3rd, send the files in locales to a translation service then place the translated files in the directory. For example purposes we'll just copy them as is and edit in place:

cp translations/locales/en-US/out.gotext.json translations/locales/en-US/messages.gotext.json
cp translations/locales/es-ES/out.gotext.json translations/locales/es-ES/messages.gotext.json

Edit the messages.gotext.json file as you see fit.

Every time you edit the files you will need to rerun go generate:

# Recreate the catalog.go file
go generate translations/translations.go

Don't worry, this will not overwrite your existing translations.

Now you can run the example:

go run app.go -locale es-ES a ab abc abcd abcde abcdef abcdefg

If the text/messages library can't find a translation it will default to the en-US (US English) locale.