Армянскую версию не нужно создавать копированием шаблонов в папку `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 указываются полностью.
- Определить locale из явного URL, а не только из Accept-Language.
- Загрузить сущность по стабильному content ID и перевод по locale.
- Отрендерить общий шаблон с `<html lang="hy">`.
- Добавить взаимные hreflang только для реально доступных версий.
- Сохранить выбор языка пользователя без принудительного SEO-редиректа.
Приёмка ищет не только непереведённые строки
Проверьте армянские буквы в базе, JSON, шрифте, поиске, письмах и экспорте. Везде нужен Unicode/UTF-8; выбранный webfont должен содержать Armenian glyphs, иначе появятся квадраты при корректных данных. Пройдите длинные заголовки, маленький экран и copy/paste, а также сортировку, дату, валюту и доступное произношение screen reader через `lang`.
Готовая локализация использует один набор шаблонов, не содержит ручных веток вида `if Armenian then copied page`, показывает нулевой список обязательных missing keys и не публикует пустые переводы. Снимок отчёта полноты, список URL и несколько эталонных скриншотов дают редакции больше пользы, чем число переведённых файлов.