Трёхъязычный сайт: сложен не перевод, а fallback
Свой сайт я веду на трёх языках — узбекском, русском и английском. Начиная, я думал, что самой сложной частью окажется перевод.
Я ошибался. Перевод — это труд, но труд понятный. Настоящая сложность в другом вопросе: что показывать, когда перевода нет?
Этот вопрос определяет всю архитектуру.
Два вида текста
Первое и самое важное решение — разделить текст на сайте на две категории.
Тексты интерфейса — кнопки, меню, сообщения об ошибках, заголовки. Их немного, они редко меняются и обязаны существовать на всех трёх языках.
Контент — статьи, описания проектов, тексты страниц. Его много, он часто добавляется, и часть его может существовать только на одном языке.
Управлять этими двумя видами одним механизмом — самая частая ошибка. Тексты интерфейса должны жить близко к коду: простой объект, типизированный, с гарантией наличия на этапе сборки.
export const dict = {
uz: { readMore: 'Batafsil', backHome: 'Bosh sahifa' },
ru: { readMore: 'Подробнее', backHome: 'На главную' },
en: { readMore: 'Read more', backHome: 'Home' },
} as constКонтент же живёт в CMS, и его наличие не гарантировано. Именно это различие определяет все последующие решения.
Стратегия fallback
Вот главный вопрос. Пользователь запросил страницу на русском, но статья есть только на узбекском. Что делать?
Вариантов три, и каждый передаёт разное сообщение.
Вернуть 404. Технически честно, но для пользователя плохо: он нажал на ссылку и попал в пустоту.
Скрыть из списка. То есть в русском списке показывать только статьи, существующие на русском. Чистое решение, но значительная часть вашего контента становится невидимой.
Показать на запасном языке. Если русской версии нет, показываете узбекскую.
Я выбрал третий вариант, и это было правильное решение. Причина проста: мои читатели чаще всего знают два языка, и для них «прочитать на другом языке» лучше, чем «не прочитать вовсе».
Форма реализации:
function pickLang<T extends { lang: string }>(rows: T[], want: string) {
return rows.find((r) => r.lang === want)
?? rows.find((r) => r.lang === 'uz')
?? rows[0]
}Три ступени: запрошенный язык, основной язык, первый существующий. Последняя ступень важна — без неё страница окажется пустой, если статья есть только на английском.
Важное условие: если вы показываете запасной язык, об этом нужно сказать пользователю. Достаточно небольшой пометки: «эта статья пока доступна только на узбекском». Иначе пользователь решит, что сайт сломан.
Маршрутизация: язык должен быть в адресе
Есть несколько вариантов, где хранить язык: cookie, настройка браузера или адрес.
Ответ однозначный: в адресе. /uz/blog/..., /ru/blog/....
Причина — в проблемах, которые создаёт cookie:
- Поделившись ссылкой, вы отправите получателя на другой язык
- Поисковая система увидит только одну версию
- Ломается кэширование — один адрес отдаёт разные ответы
Автоопределение языка браузера полезно, но только один раз: когда пользователь заходит на корневой адрес, вы перенаправляете его на подходящий язык. Дальше выбор живёт в адресе, и вы в него не вмешиваетесь.
У меня это работает через промежуточный слой, который выставляет языковой заголовок. Он определяет язык и передаёт его во всё дерево, чтобы каждый компонент не вычислял его заново.
SEO: hreflang и canonical
В этой части ошибаются чаще всего, и ошибки происходят молча.
Каждая страница должна отдавать три вещи.
Canonical — основной адрес этой страницы. Важная ловушка: не прописывайте его в общем layout. Если сделать так, все страницы канонизируются на один адрес и выпадут из индекса. Я допустил эту ошибку однажды, и на исправление ушло время, пока поисковик переиндексировал сайт.
hreflang — версии этой страницы на других языках. Он сообщает поисковику: «это перевод, а не дубликат».
<link rel="alternate" hreflang="uz" href="https://example.com/uz/blog/post" />
<link rel="alternate" hreflang="ru" href="https://example.com/ru/blog/post" />
<link rel="alternate" hreflang="en" href="https://example.com/en/blog/post" />
<link rel="alternate" hreflang="x-default" href="https://example.com/uz/blog/post" />x-default — для пользователя, чей язык не определён. Не пропускайте его.
Атрибут `<html lang>`. Мелочь, но он влияет на программы чтения с экрана и на автоперевод в браузере. Во многих проектах он остаётся жёстко заданным как en — проверьте.
В sitemap тоже включите все три языка. Поисковик должен найти все версии.
Процесс перевода
Помимо технической стороны есть практический вопрос: как вообще появляются переводы?
У меня контент создаётся сразу на трёх языках из одного источника — один slug, три строки. Это важная деталь: slug не переводится. Если у каждого языка будет свой slug, переключение между языками усложнится, а прописать hreflang станет труднее.
Для текстов интерфейса другое правило: добавляя новый ключ, его нужно добавить сразу на трёх языках. Это можно заставить делать систему типов — если тип словаря выводится из одного языка, компилятор сообщит о нехватке ключа в остальных.
Этот простой приём предотвращает состояние «переведу потом».
Что не нужно переводить
Есть несколько вещей, которые часто переводят напрасно.
Технические термины. «Deploy», «commit», «pull request» — насильственный перевод делает текст менее понятным. Ваши читатели знают эти слова в исходном виде.
Текст внутри кода. Имена переменных и строки в примерах кода не переводятся. Переводить можно только комментарии.
Имена собственные. Названия проектов, продуктов, бренд.
Правило: перевод должен помогать читателю, а не делать текст «полным».
Насколько это сложно
Честный ответ: сложно в первый день, потом просто.
Основная работа приходится на начало — маршрутизация, логика fallback, hreflang, структура словаря. Это работа на один день.
После этого для каждой новой страницы или статьи дополнительной работой остаётся только сам перевод. А если ваша контентная система устроена так, что создаёт все три языка одновременно, то и это не отдельный шаг.
Если вы начинаете, порядок такой: сначала маршрутизация на основе адреса, затем типизированный словарь интерфейса, затем функция fallback, в конце hreflang и sitemap. Проверяйте каждый этап отдельно — особенно canonical, потому что ошибка в нём обходится дороже всего и заметить её труднее всего.