diff --git a/README.md b/README.md
index 3547ca5..a59eac3 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# VNOX — Web
+# VNOX Web
> Public project website and account frontend for VNOX Central.
@@ -65,7 +65,7 @@ Optional browser QA: `python3 tests/browser_qa.py` uses an existing local Playwr
```text
public/ HTML entry point and self-hosted assets
-src/ Typed application, API helpers, RU/EN catalogs and CSS
+src/ Typed application, API helpers, CSS; src/i18n/ holds the ru.ts and en.ts string dictionaries
scripts/ Bun browser bundling, static build and loopback preview
tests/ Bun regression tests and optional browser QA
docs/ Design, deployment notes and repository-hosted screenshots
@@ -86,7 +86,7 @@ The Hub sets Secure, HttpOnly cookies. Tokens are never stored in browser storag
## Contributing
-Keep RU/EN catalog keys aligned, render profile values as text and retain keyboard navigation and reduced-motion support. Use descriptive Conventional Commits such as `fix(web): preserve account state when changing language`. Run type checks, tests, formatting checks and a production build before submitting a focused PR; include screenshots for visual changes. See [verification notes](docs/verification.md) for browser QA and current limits.
+Keep RU/EN catalog keys aligned (`src/i18n/ru.ts` and `en.ts`; a test enforces it), follow the [copy guidelines](docs/copy-guidelines.md), never use the long dash character, render profile values as text and retain keyboard navigation and reduced-motion support. Use descriptive Conventional Commits such as `fix(web): preserve account state when changing language`. Run type checks, tests, formatting checks and a production build before submitting a focused PR; include screenshots for visual changes. See [verification notes](docs/verification.md) for browser QA and current limits.
## License
diff --git a/docs/copy-guidelines.md b/docs/copy-guidelines.md
new file mode 100644
index 0000000..9e210a1
--- /dev/null
+++ b/docs/copy-guidelines.md
@@ -0,0 +1,12 @@
+# Copy guidelines
+
+Short notes for writing site text in Russian and English. Based on README and landing-page advice from The Turing Way, openSUSE and others, Maxim Ilyakhov's "Пиши, сокращай" (Glavred stop-words), and articles on typical machine-written copy.
+
+- Say what the thing is and for whom in the first sentence. List real things (channels, DMs, roles, encrypted voice) instead of slogans.
+- Write only what the code does today. Planned items go under "next", never in the main description.
+- Cut hype and filler: no "revolutionary", "seamless", "ecosystem", "powerful", "unlock"; in Russian no "осуществлять", "является", "данный", "в рамках", "обеспечивает возможность".
+- Avoid the "not X, but Y" construction, triplets for rhythm, and openers like "Let's take a look". One plain sentence beats two clever ones.
+- Prefer verbs and short sentences. Do not translate word for word: write the Russian and English versions separately, each as a person would say it.
+- Use a full stop, comma, colon or brackets. The long dash character is banned in all site text; `tests/copy.test.ts` greps sources, docs and the built bundle for it.
+- Titles and og/meta text follow the same rule, for example "VNOX: voice and text chat on your own server".
+- Every user-visible string lives in `src/i18n/ru.ts` and `en.ts`. Keys must match; a test checks it.
diff --git a/docs/verification.md b/docs/verification.md
index 8846554..3aeb14a 100644
--- a/docs/verification.md
+++ b/docs/verification.md
@@ -25,6 +25,6 @@ Local QA screenshots were visually inspected in `/tmp/vnox-web-qa/`. Any authent
These frontend tests do not authorize a real GitHub user, verify provider consent or exercise Hub database/session internals. A live end-to-end GitHub authorization requires the account owner to complete provider consent. The loopback preview intentionally has no backend. Production deployment and HTTPS/security-header checks belong to the site's operator and must preserve the Hub's OAuth callback and cookie configuration.
-## Production verification — 24 October 2026
+## Production verification: 24 October 2026
Published source commit `622f396364bb` to [central.loki-code.dev](https://central.loki-code.dev), static release `622f396364bb-9b77c9dbd02c`. Live Chromium checks passed for desktop landing, anonymous account/GitHub entry, mobile account layout, CSS MIME and JavaScript console. Hub readiness/info, logo assets and authentication endpoints remain available at the same origin. CSP uses self-hosted scripts/styles, no external fonts, same-origin API connections and a specific GitHub avatar image origin. OAuth callback query logging remains disabled. A real user's GitHub consent/code exchange remains a manual verification step.
diff --git a/public/index.html b/public/index.html
index 6af066d..67c33f7 100644
--- a/public/index.html
+++ b/public/index.html
@@ -6,9 +6,22 @@
-
VNOX — Своя связь
+
+
+
+
+
+
+
+ VNOX: голосовой и текстовый чат на своём сервере
@@ -49,9 +62,7 @@
>VNOX
-
- Сделано для разговоров, которые хочется продолжать.
-
+ Клиент и сервер написаны на Rust.
('meta[name="description"]').content = t("description");
+ find('meta[property="og:title"]').content = pageTitle;
+ find('meta[property="og:description"]').content =
+ t("description");
+ find('meta[property="og:locale"]').content =
+ next === "ru" ? "ru_RU" : "en_US";
+ find('meta[property="og:locale:alternate"]').content =
+ next === "ru" ? "en_US" : "ru_RU";
document
.querySelectorAll("[data-i18n]")
.forEach(
diff --git a/src/i18n.ts b/src/i18n.ts
deleted file mode 100644
index e36272f..0000000
--- a/src/i18n.ts
+++ /dev/null
@@ -1,284 +0,0 @@
-export const messages = {
- ru: {
- skip: "Перейти к содержимому",
- nav: "Основная навигация",
- navProject: "Проект",
- navClient: "Клиент",
- navRoadmap: "Дальше",
- language: "Язык",
- account: "Аккаунт",
- footer: "Сделано для разговоров, которые хочется продолжать.",
- source: "Исходный код",
- title: "VNOX — Своя связь",
- accountTitle: "Аккаунт — VNOX Central",
- description:
- "VNOX — голос и чат для своих сообществ. Нативный клиент, собственный сервер и открытый код.",
- development: "В открытой разработке",
- heroTitle: "Свои люди.\nСвоя связь.",
- heroText:
- "Место для вашего сообщества. Обсуждайте планы, оставайтесь в голосе и управляйте своим сервером сами.",
- openCentral: "Открыть Vnox Central",
- explore: "О проекте",
- earlyNote: "Ранняя версия. Разрабатываем открыто, без обещаний на вырост.",
- diagramLabel: "Схема общения",
- diagramNote: "Иллюстрация устройства клиента",
- textTab: "Текст",
- voiceTab: "Голос",
- themeTab: "Внешний вид",
- community: "Ваше сообщество",
- general: "общий",
- ideas: "идеи",
- voiceRoom: "Вечерний войс",
- voiceConnected: "Голос остаётся с вами",
- voiceExplain: "Переключайте текстовые каналы, не выходя из разговора.",
- you: "Вы",
- friend: "Друг",
- messageSample: "Общий чат для идей, ссылок и планов.",
- messageNote: "Чат и голос доступны в одном окне.",
- voiceCaption: "Отдельное управление микрофоном и звуком.",
- themeCaption: "Четыре варианта. Один ваш.",
- light: "Светлая",
- dark: "Тёмная",
- black: "Мега-тёмная",
- custom: "Своя",
- preview: "Предпросмотр",
- previewTheme: "Тема иллюстрации",
- projectTitle: "Одно приложение.\nВаш сервер.",
- projectText:
- "VNOX объединяет текст и голос в нативном клиенте. Сервер сообщества запускается одним приложением и остаётся под управлением его владельца.",
- projectNative: "Нативный клиент",
- projectNativeText:
- "Написан на Rust и Slint. Настройки звука, профиля и внешнего вида собраны в одном месте.",
- projectServer: "Сервер сообщества",
- projectServerText:
- "Текстовые каналы и голос в одном серверном приложении. Владелец выбирает, где его запускать.",
- projectCentral: "Vnox Central",
- projectCentralText:
- "Центральный сервис для аккаунта. Каталог серверов и друзья — следующие этапы разработки.",
- clientCode: "Код клиента",
- serverCode: "Код сервера",
- clientTitle: "Удобство начинается\nс простых вещей.",
- clientText:
- "Светлая, тёмная, мега-тёмная или собственная тема. Размер текста, звук и профиль — там, где их ожидаешь найти.",
- clientScreenshot:
- "Настройки внешнего вида нативного клиента VNOX: четыре темы и размер текста.",
- screenshotCaption:
- "Настоящий снимок нативного клиента. Интерфейс продолжает развиваться.",
- appearanceTitle: "Внешний вид — ваш",
- appearanceText:
- "Своя палитра через поддерживаемые CSS-переменные. Без загрузки внешних ресурсов.",
- identityTitle: "Профиль без суеты",
- identityText:
- "Выберите фотографию, настройте масштаб и положение в круглом предпросмотре.",
- roadmapTitle: "Сначала надёжная связь.\nПотом всё остальное.",
- roadmapText:
- "Проект ещё в разработке. Здесь разделены доступные части и то, над чем мы работаем.",
- available: "Уже в коде",
- next: "В работе и планах",
- availableOne: "Нативный клиент, каналы и голос",
- availableTwo: "Настройки, темы и редактор аватара",
- availableThree: "Центральный сервис и защищённое соединение",
- availableFour: "Веб-аккаунт GitHub и интерфейс RU / EN",
- availableFive: "Входящие и подписанные исходящие вебхуки на сервере",
- nextOne: "Управление вебхуками в клиенте",
- nextTwo: "Трансляция экрана с раздельным звуком",
- nextThree: "Друзья и поиск серверов",
- downloadNote:
- "Публичные сборки появятся после проверки совместимости клиента и сервера. Пока доступны исходники.",
- faqTitle: "До первого разговора",
- faqServer: "Нужен ли отдельный голосовой сервер?",
- faqServerAnswer:
- "Нет. Для сообщества планируется одно серверное приложение, которое включает чат и голос.",
- faqCentral: "Зачем нужен Vnox Central?",
- faqCentralAnswer:
- "Для общего аккаунта и будущих социальных функций. Само сообщество размещает свой сервер отдельно.",
- faqRelease: "Где скачать клиент?",
- faqReleaseAnswer:
- "Проверенного публичного релиза пока нет. Код клиента и сервера открыт; инструкции по сборке находятся в их репозиториях.",
- statusLoading: "Проверяем Vnox Central…",
- statusReady: "Vnox Central отвечает",
- statusUnavailable: "Не удалось связаться с Vnox Central",
- statusNote: "Состояние центрального сервиса",
- retry: "Повторить",
- back: "На главную",
- accountHeading: "Ваш Vnox Central.",
- accountIntro:
- "Один аккаунт для будущих сообществ. Начните с безопасного входа через GitHub.",
- loginTitle: "Продолжить с GitHub",
- loginText:
- "VNOX получает ваш публичный профиль GitHub. Доступ к репозиториям для входа не запрашивается.",
- loginButton: "Войти через GitHub",
- loginLoading: "Проверяем возможность входа…",
- loginDisabled: "Вход через GitHub пока не включён на сервере.",
- loginUnavailable:
- "Не удалось проверить доступность входа. Повторите попытку.",
- privacy:
- "Авторизация происходит на github.com. Пароль GitHub остаётся у GitHub.",
- accountStage:
- "Центральный аккаунт пока не привязывается к локальным ключам настольного клиента. Друзья, серверы и сообщения появятся позже.",
- sessionLoading: "Загружаем аккаунт…",
- profileTitle: "Вы на связи.",
- profileIntro:
- "Вход через GitHub выполнен. Это ваш центральный аккаунт VNOX.",
- handle: "Имя аккаунта",
- userId: "ID аккаунта",
- provider: "Способ входа",
- logout: "Выйти из аккаунта",
- loggingOut: "Выходим…",
- logoutError: "Не удалось выйти. Повторите попытку.",
- sessionExpired: "Сессия завершилась. Войдите снова.",
- profileFallback: "Пользователь VNOX",
- accountError: "Аккаунт сейчас недоступен",
- accountErrorText:
- "Не удалось загрузить сессию. Проверьте соединение и повторите попытку.",
- copy: "Скопировать ID",
- copied: "ID скопирован",
- copyError: "Не удалось скопировать ID. Выделите его вручную.",
- },
- en: {
- skip: "Skip to content",
- nav: "Main navigation",
- navProject: "Project",
- navClient: "Client",
- navRoadmap: "What’s next",
- language: "Language",
- account: "Account",
- footer: "Made for conversations you want to continue.",
- source: "Source code",
- title: "VNOX — Your own connection",
- accountTitle: "Account — VNOX Central",
- description:
- "VNOX brings voice and chat to your community. Native client, your own server, open source.",
- development: "In open development",
- heroTitle: "Your people.\nYour connection.",
- heroText:
- "A place for your community. Share your plans, stay in voice and run your server on your terms.",
- openCentral: "Open Vnox Central",
- explore: "Explore the project",
- earlyNote: "An early version, developed in the open.",
- diagramLabel: "How you stay connected",
- diagramNote: "An illustration of the client layout",
- textTab: "Text",
- voiceTab: "Voice",
- themeTab: "Appearance",
- community: "Your community",
- general: "general",
- ideas: "ideas",
- voiceRoom: "Evening voice",
- voiceConnected: "Voice stays with you",
- voiceExplain: "Browse text channels without leaving the conversation.",
- you: "You",
- friend: "Friend",
- messageSample: "A shared chat for ideas, links and plans.",
- messageNote: "Chat and voice, together in one window.",
- voiceCaption: "Separate controls for your microphone and sound.",
- themeCaption: "Four options. One that’s yours.",
- light: "Light",
- dark: "Dark",
- black: "Mega dark",
- custom: "Custom",
- preview: "Preview",
- previewTheme: "Illustration theme",
- projectTitle: "One application.\nYour own server.",
- projectText:
- "VNOX brings text and voice together in a native client. One server application runs your community, under its owner’s control.",
- projectNative: "Native client",
- projectNativeText:
- "Built with Rust and Slint. Audio, profile and appearance settings, all in one place.",
- projectServer: "Community server",
- projectServerText:
- "Text channels and voice in one server application. Its owner chooses where to run it.",
- projectCentral: "Vnox Central",
- projectCentralText:
- "The central service for your account. Server discovery and friends are the next stages.",
- clientCode: "Client source",
- serverCode: "Server source",
- clientTitle: "Comfort starts\nwith simple things.",
- clientText:
- "Light, dark, mega dark or your own theme. Text size, audio and your profile, right where you expect them.",
- clientScreenshot:
- "Appearance settings in the native VNOX client, with four themes and a text size slider.",
- screenshotCaption:
- "A real screenshot of the native client. The interface is still evolving.",
- appearanceTitle: "Make it yours",
- appearanceText:
- "Create your palette with supported CSS variables. No external resources are loaded.",
- identityTitle: "A profile without the fuss",
- identityText:
- "Choose a photo, then adjust its zoom and position inside a circular preview.",
- roadmapTitle: "Reliable conversation first.\nThe rest comes next.",
- roadmapText:
- "VNOX is still being developed. Here is what exists in the code and what we’re building next.",
- available: "Already in the code",
- next: "In progress and planned",
- availableOne: "Native client, channels and voice",
- availableTwo: "Settings, themes and avatar editor",
- availableThree: "Central service and HTTPS",
- availableFour: "GitHub web account and RU / EN interface",
- availableFive: "Incoming and signed outgoing server webhooks",
- nextOne: "Webhook management in the client",
- nextTwo: "Screen broadcasting with separate audio sources",
- nextThree: "Friends and server discovery",
- downloadNote:
- "Public builds will follow client and server compatibility checks. Source code is available now.",
- faqTitle: "Before the first conversation",
- faqServer: "Do I need a separate voice server?",
- faqServerAnswer:
- "No. A community is intended to run one server application with both chat and voice.",
- faqCentral: "What is Vnox Central for?",
- faqCentralAnswer:
- "Your shared account and future social features. Each community hosts its own server separately.",
- faqRelease: "Where can I download the client?",
- faqReleaseAnswer:
- "There is no verified public release yet. Client and server code is open, with build instructions in their repositories.",
- statusLoading: "Checking Vnox Central…",
- statusReady: "Vnox Central is responding",
- statusUnavailable: "Could not reach Vnox Central",
- statusNote: "Central service status",
- retry: "Try again",
- back: "Back to home",
- accountHeading: "Your Vnox Central.",
- accountIntro:
- "One account for future communities. Start with secure GitHub sign-in.",
- loginTitle: "Continue with GitHub",
- loginText:
- "VNOX receives your public GitHub profile. Signing in does not request access to your repositories.",
- loginButton: "Sign in with GitHub",
- loginLoading: "Checking sign-in availability…",
- loginDisabled: "GitHub sign-in is not enabled on the server yet.",
- loginUnavailable: "Could not check sign-in availability. Try again.",
- privacy:
- "You authorize on github.com. Your GitHub password stays with GitHub.",
- accountStage:
- "Your central account is not yet linked to the desktop client’s local keys. Friends, servers and messages will follow.",
- sessionLoading: "Loading your account…",
- profileTitle: "You’re connected.",
- profileIntro: "Signed in with GitHub. This is your central VNOX account.",
- handle: "Account handle",
- userId: "Account ID",
- provider: "Signed in with",
- logout: "Sign out",
- loggingOut: "Signing out…",
- logoutError: "Could not sign out. Try again.",
- sessionExpired: "Your session ended. Sign in again.",
- profileFallback: "VNOX user",
- accountError: "Your account is currently unavailable",
- accountErrorText:
- "Could not load your session. Check your connection and try again.",
- copy: "Copy account ID",
- copied: "Account ID copied",
- copyError: "Could not copy the ID. Select it manually.",
- },
-} as const;
-export type Language = keyof typeof messages;
-export type MessageKey = keyof typeof messages.en;
-export function detectLanguage(
- saved: unknown,
- languages: readonly string[] = [],
-): Language {
- if (saved === "ru" || saved === "en") return saved;
- return languages.some((value) => /^ru(?:-|$)/i.test(value)) ? "ru" : "en";
-}
-export function translate(language: Language, key: MessageKey): string {
- return messages[language]?.[key] ?? messages.en[key] ?? key;
-}
diff --git a/src/i18n/en.ts b/src/i18n/en.ts
new file mode 100644
index 0000000..32041cc
--- /dev/null
+++ b/src/i18n/en.ts
@@ -0,0 +1,114 @@
+export const en = {
+ skip: "Skip to content",
+ nav: "Main navigation",
+ navProject: "Project",
+ navClient: "Client",
+ navRoadmap: "What’s next",
+ language: "Language",
+ account: "Account",
+ footer: "Client and server are written in Rust.",
+ source: "Source code",
+ title: "VNOX: voice and text chat on your own server",
+ accountTitle: "Account | VNOX Central",
+ description: "Voice and text chat you run yourself. Rust desktop client, channels, direct messages, friends, roles and encrypted UDP voice. Open source, GPLv3.",
+ development: "Early version, code is open",
+ heroTitle: "Voice and text chat\non your own server.",
+ heroText: "A desktop client written in Rust and a server you run yourself. Channels, direct messages, friends, roles and voice.",
+ openCentral: "Open Vnox Central",
+ explore: "Explore the project",
+ earlyNote: "Not production ready. What already works is listed below.",
+ diagramLabel: "What the client looks like",
+ diagramNote: "A schematic illustration, not a screenshot",
+ textTab: "Text",
+ voiceTab: "Voice",
+ themeTab: "Appearance",
+ community: "Your community",
+ general: "general",
+ ideas: "ideas",
+ voiceRoom: "Evening voice",
+ voiceConnected: "You are in a voice channel",
+ voiceExplain: "You can browse text channels without leaving voice.",
+ you: "You",
+ friend: "Friend",
+ messageSample: "A shared channel for ideas, links and plans.",
+ messageNote: "Text and voice in one window.",
+ voiceCaption: "Microphone modes: push to talk, voice activity or always on.",
+ themeCaption: "Light, dark, mega dark and your own.",
+ light: "Light",
+ dark: "Dark",
+ black: "Mega dark",
+ custom: "Custom",
+ preview: "Preview",
+ previewTheme: "Illustration theme",
+ projectTitle: "One client,\nyour own server.",
+ projectText: "VNOX is a chat with text and voice. You run the server on your own hardware, so the data and the users stay with you.",
+ projectNative: "Native client",
+ projectNativeText: "Written in Rust and Slint, no Electron or web view. Sign-in uses an Ed25519 key, so the server stores no passwords.",
+ projectServer: "Community server",
+ projectServerText: "The gateway (TCP) handles chat, guilds and roles, and the voice node (UDP) relays audio. There is also a combined daemon that runs both.",
+ projectCentral: "Vnox Central",
+ projectCentralText: "A web account with GitHub sign-in. It is not linked to the desktop client key yet.",
+ clientCode: "Client source",
+ serverCode: "Server source",
+ clientTitle: "Appearance settings",
+ clientText: "Four themes (light, dark, mega dark and custom), text size, audio and profile.",
+ clientScreenshot: "Appearance settings in the VNOX client: four themes and a text size slider.",
+ screenshotCaption: "A real screenshot of the client. The interface is still changing.",
+ appearanceTitle: "Your own theme",
+ appearanceText: "Set your own palette with CSS variables. No external resources are loaded.",
+ identityTitle: "Avatar",
+ identityText: "Pick a photo, then set its zoom and position in a round preview.",
+ roadmapTitle: "What exists and what is next",
+ roadmapText: "The project is in development. On the left is what is already in the code, on the right what we are still building.",
+ available: "Already in the code",
+ next: "In progress and planned",
+ availableOne: "Client, text channels and voice",
+ availableTwo: "Direct messages, friends, guilds and roles",
+ availableThree: "Voice encryption (ChaCha20-Poly1305) and key-based sign-in",
+ availableFour: "Web account through GitHub, site in Russian and English",
+ availableFive: "Incoming and signed outgoing webhooks on the server",
+ nextOne: "Webhook management in the client",
+ nextTwo: "Screen sharing with separate audio",
+ nextThree: "Server discovery and linking Central to the client key",
+ downloadNote: "There are no prebuilt downloads yet. You can build the client and server from source.",
+ faqTitle: "FAQ",
+ faqServer: "Do I need a separate voice server?",
+ faqServerAnswer: "No. The gateway and the voice node can run as one daemon (serverd).",
+ faqCentral: "What is Vnox Central for?",
+ faqCentralAnswer: "It is a web account with GitHub sign-in. A community server runs on its own and does not depend on Central.",
+ faqRelease: "Where can I download the client?",
+ faqReleaseAnswer: "Nowhere yet. The client and server sources are open, and build instructions are in their repositories.",
+ statusLoading: "Checking Vnox Central…",
+ statusReady: "Vnox Central is up",
+ statusUnavailable: "Could not reach Vnox Central",
+ statusNote: "Central service status",
+ retry: "Try again",
+ back: "Back to home",
+ accountHeading: "Your Vnox Central account",
+ accountIntro: "For now you can sign in with GitHub. There is nothing else to do with the account yet.",
+ loginTitle: "Continue with GitHub",
+ loginText: "VNOX gets your public GitHub profile. It does not ask for access to your repositories.",
+ loginButton: "Sign in with GitHub",
+ loginLoading: "Checking sign-in availability…",
+ loginDisabled: "GitHub sign-in is turned off on the server.",
+ loginUnavailable: "Could not check sign-in availability. Try again.",
+ privacy: "You sign in on github.com. Your GitHub password stays with GitHub.",
+ accountStage: "The account is not linked to the desktop client keys yet. Friends, servers and messages will be added later.",
+ sessionLoading: "Loading your account…",
+ profileTitle: "You are signed in",
+ profileIntro: "Signed in with GitHub. This is your VNOX Central account.",
+ handle: "Account handle",
+ userId: "Account ID",
+ provider: "Signed in with",
+ logout: "Sign out",
+ loggingOut: "Signing out…",
+ logoutError: "Could not sign out. Try again.",
+ profileFallback: "VNOX user",
+ accountError: "Your account is currently unavailable",
+ accountErrorText:
+ "Could not load your session. Check your connection and try again.",
+ copy: "Copy account ID",
+ copied: "Account ID copied",
+ copyError: "Could not copy the ID. Select it manually.",
+} as const;
+export type Catalog = Record;
diff --git a/src/i18n/index.ts b/src/i18n/index.ts
new file mode 100644
index 0000000..d672fcf
--- /dev/null
+++ b/src/i18n/index.ts
@@ -0,0 +1,19 @@
+import { en } from "./en";
+import { ru } from "./ru";
+
+export const messages = { ru, en } as const;
+export type Language = keyof typeof messages;
+export type MessageKey = keyof typeof en;
+export const languages = Object.keys(messages) as Language[];
+
+/** Saved choice wins; otherwise Russian for ru locales, English for the rest. */
+export function detectLanguage(
+ saved: unknown,
+ languages: readonly string[] = [],
+): Language {
+ if (saved === "ru" || saved === "en") return saved;
+ return languages.some((value) => /^ru(?:-|$)/i.test(value)) ? "ru" : "en";
+}
+export function translate(language: Language, key: MessageKey): string {
+ return messages[language]?.[key] ?? messages.en[key] ?? key;
+}
diff --git a/src/i18n/ru.ts b/src/i18n/ru.ts
new file mode 100644
index 0000000..b50b9d7
--- /dev/null
+++ b/src/i18n/ru.ts
@@ -0,0 +1,116 @@
+import type { Catalog } from "./en";
+
+export const ru: Catalog = {
+ skip: "Перейти к содержимому",
+ nav: "Основная навигация",
+ navProject: "Проект",
+ navClient: "Клиент",
+ navRoadmap: "Дальше",
+ language: "Язык",
+ account: "Аккаунт",
+ footer: "Клиент и сервер написаны на Rust.",
+ source: "Исходный код",
+ title: "VNOX: голосовой и текстовый чат на своём сервере",
+ accountTitle: "Аккаунт | VNOX Central",
+ description: "Голосовой и текстовый чат, который вы запускаете сами. Клиент на Rust, каналы, личные сообщения, друзья, роли и шифрованный голос по UDP. Открытый код, GPLv3.",
+ development: "Ранняя версия, код открыт",
+ heroTitle: "Голос и чат\nна вашем сервере.",
+ heroText: "Десктопный клиент на Rust и сервер, который вы запускаете сами. Каналы, личные сообщения, друзья, роли и голос.",
+ openCentral: "Открыть Vnox Central",
+ explore: "О проекте",
+ earlyNote: "Не готово для продакшена. Что уже работает, написано ниже.",
+ diagramLabel: "Как выглядит клиент",
+ diagramNote: "Схематичная иллюстрация, не снимок экрана",
+ textTab: "Текст",
+ voiceTab: "Голос",
+ themeTab: "Внешний вид",
+ community: "Ваше сообщество",
+ general: "общий",
+ ideas: "идеи",
+ voiceRoom: "Вечерний войс",
+ voiceConnected: "Вы в голосовом канале",
+ voiceExplain: "Текстовые каналы можно листать, не выходя из голосового.",
+ you: "Вы",
+ friend: "Друг",
+ messageSample: "Общий канал для идей, ссылок и планов.",
+ messageNote: "Текст и голос в одном окне.",
+ voiceCaption: "Режимы микрофона: PTT, VAD или всегда включён.",
+ themeCaption: "Светлая, тёмная, мега-тёмная и своя.",
+ light: "Светлая",
+ dark: "Тёмная",
+ black: "Мега-тёмная",
+ custom: "Своя",
+ preview: "Предпросмотр",
+ previewTheme: "Тема иллюстрации",
+ projectTitle: "Один клиент,\nваш сервер.",
+ projectText: "VNOX это чат с текстом и голосом. Сервер вы запускаете на своём железе, а данные и пользователи остаются у вас.",
+ projectNative: "Нативный клиент",
+ projectNativeText: "Написан на Rust и Slint, без Electron и веб-вида. Вход по ключу Ed25519, без паролей на сервере.",
+ projectServer: "Сервер сообщества",
+ projectServerText: "Шлюз (TCP) отвечает за чат, гильдии и роли, голосовой узел (UDP) пересылает звук. Есть и общий демон для обоих.",
+ projectCentral: "Vnox Central",
+ projectCentralText: "Веб-аккаунт с входом через GitHub. С ключом настольного клиента он пока не связан.",
+ clientCode: "Код клиента",
+ serverCode: "Код сервера",
+ clientTitle: "Настройки внешнего вида",
+ clientText: "Четыре темы (светлая, тёмная, мега-тёмная и своя), размер текста, звук и профиль.",
+ clientScreenshot: "Настройки внешнего вида в клиенте VNOX: четыре темы и размер текста.",
+ screenshotCaption: "Настоящий снимок клиента. Интерфейс ещё меняется.",
+ appearanceTitle: "Своя тема",
+ appearanceText: "Палитру можно задать через CSS-переменные. Внешние ресурсы не загружаются.",
+ identityTitle: "Аватар",
+ identityText: "Выберите фото и подберите масштаб и положение в круглой рамке.",
+ roadmapTitle: "Что есть, а что будет",
+ roadmapText: "Проект в разработке. Слева то, что уже есть в коде, справа то, что ещё делаем.",
+ available: "Уже в коде",
+ next: "В работе и планах",
+ availableOne: "Клиент, текстовые каналы и голос",
+ availableTwo: "Личные сообщения, друзья, гильдии и роли",
+ availableThree: "Шифрование голоса (ChaCha20-Poly1305) и вход по ключу",
+ availableFour: "Веб-аккаунт через GitHub, сайт на русском и английском",
+ availableFive: "Входящие и подписанные исходящие вебхуки на сервере",
+ nextOne: "Управление вебхуками в клиенте",
+ nextTwo: "Трансляция экрана с отдельным звуком",
+ nextThree: "Поиск серверов и привязка Central к ключу клиента",
+ downloadNote: "Готовых сборок пока нет. Клиент и сервер можно собрать из исходников.",
+ faqTitle: "Частые вопросы",
+ faqServer: "Нужен ли отдельный голосовой сервер?",
+ faqServerAnswer: "Нет. Шлюз и голосовой узел можно запустить одним демоном (serverd).",
+ faqCentral: "Зачем нужен Vnox Central?",
+ faqCentralAnswer: "Это веб-аккаунт с входом через GitHub. Сервер сообщества работает отдельно и от Central не зависит.",
+ faqRelease: "Где скачать клиент?",
+ faqReleaseAnswer: "Пока нигде. Исходники клиента и сервера открыты, инструкции по сборке лежат в их репозиториях.",
+ statusLoading: "Проверяем Vnox Central…",
+ statusReady: "Vnox Central отвечает",
+ statusUnavailable: "Не удалось связаться с Vnox Central",
+ statusNote: "Состояние центрального сервиса",
+ retry: "Повторить",
+ back: "На главную",
+ accountHeading: "Аккаунт Vnox Central",
+ accountIntro: "Пока можно войти через GitHub. Больше с аккаунтом ничего не сделать.",
+ loginTitle: "Продолжить с GitHub",
+ loginText: "VNOX получает ваш публичный профиль GitHub. Доступ к репозиториям не запрашивается.",
+ loginButton: "Войти через GitHub",
+ loginLoading: "Проверяем возможность входа…",
+ loginDisabled: "Вход через GitHub на сервере пока выключен.",
+ loginUnavailable:
+ "Не удалось проверить доступность входа. Повторите попытку.",
+ privacy: "Вход проходит на github.com. Пароль от GitHub остаётся у GitHub.",
+ accountStage: "Аккаунт пока не связан с ключами настольного клиента. Друзья, серверы и сообщения в нём появятся позже.",
+ sessionLoading: "Загружаем аккаунт…",
+ profileTitle: "Вы вошли",
+ profileIntro: "Вход через GitHub выполнен. Это ваш аккаунт VNOX Central.",
+ handle: "Имя аккаунта",
+ userId: "ID аккаунта",
+ provider: "Способ входа",
+ logout: "Выйти из аккаунта",
+ loggingOut: "Выходим…",
+ logoutError: "Не удалось выйти. Повторите попытку.",
+ profileFallback: "Пользователь VNOX",
+ accountError: "Аккаунт сейчас недоступен",
+ accountErrorText:
+ "Не удалось загрузить сессию. Проверьте соединение и повторите попытку.",
+ copy: "Скопировать ID",
+ copied: "ID скопирован",
+ copyError: "Не удалось скопировать ID. Выделите его вручную.",
+};
diff --git a/tests/browser_qa.py b/tests/browser_qa.py
index 41479aa..707e629 100644
--- a/tests/browser_qa.py
+++ b/tests/browser_qa.py
@@ -44,7 +44,11 @@ with sync_playwright() as p:
page.locator('[data-theme="light"]').click()
assert page.locator('.product-diagram').get_attribute('data-preview-theme') == 'light'
page.locator('[data-language="en"]').click()
- assert page.locator('h1').inner_text() == 'Your people.\nYour connection.'
+ assert page.locator('h1').inner_text() == 'Voice and text chat\non your own server.'
+ assert page.evaluate('document.documentElement.lang') == 'en'
+ assert page.title() == 'VNOX: voice and text chat on your own server'
+ assert page.locator('meta[property="og:title"]').get_attribute('content') == page.title()
+ assert '\u2014' not in page.content()
assert page.locator('[data-tab="theme"]').get_attribute('aria-selected') == 'true'
assert page.locator('[data-theme="light"]').get_attribute('aria-pressed') == 'true'
for locale in ['en', 'ru']:
@@ -60,7 +64,7 @@ with sync_playwright() as p:
page.screenshot(path=str(artifacts / 'account-login-mobile.png'), full_page=True)
state['info'] = {'capabilities': {'github_auth': 'not_enabled'}}
page.reload()
- page.locator('#login-availability').filter(has_text='не включён').wait_for()
+ page.locator('#login-availability').filter(has_text='выключен').wait_for()
assert page.locator('.github-login').get_attribute('href') is None
state['info_status'] = 503
page.reload()
diff --git a/tests/copy.test.ts b/tests/copy.test.ts
new file mode 100644
index 0000000..d0155a7
--- /dev/null
+++ b/tests/copy.test.ts
@@ -0,0 +1,102 @@
+import { test } from "bun:test";
+import assert from "node:assert/strict";
+import { readdir, readFile, stat } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import { en } from "../src/i18n/en";
+import { ru } from "../src/i18n/ru";
+import { messages, languages } from "../src/i18n";
+import { browserBundle } from "../scripts/browser";
+
+const root = fileURLToPath(new URL("../", import.meta.url));
+const LONG_DASH = String.fromCharCode(0x2014);
+const text = (path: string) => readFile(root + path, "utf8");
+
+async function walk(dir: string): Promise {
+ const out: string[] = [];
+ for (const entry of await readdir(root + dir, { withFileTypes: true })) {
+ const path = `${dir}/${entry.name}`;
+ if (entry.isDirectory()) out.push(...(await walk(path)));
+ else if (/\.(ts|css|html|md|svg|conf|py|json)$/.test(entry.name))
+ out.push(path);
+ }
+ return out;
+}
+
+test("ru and en dictionaries have identical, non-empty keys", () => {
+ assert.deepEqual(Object.keys(ru).sort(), Object.keys(en).sort());
+ assert.deepEqual([...languages].sort(), ["en", "ru"]);
+ for (const catalog of Object.values(messages))
+ for (const [key, value] of Object.entries(catalog))
+ assert.ok(value.trim().length > 0, key);
+});
+
+test("every translation key used in code exists and every key is used", async () => {
+ const code = (await text("src/app.ts")) + (await text("public/index.html"));
+ const used = new Set();
+ for (const m of code.matchAll(
+ /(?:data-i18n(?:-aria|-alt)?="|\btr\(\s*|\bt\(\s*)["`]?([A-Za-z]+)/g,
+ ))
+ used.add(m[1]!);
+ // Keys built from a template, e.g. faq${key} and faq${key}Answer.
+ for (const part of ["Server", "Central", "Release"]) {
+ used.add(`faq${part}`);
+ used.add(`faq${part}Answer`);
+ }
+ for (const m of code.matchAll(/\b(?:tr|t)\(\s*"([A-Za-z]+)"/g)) used.add(m[1]!);
+ for (const m of code.matchAll(/\(\[((?:"[a-z]+",?\s*)+)\] as const\)/g))
+ for (const k of m[1]!.matchAll(/"([a-z]+)"/g)) used.add(k[1]!);
+ for (const key of Object.keys(en)) {
+ if (!used.has(key)) {
+ // Keys chosen through ternaries are still named literally in app.ts.
+ assert.ok(code.includes(`"${key}"`), `unused key: ${key}`);
+ }
+ }
+ for (const key of used)
+ if (/^[a-z][A-Za-z]+$/.test(key) && !(key in en)) {
+ // Ignore non-key words matched by the loose regex.
+ assert.ok(
+ !code.includes(`data-i18n="${key}"`),
+ `missing key in dictionary: ${key}`,
+ );
+ }
+});
+
+test("static HTML fallback text matches the Russian dictionary", async () => {
+ const html = await text("public/index.html");
+ const flat = (value: string) => value.replace(/\s+/g, " ").trim();
+ for (const m of html.matchAll(
+ /data-i18n="([A-Za-z]+)"[^>]*>([^<]*)${ru.title}`));
+ assert.ok(html.includes(`content="${ru.description}"`));
+ assert.ok(html.includes(`property="og:title"\n content="${ru.title}"`));
+ assert.match(html, //);
+});
+
+test("the long dash is absent from sources, docs, public/ and the browser bundle", async () => {
+ const files = [
+ "README.md",
+ ...(await walk("src")),
+ ...(await walk("public")),
+ ...(await walk("docs")),
+ ...(await walk("tests")),
+ ...(await walk("scripts")),
+ ];
+ const bad: string[] = [];
+ for (const file of files)
+ if ((await text(file)).includes(LONG_DASH)) bad.push(file);
+ const bundle = await (await browserBundle(true)).text();
+ if (bundle.includes(LONG_DASH)) bad.push("browser bundle");
+ try {
+ await stat(root + "dist");
+ for (const file of await walk("dist"))
+ if ((await text(file)).includes(LONG_DASH)) bad.push(file);
+ } catch {
+ /* dist/ is optional. */
+ }
+ assert.deepEqual(bad, []);
+});