Перейти к основному содержанию

Настройка i18n в Overleaf

В этом документе описано, как настроить интернационализацию (i18n) для самостоятельно размещаемого экземпляра Overleaf.
Overleaf переведён на множество языков. При соответствующей настройке вы можете:
  • Запустить экземпляр Overleaf на одном фиксированном языке, или
  • Включить несколько языков, позволив пользователям динамически переключаться между ними, как на www.overleaf.com.

Настройка одного языка

Язык сайта задаётся переменной окружения OVERLEAF_SITE_LANGUAGE. Поддерживаемые коды языков:
  • en - английский (по умолчанию)
  • es - испанский
  • pt - португальский
  • de - немецкий
  • fr - французский
  • cs - чешский
  • nl - нидерландский
  • sv - шведский
  • it - итальянский
  • tr - турецкий
  • zh-CN - китайский (упрощённый)
  • no - норвежский
  • da - датский
  • ru - русский
  • ko - корейский
  • ja - японский
  • pl - польский
  • fi - финский
Английский — язык по умолчанию. Чтобы изменить язык интерфейса (например, на упрощённый китайский), добавьте следующую строку в config/variables.env:
config/variables.env
Затем примените конфигурацию:
После перезапуска сервисов язык меню веб-интерфейса должен соответствовать новой настройке.

Настройка нескольких языков

Чтобы пользователи могли переключать языки без выхода из системы, ваш экземпляр Overleaf должен быть настроен на выдачу разных языков в зависимости от доменного имени. В этом разделе предполагается, что:
  • Ваш основной домен — overleaftest.com
  • У вас есть wildcard-сертификат TLS (например, *.overleaftest.com)
  • Вы не используете localhost (так как он не поддерживает маршрутизацию языков на основе поддоменов)
Для локального тестирования можно использовать домен вроде dev-overleaf.com.
1

Настройка TLS-прокси (Nginx)

Ваш обратный TLS-прокси должен передавать исходный заголовок Host, чтобы Overleaf мог определить, к какому языковому домену обратился пользователь.Убедитесь, что присутствует следующая директива:
Пример конфигурации Nginx:
2

Настройка домена cookie

Чтобы пользователи не выходили из системы при переключении языков, cookie должны быть общими для всех языковых поддоменов.Добавьте следующую строку в config/variables.env:
config/variables.env
Это гарантирует, что cookie аутентификации действительны для всех поддоменов overleaftest.com.
3

Сопоставление языков и доменов

Далее задайте сопоставление кодов языков и поддоменов с помощью
OVERLEAF_LANG_DOMAIN_MAPPING.

Пример конфигурации

config/variables.env
При такой конфигурации:
  • https://www.overleaftest.com → английский интерфейс
  • https://cn.overleaftest.com → интерфейс на упрощённом китайском
При необходимости это сопоставление можно расширить, добавив другие языки и поддомены.
Мы рекомендуем размещать основной сайт на www и всегда указывать ключ www: задайте в OVERLEAF_SITE_URL адрес www (например, https://www.overleaftest.com), направьте на него ключ www и настройте перенаправление корневого домена на него, как показано ниже. Ключ www — это основной сайт, и он может использовать любой язык. Без него остаётся запись www по умолчанию, и в списке выбора языка появляется лишний пункт English, ведущий на http://127.0.0.1:3000.
4

Перенаправление корневого домена

Наконец, настройте перенаправление с корневого домена (overleaftest.com) на домен языка по умолчанию (www.overleaftest.com).

Вопросы и ответы

Ответ: Кнопка выбора языка (значок перевода) находится в нижнем колонтитуле страницы, например внизу списка проектов. В редакторе она не отображается.Кнопка появляется, только если OVERLEAF_LANG_DOMAIN_MAPPING сопоставляет два или более языков, как описано в разделе Настройка нескольких языков. Если задана только OVERLEAF_SITE_LANGUAGE, весь сайт использует этот один язык и кнопки нет.Выбор языка открывает ту же страницу на домене этого языка, например cn.overleaftest.com. Он не сохраняется как настройка пользователя.
Ответ: В OVERLEAF_LANG_DOMAIN_MAPPING нет ключа www. Сопоставление объединяется со стандартным, в котором есть запись www для английского языка с внутренним адресом http://127.0.0.1:3000. Если ваше сопоставление использует только другие ключи, например cn и en, эта стандартная запись сохраняется и отображается в списке выбора.Добавьте ключ www с адресом из OVERLEAF_SITE_URL и удалите вторую запись для того же языка, затем выполните bin/up -d:
Последнее изменение 2 ноября 2026 г.