🈂️ Golang 애플리케이션을 쉽게 번역할 수 있는 방법

소개하다.

よう皆!✌️ 다중 언어 사용자를 위해 Go 응용 프로그램을 준비하고 있거나 REST API에서 서로 다른 언어에 대한 지원만 필요하면 중요한 주제를 토론해 보겠습니다.
이 화제는 보기에 그렇게 간단하지 않다.모든 언어는 숫자를 사용할 때 단어 형식에 있어 자신만의 특수한 요소를 가지고 있기 때문이다.예를 들어, 러시아어에서는 항목 수에 세 가지 다른 변형이 있습니다.

one, 1항;

few, 2항;

many, 3+항;

🤔 And this must be understood when translating the application!

걱정하지 마라, 모든 것이 곧 잘 안배될 것이다.

📝 카탈로그

Source code of the project

Prepare the project for translation

Website application

Template for display

Extracting the original language

Launch the application and playing with languages

Afterword

프로젝트의 소스 코드

예, 코드를 먼저 보는 것을 좋아하는 사람들에게GitHub에 저장소를 만들었습니다.

코다 / 튜토리얼 - go-i18n

📖 자습서: Golang 어플리케이션을 쉽게 번역하는 방법

↑ Table of contents

번역 항목 준비

나는 이미 이 조작에 관한 소프트웨어 패키지(Go core에 내장된 소프트웨어 패키지 포함)를 많이 보았지만, nicksnyder/go-i18n은 내가 프로젝트에서 유일하게 즐겨 사용하는 소프트웨어 패키지이다.우리는 이 특정한 패키지를 사용하여 프레젠테이션 프로그램을 만들 것입니다.

👋 Please write in the comments which package for i18n you use and why!

↑ Table of contents

사이트 응용

네, Fiber 웹 프레임워크를 응용 프로그램의 핵심으로 삼아 훌륭한 템플릿 지원 (매끄러운 리셋 기능) 을 갖추고 있으며, 코드를 작성하고 읽기 쉽습니다.

🔥 Please read comments in code!

// ./main.go

package main

import (
    "log"
    "strconv"

    "github.com/BurntSushi/toml"
    "github.com/gofiber/fiber/v2"
    "github.com/gofiber/template/html"
    "github.com/nicksnyder/go-i18n/v2/i18n"
    "golang.org/x/text/language"
)

func main() {
    // Create a new i18n bundle with default language.
    bundle := i18n.NewBundle(language.English)

    // Register a toml unmarshal function for i18n bundle.
    bundle.RegisterUnmarshalFunc("toml", toml.Unmarshal)

    // Load translations from toml files for non-default languages.
    bundle.MustLoadMessageFile("./lang/active.es.toml")
    bundle.MustLoadMessageFile("./lang/active.ru.toml")

    // Create a new engine by passing the template folder
    // and template extension.
    engine := html.New("./templates", ".html")

    // Reload the templates on each render, good for development.
    // Optional, default is false.
    engine.Reload(true)

    // After you created your engine, you can pass it
    // to Fiber's Views Engine.
    app := fiber.New(fiber.Config{
        Views: engine,
    })

    // Register a new route.
    app.Get("/", func(c *fiber.Ctx) error {
        lang := c.Query("lang")            // parse language from query
        accept := c.Get("Accept-Language") // or, parse from Header

        // Create a new localizer.
        localizer := i18n.NewLocalizer(bundle, lang, accept)

        // Set title message.
        helloPerson := localizer.MustLocalize(&i18n.LocalizeConfig{
            DefaultMessage: &i18n.Message{
                ID:    "HelloPerson",     // set translation ID
                Other: "Hello {{.Name}}", // set default translation
            },
            TemplateData: &fiber.Map{
                "Name": "John",
            },
        })

        // Parse and set unread count of emails.
        unreadEmailCount, _ := strconv.ParseInt(c.Query("unread"), 10, 64)

        // Config for translation of email count.
        unreadEmailConfig := &i18n.LocalizeConfig{
            DefaultMessage: &i18n.Message{
                ID:    "MyUnreadEmails",
                One:   "You have {{.PluralCount}} unread email.",
                Other: "You have {{.PluralCount}} unread emails.",
            },
            PluralCount: unreadEmailCount,
        }

        // Set localizer for unread emails.
        unreadEmails := localizer.MustLocalize(unreadEmailConfig)

        // Return data as JSON.
        if c.Query("format") == "json" {
            return c.JSON(&fiber.Map{
                "name":          helloPerson,
                "unread_emails": unreadEmails,
            })
        }

        // Return rendered template.
        return c.Render("index", fiber.Map{
            "Title":        helloPerson,
            "UnreadEmails": unreadEmails,
        })
    })

    // Start server on port 3000.
    log.Fatal(app.Listen(":3000"))
}

↑ Table of contents

표시할 템플릿

일반적으로 저는 미리 제작된 CSS 라이브러리를 사용하지 않지만 이 프레젠테이션의 간단함과 아름다움을 위해 Bootstrap 5(v5.0.0-beta3) 라이브러리를 선택했습니다.

<!-- ./templates/index.html -->

<!DOCTYPE html>
<html>
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>{{.Title}}</title>
    <link
      href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css"
      rel="stylesheet"
      integrity="sha384-eOJMYsd53ii+scO/bJGFsiCZc+5NDVN2yr8+0RDqr0Ql0h+rP48ckxlpbzKgwra6"
      crossorigin="anonymous"
    />
    <style>
      * {
        font-family: sans-serif;
        color: #333333;
      }
    </style>
  </head>
  <body>
    <div class="col-lg-8 mx-auto p-3 py-md-5">
      <h1>{{.Title}}</h1>
      <br />
      <div class="row g-5">
        <div class="col-md-6">
          <ul class="icon-list">
            <li>{{.UnreadEmails}}</li>
          </ul>
        </div>
      </div>
      <footer class="pt-5 my-5 text-muted border-top">
        Switch to 🇬🇧 <a href="/">English</a>, 🇪🇸
        <a href="/?lang=es">Español</a>, 🇷🇺 <a href="/?lang=ru">Русский</a>.
      </footer>
    </div>
  </body>
</html>

↑ Table of contents

원시 언어 추출

우선 goi18n CLI 설치:

go get -u github.com/nicksnyder/go-i18n/v2/goi18n

은 Go 소스 파일의 모든 i18n.Message 구조 텍스트를 하나의 메시지 파일로 추출하여 번역합니다(기본값, active.en.toml).

goi18n extract

# ./active.en.toml

HelloPerson = "Hello {{.Name}}"

[MyUnreadEmails]
one = "You have {{.PluralCount}} unread email."
other = "You have {{.PluralCount}} unread emails."

은 추가할 언어 (이 예는 translate.es.toml과 translate.ru.toml) 를 위한 빈 메시지 파일을 만듭니다.

touch translate.es.toml translate.ru.toml

명령을 실행하려면 다음 메시지를 사용합니다. 번역할 파일:

# For Español:
goi18n merge active.en.toml translate.es.toml

# For Russian:
goi18n merge active.en.toml translate.ru.toml

메시지 파일을 열고 줄을 번역합니다.본 강좌를 시작하자마자 당신은 러시아어가 표시 대상의 수량에 있어서 자신만의 특징을 가지고 있다는 것을 기억할 수 있습니다.그러므로 나는 이 언어의 번역 예시를 제시할 것이다.

# ./translate.ru.toml

[HelloPerson]
hash = "sha1-5b49bfdad81fedaeefb224b0ffc2acc58b09cff5"
other = "Привет, {{.Name}}"

[MyUnreadEmails]
hash = "sha1-6a65d17f53981a3657db1897630e9cb069053ea8"
one = "У вас есть {{.PluralCount}} непрочитанное письмо."
other = "У вас есть {{.PluralCount}} непрочитанных писем."
few = "У вас есть {{.PluralCount}} непрочитанных письма." # <-- new row for "few" count
many = "У вас есть {{.PluralCount}} непрочитанных писем." # <-- new row for "many" count

을 모두 번역한 후 goi18n merge과 active.es.toml으로 이름을 바꾸고 active.ru.toml 폴더에 넣습니다.

이렇게!

↑ Table of contents

응용 프로그램 시작 및 언어 사용

우리는 마침내 우리의 응용 프로그램을 시작할 준비가 되었다.

go run main.go

# ┌───────────────────────────────────────────────────┐ 
# │                    Fiber v2.7.1                   │ 
# │               http://127.0.0.1:3000               │ 
# │       (bound on host 0.0.0.0 and port 3000)       │ 
# │                                                   │ 
# │ Handlers ............. 2  Processes ........... 1 │ 
# │ Prefork ....... Disabled  PID ............. 64479 │ 
# └───────────────────────────────────────────────────┘

그래../lang페이지를 엽니다.

보시다시피 기본적으로 웹 사이트는 항상 에서 열립니다.🇬🇧 응용 프로그램 설정에 지정된 대로 영어입니다.

💡 In Golang unset int values will always have 0, not null or None as in JavaScript or Python. That's why if we don't specify the unread parameter in a query, the template will be set it to 0.

다음으로 언어를🇪🇸 스페인 사람.페이지 하단에 있는 링크를 클릭하여 정수 질의 매개변수 http://localhost:3000/을 추가합니다.

그리고 다른 언어로 넘어가면🇷🇺 러시아어:

👆 You can play around with the value of unread to see how the word form automatically changes after a numeral for these languages.

또한 JSON의 작업 원리를 설명하기 위해 검색에 unread 파라미터를 추가하여 Fiber 웹 프레임워크가 어떻게 JSON 형식으로 당신에게 같은 내용을 제공할 수 있는지 알아보십시오.

↑ Table of contents

후기

실제 웹 응용 프로그램에서 번역을 전면에 전달하기 위해 REST API 방법의 다른 변형을 만들 수 있습니다.그러나 가장 중요한 것은 국제 프로젝트를 하려면 먼저 이들 국가의 언어의 구체적인 상황을 고려해야 한다는 것이다.
골랑이가 다른 거 해줄게!🎉
↑ Table of contents

사진 및 동영상

빅쇼스타크 https://shostak.dev

부필.

만약 당신이 이 블로그에 유사한 글을 더 많이 발표하고 싶다면, 아래에 평론을 발표하고 저를 구독해 주십시오.감사합니다!😘
물론, 당신은 LiberaPay에 전화를 걸어 저를 지지할 수 있습니다.모든 기부금은 새로운 글을 쓰고 지역 사회를 위한 비영리 개발 사업에 쓰일 것이다.