aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: 8516a5f1506aef3483792cce3da1ec18c3abf21d (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
# gosexy/gettext

Go bindings for [GNU gettext][1], an internationalization and localization
library for writing multilingual systems.

## Requeriments

The GNU C library. If you're using GNU/Linux, FreeBSD or OSX you probably
already have it.

## Installation

Use `go get` to download and install the binding:

```sh
go get github.com/gosexy/gettext
```

## Usage

This is an example program showing the `BindTextdomain`, `Textdomain` and
`SetLocale` bindings:

```go
package main

import (
	"github.com/gosexy/gettext"
	"fmt"
	"os"
)

func main() {
	gettext.BindTextdomain("example", ".")
	gettext.Textdomain("example")

	os.Setenv("LANGUAGE", "es_MX.utf8")

	gettext.SetLocale(gettext.LC_ALL, "")

	fmt.Println(gettext.Gettext("Hello, world!"))
}
```

Set the `LANGUAGE` env to the name of the language you want to use in your
program:

```sh
export LANGUAGE="es_MX.utf8"
./myapp
```

You can use the `xgettext` command to extract strings to be translated from a
Go program:

```
go get github.com/gosexy/gettext/go-xgettext

xgettext -o outfile.pot --keyword=Gettext --keyword-plural=NGettext -i infile.go
```

This will generate a `example.pot` file.

After actually translating the `.pot` file, you'll have to generate `.po` and
`.mo` files with `msginit` and `msgfmt`:

```sh
msginit -l es_MX -o example.po -i example.pot
msgfmt -c -v -o example.mo example.po
```

Finally, move the `.mo` file to an appropriate location.

```sh
mv example.mo examples/es_MX.utf8/LC_MESSAGES/example.mo
```

## Documentation

Check out the API documentation [godoc.org/github.com/gosexy/gettext)](http://godoc.org/github.com/gosexy/gettext).

The original gettext documentation:

```sh
man 3 gettext
```

And here's a [good tutorial][2] on using gettext.

[1]: http://www.gnu.org/software/gettext/
[2]: http://oriya.sarovar.org/docs/gettext_single.html