For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ru/docs/web/i18n.md (or send Accept: text/markdown).
Локали и тексты
Используйте каркас словаря на четыре локали для chrome приложения, меток настроек, почты и событий уведомлений.
Настройка и конфигурация
Перед любым действием прочтите Перед началом работы и Основные сведения о терминале. В этих инструкциях предполагается, что вы открыли полный монорепозиторий supastack в VS Code; его корень package.json отмечает корень репозитория. В командах pnpm пакет рабочей области представляет собой папку приложения или общего кода; В продукте рабочее пространство — это контейнер данных и граница безопасности команды. corepack pnpm --filter ... выбирает один пакет из монорепозитория, пока команды выполняются из его корня. Если вы открыли только синхронизированную папку мобильного устройства или рабочего стола, она не содержит веб-серверной части, настройки Docker или корневых сценариев: запустите серверную часть из этого монорепозитория или доступного размещенного сервера и используйте собственные сценарии папки платформы. Переменная среды — это именованный параметр, хранящийся в локальном файле .env или на панели управления хостингом; перезапустите соответствующее приложение после его изменения и не допускайте попадания секретов сервера в значения NEXT_PUBLIC_ и EXPO_PUBLIC_.
1. Откройте packages/i18n/src/index.ts в VS Code, чтобы просмотреть поддерживаемые имена языков и помощники локали; найдите соответствующие файлы словарей перед изменением копии продукта.
2. Добавьте один и тот же новый ключ и перевод в словари английского, немецкого, испанского и французского языков.
3. Из корня репозитория запустите corepack pnpm test -- packages/i18n/src/index.test.ts и запустите Web с corepack pnpm --filter @supastack/web dev. Ожидается: переключатель языка меняет видимый текст, сохраняя текущий путь к странице.
Локали находятся в @supastack/i18n с SUPPORTED_LOCALES, LOCALE_COOKIE,solveLocale, getDictionary и localePath. Прокси устанавливает x-supastack-locale и обрабатывает канонические перенаправления на английском языке; LanguageSwitcher обновляет файл cookie и сохраняет активные подпути. Ключевые маршруты приложений (/dashboard, /settings, /billing, /chat) работают непосредственно с префиксами /[locale] рядом с программным маркетинговым центром /{locale}.
Словари охватывают маркетинговую навигацию, метки разделов настроек, Chrome настроек организации, транзакционную почту (приглашение/OTP/magic-link/AI/биллинг), метки предпочтений уведомлений и копию событий уведомлений в приложении.
import { getDictionary, resolveLocale, LOCALE_COOKIE } from "@supastack/i18n";
const locale = resolveLocale([
cookieStore.get(LOCALE_COOKIE)?.value,
headers.get("x-supastack-locale"),
headers.get("accept-language"),
]);
const copy = getDictionary(locale);Команды для копирования
Следуйте комментариям, чтобы узнать, в какой папке запускается команда. Если помечены два терминала, откройте два окна терминала и продолжайте выполнять первую команду, пока используете вторую.
corepack pnpm test -- packages/i18n/src/index.test.ts
corepack pnpm --filter @supastack/web devРабочий процесс внедрения
Передайте локаль в отображаемые на сервере страницы настроек/организации и в параметры доставки почты NotificationCopyForEvent/auth, если они доступны. Сохраняйте английский как DEFAULT_LOCALE и избегайте придумывания маркетинговых заявлений за пределами словарных ключей.
Транзакционная почта остаётся отдельной от рассылок. Расширяйте словари до вложения каждого маркетингового маршрута под [locale].
Проверка и устранение неполадок
Если для одной фразы отображается английский язык, убедитесь, что ключ существует во всех четырех словарях и что страница запрашивает один и тот же ключ. Если при переключении языков возвращается домашняя страница, сохраните текущий путь при создании ссылки на локаль. Храните копию электронного письма на пути к транзакционной электронной почте; не используйте его повторно в качестве массовой аутрич-работы.
Запустите packages/i18n Vitest, прокси-тесты и тесты маршрутов языковых приложений. Выполните выборочную проверку LanguageSwitcher в / и локализованных заголовках Settings/org/dashboard/billing/chat, если префикс локали — de/es/fr.