Перейти до основного вмісту

Налаштування 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 р.