Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nicksnyder/go-i18n
Translate your Go program into multiple languages.
https://github.com/nicksnyder/go-i18n
cldr go i18n translation translation-files
Last synced: 3 days ago
JSON representation
Translate your Go program into multiple languages.
- Host: GitHub
- URL: https://github.com/nicksnyder/go-i18n
- Owner: nicksnyder
- License: mit
- Created: 2012-01-14T21:44:37.000Z (almost 13 years ago)
- Default Branch: main
- Last Pushed: 2024-10-14T03:16:47.000Z (about 2 months ago)
- Last Synced: 2024-10-29T15:00:54.122Z (about 1 month ago)
- Topics: cldr, go, i18n, translation, translation-files
- Language: Go
- Homepage:
- Size: 449 KB
- Stars: 2,997
- Watchers: 30
- Forks: 275
- Open Issues: 11
-
Metadata Files:
- Readme: .github/README.uk-UA.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- go-awesome - go-i18n - multilingual toolkit (Open source library / Not Categorized)
- awesome-golang-repositories - go-i18n
- awesome-go-extra - go-i18n - 01-14T21:44:37Z|2022-06-29T17:52:30Z| (Bot Building / Translation)
README
# go-i18n
 [](https://goreportcard.com/report/github.com/nicksnyder/go-i18n/v2) [](https://codecov.io/gh/nicksnyder/go-i18n) [](https://sourcegraph.com/github.com/nicksnyder/go-i18n?badge)
go-i18n — це Go [пакет](#package-i18n) та [інструмент](#command-goi18n), які допомагають перекладати Go програми на різні мови.
- Підтримує [множинні форми](http://cldr.unicode.org/index/cldr-spec/plural-rules) для всіх 200+ мов у [Unicode Common Locale Data Repository (CLDR)](https://www.unicode.org/cldr/charts/28/supplemental/language_plural_rules.html).
- Код і тести [автоматично генеруються](https://github.com/nicksnyder/go-i18n/tree/main/internal/plural/codegen) з даних [CLDR](http://cldr.unicode.org/index/downloads).
- Підтримує рядки з іменованими змінними, використовуючи синтаксис [text/template](http://golang.org/pkg/text/template/).
- Підтримує файли повідомлень у будь-якому форматі (наприклад, JSON, TOML, YAML).
## Пакет i18n
[](https://pkg.go.dev/github.com/nicksnyder/go-i18n/v2/i18n)
Пакет i18n забезпечує підтримку пошуку повідомлень відповідно до набору мовних уподобань.
```go
import "github.com/nicksnyder/go-i18n/v2/i18n"
```
Створіть Bundle, який використовуватимете протягом усього терміну служби вашої програми.
```go
bundle := i18n.NewBundle(language.English)
```
Завантажуйте переклади у ваш пакет під час ініціалізації.
```go
bundle.RegisterUnmarshalFunc("toml", toml.Unmarshal)
bundle.LoadMessageFile("es.toml")
```
```go
// Якщо використовуєте go:embed
//go:embed locale.*.toml
var LocaleFS embed.FS
bundle.RegisterUnmarshalFunc("toml", toml.Unmarshal)
bundle.LoadMessageFileFS(LocaleFS, "locale.es.toml")
```
Створіть Localizer, який використовуватимете для набору мовних уподобань.
```go
func(w http.ResponseWriter, r *http.Request) {
lang := r.FormValue("lang")
accept := r.Header.Get("Accept-Language")
localizer := i18n.NewLocalizer(bundle, lang, accept)
}
```
Використовуйте Localizer для пошуку повідомлень.
```go
localizer.Localize(&i18n.LocalizeConfig{
DefaultMessage: &i18n.Message{
ID: "PersonCats",
One: "{{.Name}} has {{.Count}} cat.",
Other: "{{.Name}} has {{.Count}} cats.",
},
TemplateData: map[string]interface{}{
"Name": "Nick",
"Count": 2,
},
PluralCount: 2,
}) // Nick has 2 cats.
```
## Команда goi18n
[](https://pkg.go.dev/github.com/nicksnyder/go-i18n/v2/goi18n)
Команда goi18n управляє файлами повідомлень, що використовуються пакетом i18n.
```
go install -v github.com/nicksnyder/go-i18n/v2/goi18n@latest
goi18n -help
```
### Витяг повідомлень
Використовуйте команду `goi18n extract`, щоб витягнути всі літерали структури i18n.Message із Go-файлів у файл повідомлень для перекладу.
```toml
# active.en.toml
[PersonCats]
description = "The number of cats a person has"
one = "{{.Name}} has {{.Count}} cat."
other = "{{.Name}} has {{.Count}} cats."
```
### Переклад нової мови
1. Створіть порожній файл повідомлень для мови, яку ви хочете додати (наприклад, translate.uk.toml).
2. Виконайте команду `goi18n merge active.en.toml translate.es.toml`, щоб заповнити `translate.es.toml` повідомленнями для перекладу.
```toml
# translate.uk.toml
[HelloPerson]
hash = "sha1-5b49bfdad81fedaeefb224b0ffc2acc58b09cff5"
other = "Hello {{.Name}}"
```
3. Після перекладу файлу `translate.es.toml` перейменуйте його на `active.es.toml`.
```toml
# active.uk.toml
[HelloPerson]
hash = "sha1-5b49bfdad81fedaeefb224b0ffc2acc58b09cff5"
other = "Вітаю {{.Name}}"
```
4. Завантажте файл `active.es.toml` у свій пакет.
```go
bundle.RegisterUnmarshalFunc("toml", toml.Unmarshal)
bundle.LoadMessageFile("active.es.toml")
```
### Переклад нових повідомлень
Якщо ви додали нові повідомлення до своєї програми:
1. Виконайте `goi18n extract`, щоб оновити файл `active.en.toml` новими повідомленнями.
2. Виконайте `goi18n merge active.*.toml`, щоб згенерувати оновлені файли `translate.*.toml`.
3. Перекладіть усі повідомлення у файлах `translate.*.toml`.
4. Виконайте `goi18n merge active.*.toml translate.*.toml`, щоб об’єднати перекладені повідомлення з активними файлами повідомлень.
## Для отримання додаткової інформації та прикладів:
- Ознайомтеся з [документацією](https://pkg.go.dev/github.com/nicksnyder/go-i18n/v2).
- Подивіться [приклади коду](https://github.com/nicksnyder/go-i18n/blob/main/i18n/example_test.go) та [тести](https://github.com/nicksnyder/go-i18n/blob/main/i18n/localizer_test.go).
- Перегляньте приклад [додатку](https://github.com/nicksnyder/go-i18n/tree/main/example).
## Переклади цього документа
Переклади цього документа, зроблені спільнотою, можна знайти в папці [.github](.github).
Ці переклади підтримуються спільнотою і не підтримуються автором цього проєкту.
Немає гарантії, що вони є точними або актуальними.
## Ліцензія
go-i18n доступний під ліцензією MIT. Див. файл [LICENSE](LICENSE) для отримання додаткової інформації.