Przejdź do głównej treści

Konfiguracja i18n w Overleaf

Ten dokument opisuje, jak skonfigurować internacjonalizację (i18n) dla samodzielnie hostowanej instancji Overleaf.
Overleaf został przetłumaczony na wiele języków. Przy odpowiedniej konfiguracji możesz:
  • Uruchomić instancję Overleaf w jednym, stałym języku, lub
  • Włączyć wiele języków, umożliwiając użytkownikom dynamiczne przełączanie języka, podobnie jak w www.overleaf.com.

Konfiguracja jednego języka

Język witryny konfiguruje się za pomocą zmiennej środowiskowej OVERLEAF_SITE_LANGUAGE. Obsługiwane kody języków:
  • en - angielski (domyślny)
  • es - hiszpański
  • pt - portugalski
  • de - niemiecki
  • fr - francuski
  • cs - czeski
  • nl - niderlandzki
  • sv - szwedzki
  • it - włoski
  • tr - turecki
  • zh-CN - chiński (uproszczony)
  • no - norweski
  • da - duński
  • ru - rosyjski
  • ko - koreański
  • ja - japoński
  • pl - polski
  • fi - fiński
Domyślnym językiem jest angielski. Aby zmienić język interfejsu (na przykład na chiński uproszczony), dodaj następujący wiersz do config/variables.env:
config/variables.env
Następnie zastosuj konfigurację:
Po ponownym uruchomieniu usług język menu w interfejsie webowym powinien odpowiadać nowemu ustawieniu.

Konfiguracja wielu języków

Aby umożliwić użytkownikom przełączanie języka bez wylogowywania się, instancja Overleaf musi być skonfigurowana tak, aby serwować różne języki w zależności od nazwy domeny. W tej sekcji przyjęto następujące założenia:
  • Twoja domena główna to overleaftest.com
  • Masz certyfikat TLS typu wildcard (np. *.overleaftest.com)
  • Nie używasz localhost (ponieważ nie obsługuje on routingu języków opartego na subdomenach)
Do testów lokalnych możesz użyć domeny takiej jak dev-overleaf.com.
1

Konfiguracja proxy TLS (Nginx)

Odwrotne proxy TLS musi przekazywać oryginalny nagłówek Host, aby Overleaf mógł ustalić, do której domeny językowej odwołał się użytkownik.Upewnij się, że obecna jest następująca dyrektywa:
Oto przykładowa konfiguracja Nginx:
2

Skonfiguruj domenę ciasteczek

Aby użytkownicy nie byli wylogowywani podczas zmiany języka, ciasteczka (cookies) muszą być współdzielone między subdomenami językowymi.Dodaj następujący wiersz do config/variables.env:
config/variables.env
Dzięki temu ciasteczka uwierzytelniające są ważne dla wszystkich subdomen w obrębie overleaftest.com.
3

Mapowanie języków na domeny

Następnie zdefiniuj, jak kody języków mają być mapowane na subdomeny, używając
OVERLEAF_LANG_DOMAIN_MAPPING.

Przykładowa konfiguracja

config/variables.env
Przy tej konfiguracji:
  • https://www.overleaftest.com → interfejs w języku angielskim
  • https://cn.overleaftest.com → interfejs w języku chińskim uproszczonym
W razie potrzeby możesz rozszerzyć to mapowanie o kolejne języki i subdomeny.
Zalecamy udostępnianie głównej witryny pod www i zawsze dodawanie klucza www: ustaw OVERLEAF_SITE_URL na adres www (na przykład https://www.overleaftest.com), skieruj na niego klucz www i przekieruj na niego domenę główną (apex), jak pokazano poniżej. Klucz www oznacza główną witrynę i może używać dowolnego języka. Bez niego pozostaje domyślny wpis www, a selektor języka wyświetla dodatkową pozycję angielską, która prowadzi do http://127.0.0.1:3000.
4

Przekieruj domenę główną (apex)

Na koniec przekieruj domenę główną (overleaftest.com) na domenę języka domyślnego (www.overleaftest.com).

Pytania i odpowiedzi

Odpowiedź: Przycisk języka (ikona tłumaczenia) znajduje się w stopce strony, na przykład na dole listy projektów. Nie jest wyświetlany w edytorze.Przycisk pojawia się tylko wtedy, gdy OVERLEAF_LANG_DOMAIN_MAPPING mapuje dwa lub więcej języków, zgodnie z opisem w sekcji Konfiguracja wielu języków. Gdy ustawiono tylko OVERLEAF_SITE_LANGUAGE, cała witryna używa tego jednego języka i przycisk nie jest wyświetlany.Wybranie języka otwiera tę samą stronę w domenie tego języka, na przykład cn.overleaftest.com. Wybór nie jest zapisywany jako ustawienie użytkownika.
Odpowiedź: OVERLEAF_LANG_DOMAIN_MAPPING nie zawiera klucza www. Mapowanie jest scalane z domyślnym, które zawiera wpis www dla języka angielskiego z wewnętrznym adresem http://127.0.0.1:3000. Jeśli Twoje mapowanie używa wyłącznie innych kluczy, takich jak cn i en, ten domyślny wpis zostaje zachowany i pojawia się w selektorze.Dodaj klucz www z adresem z OVERLEAF_SITE_URL, usuń drugi wpis dla tego samego języka, a następnie uruchom bin/up -d:
Ostatnia modyfikacja 2 listopada 2026