Налаштування i18n в Overleaf
У цьому документі описано, як налаштувати інтернаціоналізацію (i18n) для самостійно розгорнутого екземпляра 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-проксі має передавати оригінальний заголовок Ось приклад конфігурації Nginx:
Host, щоб Overleaf міг визначити, до якого мовного домену звернувся користувач.Переконайтеся, що присутня така директива:2
Налаштування домену cookie
Щоб користувачі не виходили з облікового запису під час перемикання мови, файли cookie мають бути спільними для всіх мовних піддоменів.Додайте такий рядок до Це гарантує, що cookie автентифікації будуть дійсними для всіх піддоменів
config/variables.env:config/variables.env
overleaftest.com.3
Зіставлення мов і доменів
Далі визначте, як коди мов зіставляються з піддоменами, за допомогою
За такої конфігурації:
OVERLEAF_LANG_DOMAIN_MAPPING.Приклад конфігурації
config/variables.env
https://www.overleaftest.com→ англійський інтерфейсhttps://cn.overleaftest.com→ інтерфейс спрощеною китайською
4
Перенаправлення кореневого домену
Нарешті, перенаправте кореневий домен (
overleaftest.com) на домен мови за замовчуванням (www.overleaftest.com).Питання та відповіді
Де кнопка перемикання мови?
Де кнопка перемикання мови?
Відповідь: Кнопка мови (значок перекладу) розташована в нижньому колонтитулі сторінки, наприклад унизу списку проєктів. У редакторі вона не відображається.Кнопка з’являється лише тоді, коли
OVERLEAF_LANG_DOMAIN_MAPPING зіставляє дві або більше мов, як описано в розділі Налаштування кількох мов. Якщо задано лише OVERLEAF_SITE_LANGUAGE, увесь сайт використовує цю одну мову, і кнопки немає.Вибір мови відкриває ту саму сторінку в домені цієї мови, наприклад cn.overleaftest.com. Це не зберігається як налаштування користувача.Чому мова в меню вибору відкриває http://127.0.0.1:3000?
Чому мова в меню вибору відкриває http://127.0.0.1:3000?
Відповідь: В
OVERLEAF_LANG_DOMAIN_MAPPING немає ключа www. Зіставлення об’єднується зі стандартним, яке містить запис www для англійської мови з внутрішньою адресою http://127.0.0.1:3000. Якщо ваше зіставлення використовує лише інші ключі, як-от cn і en, цей стандартний запис зберігається й відображається в меню вибору.Додайте ключ www з адресою з OVERLEAF_SITE_URL, видаліть другий запис для тієї самої мови, а потім виконайте bin/up -d:
