# I18N

## Usage

In the source code, use the function `i18n.Tr("message", ...args)` to get a localized string. This tool parses the
source using the `go/ast` package to generate the `en` locale using these messages.

## Updating messages to reflect code changes

Install [go-rice](https://github.com/cmaglie/go.rice)

```sh
go get github.com/cmaglie/go.rice
go get github.com/cmaglie/go.rice/rice
```

The following command updates the locales present in the source code to reflect addition/removal of messages.

```sh
task i18n:update
```

## Syncing the catalog with transifex

### Environment variables

Set the following environment variables according to the project

| Variable           | Description                                |
| ------------------ | ------------------------------------------ |
| TRANSIFEX_PROJECT  | Name of the transifex project              |
| TRANSIFEX_RESOURCE | Name of the transifex translation resource |
| TRANSIFEX_API_KEY  | API Key to access the transifex project    |

### Push

```sh
task i18n:push
```

### Pull

```sh
task i18n:pull
```