Армянскую версию не нужно создавать копированием шаблонов в папку `hy`. У страницы остаются один component, один content ID и одна бизнес-логика. Меняются только значения, действительно зависящие от языка: подписи интерфейса, title/description, редакционные поля и при необходимости slug. Такой подход не даёт русской и армянской версиям разъехаться после следующей правки дизайна.

Для армянского языка используйте BCP 47 tag `hy`. Региональный `hy-AM` нужен, когда продукт действительно различает армянский язык для Армении и другие региональные варианты; добавлять страну «на всякий случай» не требуется. В HTML базовый язык объявляется на элементе `html`, например `<html lang="hy">`.

Сначала отделяем четыре вида текста

ДанныеГде хранитьНужен перевод
кнопки, ошибки, менюlocale catalog по ключамда, командой продукта
статья или карточка услугиtranslation rows по content IDда, редакцией
имя пользователя, артикул, кодосновная сущностьобычно нет
дата, число, валютаисходное значение + formatterформатируется locale
шаблон и правила доступаобщий application codeнет

Эта классификация защищает от двух крайностей: строк, зашитых в template, и попытки «перевести» все поля базы. Например, имя автора не меняется, а подпись «Опубликовано» берётся из каталога; timestamp хранится один, но форматируется правилами locale.

Ключи переживают изменение исходной фразы

Ключ называют по смыслу, а не копируют русский текст: `checkout.pay`, `profile.security.sessions`, `error.upload.too_large`. Тогда редактор может изменить русскую фразу, не ломая lookup. Для контента подходит таблица с `content_id`, `locale`, переведёнными полями и уникальным ограничением на пару. Публикация армянской версии имеет собственный статус готовности.

ui.hy.json
{
  "checkout.pay": "Վճարել",
  "nav.help": "Օգնություն"
}

content_translations
  content_id | locale | title | body | status
  842        | hy     | ...   | ...  | published
  • Одинаковый ключ используется во всех компонентах с одним смыслом.
  • Переменные передаются отдельно и не собираются конкатенацией фрагментов предложения.
  • Missing key попадает в отчёт сборки или мониторинг, а не молча исчезает.
  • HTML из перевода разрешается только через проверенный формат и sanitization.

Fallback должен быть заметен редакции

Падение `hy-AM -> hy -> default` удобно для интерфейсных терминов, но на публичной странице оно способно выдать смешанный язык. Решите политику отдельно: критическая кнопка может временно показать default, а непереведённую статью лучше не публиковать под армянским URL. Счётчик missing keys и список неполных content translations входят в release checklist.

Даты, числа и множественные формы не форматируют заменой разделителей вручную. Используйте locale-aware Intl/ICU и данные Unicode CLDR. У Armenian в CLDR есть категории множественного числа и грамматические данные; форма строки должна выбираться formatter, а не условием, скопированным из русского языка.

Маршрут и SEO описывают одну сущность

URL может иметь языковой префикс `/hy/...`, при этом роут разрешается в тот же content ID. На каждой языковой версии задайте собственные title, description, canonical на себя и ссылки `hreflang` на доступные переводы. Google требует, чтобы alternate-набор включал саму страницу и чтобы языковые версии ссылались друг на друга; все URL указываются полностью.

  1. Определить locale из явного URL, а не только из Accept-Language.
  2. Загрузить сущность по стабильному content ID и перевод по locale.
  3. Отрендерить общий шаблон с `<html lang="hy">`.
  4. Добавить взаимные hreflang только для реально доступных версий.
  5. Сохранить выбор языка пользователя без принудительного SEO-редиректа.

Приёмка ищет не только непереведённые строки

Проверьте армянские буквы в базе, JSON, шрифте, поиске, письмах и экспорте. Везде нужен Unicode/UTF-8; выбранный webfont должен содержать Armenian glyphs, иначе появятся квадраты при корректных данных. Пройдите длинные заголовки, маленький экран и copy/paste, а также сортировку, дату, валюту и доступное произношение screen reader через `lang`.

Готовая локализация использует один набор шаблонов, не содержит ручных веток вида `if Armenian then copied page`, показывает нулевой список обязательных missing keys и не публикует пустые переводы. Снимок отчёта полноты, список URL и несколько эталонных скриншотов дают редакции больше пользы, чем число переведённых файлов.

Проверенные источники