Merge pull request #3 from gohugoio/sync2022510take2

sync2022510take2

Author: bep

.codecov.yml

@@ -1,5 +1,5 @@
 coverage:
-  range: 50..100
+  range: 50..75
   status:
     patch:
       default:

.github/README.uk-UA.md

@@ -0,0 +1,145 @@
+# go-i18n
+![Build status](https://github.com/nicksnyder/go-i18n/workflows/Build/badge.svg) [![Report card](https://goreportcard.com/badge/github.com/nicksnyder/go-i18n/v2)](https://goreportcard.com/report/github.com/nicksnyder/go-i18n/v2) [![codecov](https://codecov.io/gh/nicksnyder/go-i18n/graph/badge.svg?token=A9aMfR9vxG)](https://codecov.io/gh/nicksnyder/go-i18n) [![Sourcegraph](https://sourcegraph.com/github.com/nicksnyder/go-i18n/-/badge.svg)](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
+
+[![Go Reference](https://pkg.go.dev/badge/github.com/nicksnyder/go-i18n/v2/i18n.svg)](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
+
+[![Go Reference](https://pkg.go.dev/badge/github.com/nicksnyder/go-i18n/v2/goi18n.svg)](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) для отримання додаткової інформації.

.github/README.zh-Hans.md

@@ -1,11 +1,13 @@
-# go-i18n ![Build status](https://github.com/nicksnyder/go-i18n/workflows/Build/badge.svg) [![Report card](https://goreportcard.com/badge/github.com/nicksnyder/go-i18n)](https://goreportcard.com/report/github.com/nicksnyder/go-i18n) [![codecov](https://codecov.io/gh/nicksnyder/go-i18n/branch/master/graph/badge.svg)](https://codecov.io/gh/nicksnyder/go-i18n) [![Sourcegraph](https://sourcegraph.com/github.com/nicksnyder/go-i18n/-/badge.svg)](https://sourcegraph.com/github.com/nicksnyder/go-i18n?badge)
+# go-i18n
+![Build status](https://github.com/nicksnyder/go-i18n/workflows/Build/badge.svg) [![Report card](https://goreportcard.com/badge/github.com/nicksnyder/go-i18n/v2)](https://goreportcard.com/report/github.com/nicksnyder/go-i18n/v2) [![codecov](https://codecov.io/gh/nicksnyder/go-i18n/graph/badge.svg?token=A9aMfR9vxG)](https://codecov.io/gh/nicksnyder/go-i18n) [![Sourcegraph](https://sourcegraph.com/github.com/nicksnyder/go-i18n/-/badge.svg)](https://sourcegraph.com/github.com/nicksnyder/go-i18n?badge)
 
-go-i18n 是一个帮助您将 Go 程序翻译成多种语言的 Go [包](#package-i18n) 和 [命令](#command-goi18n)。
+go-i18n 是一个帮助您将 Go 程序翻译成多种语言的 Go [包](#package-i18n)和[命令](#command-goi18n)。
 
-- 支持 [Unicode Common Locale Data Repository (CLDR)](https://www.unicode.org/cldr/charts/28/supplemental/language_plural_rules.html) 中所有 200 多种语言的 [复数字符](http://cldr.unicode.org/index/cldr-spec/plural-rules)。
-  - 代码和测试是从 [CLDR 数据](http://cldr.unicode.org/index/downloads) 中 [自动生成](https://github.com/nicksnyder/go-i18n/tree/main/v2/internal/plural/codegen) 的。
+- 支持 [Unicode Common Locale Data Repository (CLDR)](https://www.unicode.org/cldr/charts/28/supplemental/language_plural_rules.html)
+  中所有 200 多种语言的[复数字符串](http://cldr.unicode.org/index/cldr-spec/plural-rules)。
+  - 代码和测试是基于 [CLDR 数据](http://cldr.unicode.org/index/downloads)[自动生成](https://github.com/nicksnyder/go-i18n/tree/main/internal/plural/codegen)的。
 - 使用 [text/template](http://golang.org/pkg/text/template/) 语法支持带有命名变量的字符串。
-- 支持任何格式的消息文件（例如：JSON、TOML、YAML）。
+- 支持所有格式的消息文件（例如：JSON、TOML、YAML）。
 
 <strong align="center">
 <samp>
@@ -15,11 +17,11 @@ go-i18n 是一个帮助您将 Go 程序翻译成多种语言的 Go [包](#packag
 </samp>
 </strong>
 
-## Package i18n
+## i18n 包
 
-[![GoDoc](https://godoc.org/github.com/nicksnyder/go-i18n?status.svg)](https://godoc.org/github.com/nicksnyder/go-i18n/v2/i18n)
+[![Go Reference](https://pkg.go.dev/badge/github.com/nicksnyder/go-i18n/v2/i18n.svg)](https://pkg.go.dev/github.com/nicksnyder/go-i18n/v2/i18n)
 
-i18n 包支持根据一组语言环境首选项查找消息。
+i18n 包支持根据一组语言环境首选项来查找消息。
 
 ```go
 import "github.com/nicksnyder/go-i18n/v2/i18n"
@@ -31,7 +33,7 @@ import "github.com/nicksnyder/go-i18n/v2/i18n"
 bundle := i18n.NewBundle(language.English)
 ```
 
-在初始化期间将翻译加载到您的 bundle 中。
+在初始化时，将翻译加载到你的 Bundle 中。
 
 ```go
 bundle.RegisterUnmarshalFunc("toml", toml.Unmarshal)
@@ -47,7 +49,7 @@ bundle.RegisterUnmarshalFunc("toml", toml.Unmarshal)
 bundle.LoadMessageFileFS(LocaleFS, "locale.es.toml")
 ```
 
-创建一个 Localizer 以用于一组语言首选项。
+创建一个 Localizer 以便用于一组首选语言。
 
 ```go
 func(w http.ResponseWriter, r *http.Request) {
@@ -57,7 +59,7 @@ func(w http.ResponseWriter, r *http.Request) {
 }
 ```
 
-使用 Localizer 查找消息。
+使用此 Localizer 查找消息。
 
 ```go
 localizer.Localize(&i18n.LocalizeConfig{
@@ -71,14 +73,14 @@ localizer.Localize(&i18n.LocalizeConfig{
         "Count": 2,
     },
     PluralCount: 2,
-}) // Nick has 2 cats.
+}) // Nick 有两只猫
 ```
 
 ## goi18n 命令
 
-[![GoDoc](https://godoc.org/github.com/nicksnyder/go-i18n?status.svg)](https://godoc.org/github.com/nicksnyder/go-i18n/v2/goi18n)
+[![Go Reference](https://pkg.go.dev/badge/github.com/nicksnyder/go-i18n/v2/goi18n.svg)](https://pkg.go.dev/github.com/nicksnyder/go-i18n/v2/goi18n)
 
-goi18n 命令管理 i18n 包使用的消息文件。
+goi18n 命令管理 i18n 包所使用的消息文件。
 
 ```
 go install -v github.com/nicksnyder/go-i18n/v2/goi18n@latest
@@ -87,7 +89,7 @@ goi18n -help
 
 ### 提取消息
 
-使用 `goi18n extract` 将 Go 源文件中的所有 i18n.Message 结构文字提取到消息文件中以进行翻译。
+使用 `goi18n extract` 将 Go 源文件中的所有 i18n.Message 结构中的文字提取到消息文件中以进行翻译。
 
 ```toml
 # active.en.toml
@@ -99,8 +101,8 @@ other = "{{.Name}} has {{.Count}} cats."
 
 ### 翻译一种新语言
 
-1. 为您要添加的语言创建一个空消息文件（例如：`translate.es.toml`）。
-2. 运行 `goi18n merge active.en.toml translate.es.toml` 以填充 `translate.es.toml` 要翻译的消息。
+1. 为你要添加的语言创建一个空的消息文件（例如：`translate.es.toml`）。
+2. 运行 `goi18n merge active.en.toml translate.es.toml` 以将要翻译的消息填充到 `translate.es.toml` 中。
 
    ```toml
    # translate.es.toml
@@ -109,7 +111,7 @@ other = "{{.Name}} has {{.Count}} cats."
    other = "Hello {{.Name}}"
    ```
 
-3. 翻译完成 `translate.es.toml` 后，将其重命名为 `active.es.toml``。
+3. 完成 `translate.es.toml` 的翻译之后，将其重命名为 `active.es.toml`。
 
    ```toml
    # active.es.toml
@@ -118,7 +120,7 @@ other = "{{.Name}} has {{.Count}} cats."
    other = "Hola {{.Name}}"
    ```
 
-4. 加载 `active.es.toml` 到您的 bundle 中。
+4. 加载 `active.es.toml` 到你的 Bundle 中。
 
    ```go
    bundle.RegisterUnmarshalFunc("toml", toml.Unmarshal)
@@ -127,19 +129,21 @@ other = "{{.Name}} has {{.Count}} cats."
 
 ### 翻译新消息
 
-如果您在程序中添加了新消息：
+如果你在程序中添加了新消息：
 
-1. 运行 `goi18n extract` 以使用新消息更新 `active.en.toml`。
-2. 运行 `goi18n merge active.*.toml` 以生成更新的 `translate.*.toml` 文件。
+1. 运行 `goi18n extract` 以将新的消息更新到 `active.en.toml`。
+2. 运行 `goi18n merge active.*.toml` 以生成更新后的 `translate.*.toml` 文件。
 3. 翻译 `translate.*.toml` 文件中的所有消息。
-4. 运行 `goi18n merge active.*.toml translate.*.toml` 将翻译后的消息合并到 active 消息文件中。
+4. 运行 `goi18n merge active.*.toml translate.*.toml` 将翻译后的消息合并到活跃消息文件
+   （Active Message Files）中。
 
-## 有关更多信息和示例：
+## 进一步的信息和示例：
 
-- 阅读 [文档](https://godoc.org/github.com/nicksnyder/go-i18n/v2)。
-- 查看 [代码示例](https://github.com/nicksnyder/go-i18n/blob/main/v2/i18n/example_test.go) 和 [测试](https://github.com/nicksnyder/go-i18n/blob/main/v2/i18n/localizer_test.go)。
-- 查看一个示例 [程序](https://github.com/nicksnyder/go-i18n/tree/main/v2/example)。
+- 阅读[文档](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)。
 
 ## 许可证
 
-go-i18n 在 MIT 许可下可用。有关更多信息，请参阅 [许可证](LICENSE) 文件。
+go-i18n 使用在 MIT 许可来提供。更多的相关信息，请参 [LICENSE](LICENSE) 文件。

.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "monthly"
+  - package-ecosystem: "gomod"
+    directory: "/"
+    schedule:
+      interval: "monthly"

.github/workflows/build.yml

@@ -1,48 +1,37 @@
 name: Build
 on:
-  - push
-  - pull_request
+  push:
+    branches:
+      - main
+  pull_request:
+
 jobs:
   build:
-    name: Build
+    name: Build (go:${{ matrix.go-version.name }})
     runs-on: ubuntu-latest
-    if: (github.event_name == 'push' && github.ref == 'refs/heads/main') || github.event_name == 'pull_request'
+    strategy:
+      matrix:
+        go-version:
+        - name: latest
+          version: 1.24.x
+        - name: previous
+          version: 1.23.x
     steps:
       - name: Install Go
-        uses: actions/setup-go@v4
+        uses: actions/setup-go@v5
         with:
-          go-version: stable
+          go-version: ${{ matrix.go-version.version }}
       - name: Git checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Build
-        uses: goreleaser/goreleaser-action@v2
+        uses: goreleaser/goreleaser-action@v6
         with:
           version: latest
-          args: release --rm-dist --snapshot
-          workdir: v2
+          args: release --clean --snapshot
       - name: Test
-        working-directory: v2
         run: go test -race -coverprofile=coverage.txt -covermode=atomic ./...
-      - name: Upload coverage
-        uses: codecov/codecov-action@v1
-  build_1_12:
-    name: Build with Go 1.12.17
-    runs-on: ubuntu-latest
-    if: (github.event_name == 'push' && github.ref == 'refs/heads/main') || github.event_name == 'pull_request'
-    steps:
-      - name: Install Go
-        uses: actions/setup-go@v4
-        with:
-          go-version: '1.12.17'
-      - name: Git checkout
-        uses: actions/checkout@v3
+      - name: Lint
+        uses: golangci/golangci-lint-action@v7
+        if: matrix.go-version.name == 'latest'
         with:
-          path: gopath/src/github.com/nicksnyder/go-i18n
-      - name: Build and test
-        working-directory: gopath/src/github.com/nicksnyder/go-i18n/v2
-        env:
-            GOPATH: ${{ github.workspace }}/gopath
-            GO111MODULE: on
-        run: |
-          go get ./...
-          go test -race ./...
+          version: v2.0