feat(i18n): frontend localization support

Adds localization support with go-i18n module.

Adds Russian language support in the frontend interface

Signed-off-by: Aleksandr Gamzin <gamzin@altlinux.org>
Signed-off-by: Andrey Smirnov <andrey.smirnov@siderolabs.com>

Author: Alex619829

go.mod

@@ -8,6 +8,7 @@ require (
 	github.com/h2non/filetype v1.1.3
 	github.com/julienschmidt/httprouter v1.3.0
 	github.com/klauspost/compress v1.18.0
+	github.com/nicksnyder/go-i18n/v2 v2.6.0
 	github.com/opencontainers/go-digest v1.0.0
 	github.com/prometheus/client_golang v1.22.0
 	github.com/siderolabs/gen v0.8.0
@@ -25,6 +26,7 @@ require (
 	golang.org/x/net v0.39.0
 	golang.org/x/sync v0.13.0
 	golang.org/x/sys v0.32.0
+	golang.org/x/text v0.24.0
 	gopkg.in/yaml.v3 v3.0.1
 )
 
@@ -255,7 +257,6 @@ require (
 	golang.org/x/mod v0.24.0 // indirect
 	golang.org/x/oauth2 v0.29.0 // indirect
 	golang.org/x/term v0.31.0 // indirect
-	golang.org/x/text v0.24.0 // indirect
 	golang.org/x/time v0.11.0 // indirect
 	golang.zx2c4.com/wireguard/wgctrl v0.0.0-20241231184526-a9ab2273dd10 // indirect
 	google.golang.org/genproto/googleapis/api v0.0.0-20250409194420-de1ac958c67a // indirect

go.sum

@@ -71,6 +71,8 @@ github.com/AzureAD/microsoft-authentication-extensions-for-go/cache v0.1.1/go.mo
 github.com/AzureAD/microsoft-authentication-library-for-go v1.4.2 h1:oygO0locgZJe7PpYPXT5A29ZkwJaPqcva7BVeemZOZs=
 github.com/AzureAD/microsoft-authentication-library-for-go v1.4.2/go.mod h1:wP83P5OoQ5p6ip3ScPr0BAq0BvuPAvacpEuSzyouqAI=
 github.com/BurntSushi/toml v0.3.1/go.mod h1:xHWCNGjB5oqiDr8zfno3MHue2Ht5sIBksp03qcyfWMU=
+github.com/BurntSushi/toml v1.5.0 h1:W5quZX/G/csjUnuI8SUYlsHs9M38FC7znL0lIO+DvMg=
+github.com/BurntSushi/toml v1.5.0/go.mod h1:ukJfTF/6rtPPRCnwkur4qwRxa8vTRFBF0uk2lLoLwho=
 github.com/Microsoft/go-winio v0.6.2 h1:F2VQgta7ecxGYO8k3ZZz3RS8fVIXVxONVUPlNERoyfY=
 github.com/Microsoft/go-winio v0.6.2/go.mod h1:yd8OoFMLzJbo9gZq8j5qaps8bJ9aShtEA8Ipt1oGCvU=
 github.com/OneOfOne/xxhash v1.2.8 h1:31czK/TI9sNkxIKfaUfGlU47BAxQ0ztGgd9vPyqimf8=
@@ -542,6 +544,8 @@ github.com/mozillazg/docker-credential-acr-helper v0.4.0 h1:Uoh3Z9CcpEDnLiozDx+D
 github.com/mozillazg/docker-credential-acr-helper v0.4.0/go.mod h1:2kiicb3OlPytmlNC9XGkLvVC+f0qTiJw3f/mhmeeQBg=
 github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822 h1:C3w9PqII01/Oq1c1nUAm88MOHcQC9l5mIlSMApZMrHA=
 github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822/go.mod h1:+n7T8mK8HuQTcFwEeznm/DIxMOiR9yIdICNftLE1DvQ=
+github.com/nicksnyder/go-i18n/v2 v2.6.0 h1:C/m2NNWNiTB6SK4Ao8df5EWm3JETSTIGNXBpMJTxzxQ=
+github.com/nicksnyder/go-i18n/v2 v2.6.0/go.mod h1:88sRqr0C6OPyJn0/KRNaEz1uWorjxIKP7rUUcvycecE=
 github.com/niemeyer/pretty v0.0.0-20200227124842-a10e7caefd8e/go.mod h1:zD1mROLANZcx1PVRCS0qkT7pwLkGfwJo4zjcN/Tysno=
 github.com/nozzle/throttler v0.0.0-20180817012639-2ea982251481 h1:Up6+btDp321ZG5/zdSLo48H9Iaq0UQGthrhWC6pCxzE=
 github.com/nozzle/throttler v0.0.0-20180817012639-2ea982251481/go.mod h1:yKZQO8QE2bHlgozqWDiRVqTFlLQSj30K/6SAK8EeYFw=

internal/frontend/http/css/output.css

@@ -17,6 +17,7 @@ import (
 	"github.com/google/go-containerregistry/pkg/name"
 	"github.com/google/go-containerregistry/pkg/v1/remote"
 	"github.com/julienschmidt/httprouter"
+	"github.com/nicksnyder/go-i18n/v2/i18n"
 	"github.com/siderolabs/gen/ensure"
 	"github.com/siderolabs/gen/xerrors"
 	metrics "github.com/slok/go-http-metrics/metrics/prometheus"
@@ -144,6 +145,7 @@ func NewFrontend(
 	registerRoute(frontend.router.GET, "/ui/version-doc", frontend.handleUIVersionDoc)
 	registerRoute(frontend.router.POST, "/ui/extensions-list", frontend.handleUIExtensionsList)
 	frontend.router.ServeFiles("/css/*filepath", http.FS(ensure.Value(fs.Sub(cssFS, "css"))))
+
 	frontend.router.ServeFiles("/favicons/*filepath", http.FS(ensure.Value(fs.Sub(faviconsFS, "favicons"))))
 	frontend.router.ServeFiles("/js/*filepath", http.FS(ensure.Value(fs.Sub(jsFS, "js"))))
 
@@ -178,3 +180,20 @@ func (f *Frontend) wrapper(h func(ctx context.Context, w http.ResponseWriter, r
 		}
 	}
 }
+
+// Use several ways to detect language.
+func (f *Frontend) getLocalizer(r *http.Request) *i18n.Localizer {
+	lang := r.URL.Query().Get("lang")
+
+	if lang == "" {
+		if cookie, err := r.Cookie("lang"); err == nil {
+			lang = cookie.Value
+		}
+	}
+
+	if lang == "" {
+		lang = r.Header.Get("Accept-Language")
+	}
+
+	return i18n.NewLocalizer(getLocalizerBundle(), lang, "en")
+}

internal/frontend/http/http.go

@@ -0,0 +1,32 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+package http
+
+import (
+	"fmt"
+	"path/filepath"
+
+	"github.com/nicksnyder/go-i18n/v2/i18n"
+	"golang.org/x/text/language"
+	"gopkg.in/yaml.v3"
+)
+
+func loadLocalizerBundle() (*i18n.Bundle, error) {
+	bundle := i18n.NewBundle(language.English)
+	bundle.RegisterUnmarshalFunc("yaml", yaml.Unmarshal)
+
+	entries, err := localesFS.ReadDir("locales")
+	if err != nil {
+		return nil, fmt.Errorf("failed to read locales directory: %w", err)
+	}
+
+	for _, entry := range entries {
+		if _, err := bundle.LoadMessageFileFS(localesFS, filepath.Join("locales", entry.Name())); err != nil {
+			return nil, fmt.Errorf("failed to load translation file %s: %w", entry.Name(), err)
+		}
+	}
+
+	return bundle, nil
+}

internal/frontend/http/i18n.go

@@ -0,0 +1,278 @@
+- id: lang.name
+  translation: Language
+
+- id: lang.en
+  translation: English
+
+- id: lang.ru
+  translation: Russian
+
+- id: app.name
+  translation: "Image Factory"
+
+- id: distro.name
+  translation: "Talos Linux"
+
+- id: page.header
+  translation: "Talos Linux Image Factory"
+
+- id: info.developed_by
+  translation: "The Talos Linux Image Factory, developed by "
+
+- id: info.offers
+  translation: ", offers a method to download various boot assets for "
+
+- id: info.more
+  translation: "For more information about the Image Factory API and the available image formats, please visit "
+
+- id: info.github
+  translation: "the GitHub repository"
+
+- id: info.version
+  translation: "Version"
+
+- id: interface.loading
+  translation: "Loading..."
+
+- id: button.next
+  translation: "Next"
+
+- id: button.search
+  translation: "Search"
+
+- id: button.back
+  translation: "Back"
+
+- id: hardware.title
+  translation: "Hardware Type"
+
+- id: hardware.bmm.name
+  translation: "Bare-metal Machine"
+
+- id: hardware.cs.name
+  translation: "Cloud Server"
+
+- id: hardware.sbc.name
+  translation: "Single Board Computer"
+
+- id: hardware.bmm.description
+  translation: "Suitable for x86-64 and arm64 bare-metal machines, as well as generic virtual machines. If unsure, choose this option."
+
+- id: hardware.cs.description
+  translation: "Compatible with AWS, GCP, Azure, VMWare, Equinix Metal, and other platforms, including homelab environments like Proxmox."
+
+- id: hardware.sbc.description
+  translation: "Supports Raspberry Pi, Pine64, Jetson Nano, and similar devices."
+
+- id: versions.title
+  translation: "Choose Talos Linux Version"
+
+- id: versions.recommendation
+  translation: "We strongly recommend using the latest stable version of Talos Linux"
+
+- id: versions.recommendation.pre_release
+  translation: "Pre-release versions are suitable for testing purposes but are not advised for production environments."
+
+- id: docs.title
+  translation: "Documentation for Talos Linux"
+
+- id: docs.new
+  translation: "What's New"
+
+- id: docs.matrix
+  translation: "Support Matrix"
+
+- id: architecture.title
+  translation: "Machine Architecture"
+
+- id: architecture.amd64
+  translation: "Compatible with Intel and AMD CPUs, also referred to as x86_64. If unsure, select this option."
+
+- id: architecture.arm64
+  translation: "Suitable for Ampere Computing and other arm64 CPUs. For Single Board Computers, choose the 'SBC' option on the first screen. For AWS and GCP arm64 VMs, use Cloud images."
+
+- id: architecture.other
+  translation: "Compatible with various ARM64 manufacturers, also known as aarch64."
+
+- id: architecture.secure_boot.name
+  translation: "SecureBoot"
+
+- id: architecture.secure_boot.create
+  translation: "Create a "
+
+- id: architecture.secure_boot.description
+  translation: " image signed with the official Sidero Labs signing key. This requires UEFI boot and pre-configured hardware."
+
+- id: cloud.title
+  translation: "Cloud"
+
+- id: singleboard.title
+  translation: "Single Board Computer"
+
+- id: common.runs_on
+  translation: "Runs on"
+
+- id: common.documentation
+  translation: "documentation"
+
+- id: extensions.title
+  translation: "System Extensions"
+
+- id: extensions.description
+  translation: " enhance the Talos Linux base image with additional features such as extra drivers, hardware firmware, container runtimes, guest agents, and more."
+
+- id: extensions.select
+  translation: "Select the extensions needed for your environment. If unsure, you can skip this step."
+
+- id: customization.title
+  translation: "Customization"
+
+- id: customization.cmdline
+  translation: "Extra kernel command line arguments:"
+
+- id: customization.cmdline.description
+  translation: "This step allows you to customize the default "
+
+- id: customization.cmdline.arguments
+  translation: "kernel command line arguments"
+
+- id: customization.cmdline.example
+  translation: "The syntax accepted is the same as the kernel command line syntax, e.g., "
+
+- id: customization.cmdline.prefix
+  translation: ". Prefixing an argument with "
+
+- id: customization.cmdline.removes
+  translation: " removes it from the default command line (e.g., "
+
+- id: customization.cmdline.secure_boot
+  translation: "With SecureBoot, the kernel command line is signed and cannot be modified, so this is the only opportunity to customize it."
+
+- id: customization.cmdline.note
+  translation: "Please note that kernel command line customization is only accepted for the initial boot images (ISO, PXE, disk image) and is ignored for "
+
+- id: customization.cmdline.upgrade
+  translation: " images. For upgrade/install command line customization, use the "
+
+- id: customization.cmdline.configuration
+  translation: " machine configuration field."
+
+- id: customization.cmdline.skip
+  translation: "Skip this step if unsure."
+
+- id: customization.overlay
+  translation: "Extra overlay options (advanced):"
+
+- id: customization.overlay.description
+  translation: "This step allows you to customize the overlay options for the "
+
+- id: customization.overlay.name
+  translation: "overlay"
+
+- id: customization.overlay.syntax
+  translation: "The accepted syntax is YAML (JSON) key-value pairs. The available options are specific to the overlay image and can be found in its documentation."
+
+- id: customization.overlay.skip
+  translation: "If unsure, you can skip this step."
+
+- id: final.title
+  translation: "Schematic Ready"
+
+- id: final.image
+  translation: "Your image schematic ID is: "
+
+- id: final.first_boot
+  translation: "First Boot"
+
+- id: final.first_boot.metal
+  translation: "Here are the options for the initial boot of Talos Linux on a bare-metal machine or a generic virtual machine:"
+
+- id: final.first_boot.cloud
+  translation: "Here are the options for the initial boot of Talos Linux on"
+
+- id: final.first_boot.sbc
+  translation: "Use the following disk image for"
+
+- id: final.initial_installation
+  translation: "Initial Installation"
+
+- id: final.initial_installation.description
+  translation: "For the initial installation of Talos Linux (not applicable for disk image boot), add the following installer image to the machine configuration:"
+
+- id: final.upgrading
+  translation: "Upgrading Talos Linux"
+
+- id: final.upgrading.name
+  translation: "upgrade"
+
+- id: final.upgrading.to
+  translation: "To "
+
+- id: final.upgrading.description
+  translation: " Talos Linux on the machine, use the following image:"
+
+- id: final.documentation
+  translation: "Documentation"
+
+- id: final.documentation.new
+  translation: "What's New in Talos "
+
+- id: final.documentation.matrix
+  translation: "Support Matrix for "
+
+- id: final.documentation.getting_started
+  translation: "Getting Started Guide"
+
+- id: final.documentation.metal
+  translation: "Bare-metal Network Configuration"
+
+- id: final.documentation.cloud
+  translation: "Guide"
+
+- id: final.documentation.sbc
+  translation: "Guide"
+
+- id: final.documentation.secure_boot
+  translation: "SecureBoot Guide"
+
+- id: final.documentation.production
+  translation: "Production Cluster Guide"
+
+- id: final.documentation.troubleshooting
+  translation: "Troubleshooting Guide"
+
+- id: final.extra
+  translation: "Extra Assets"
+
+- id: final.extra.kernel_image
+  translation: "Kernel Image"
+
+- id: final.extra.cmdline
+  translation: "Kernel Command Line"
+
+- id: final.extra.initramfs
+  translation: "Initramfs Image"
+
+- id: final.disk_image.secure_boot
+  translation: "SecureBoot Disk Image"
+
+- id: final.disk_image.secure_boot_docs
+  translation: "SecureBoot documentation"
+
+- id: final.disk_image.iso_docs
+  translation: "ISO documentation"
+
+- id: final.disk_image.all
+  translation: "Disk Image"
+
+- id: final.pxe.secure_boot
+  translation: "SecureBoot PXE"
+
+- id: final.pxe.boot
+  translation: "PXE boot"
+
+- id: final.pxe.docs
+  translation: "PXE documentation"
+
+- id: final.board_image
+  translation: "Disk Image"