Přejít na hlavní obsah

Konfigurace i18n v Overleafu

Tento dokument popisuje, jak nakonfigurovat internacionalizaci (i18n) pro self-hosted instanci Overleafu.
Overleaf byl přeložen do mnoha jazyků. S vhodnou konfigurací můžete:
  • Provozovat instanci Overleafu v jediném pevně daném jazyce, nebo
  • Povolit více jazyků a umožnit uživatelům dynamicky přepínat jazyk, podobně jako na www.overleaf.com.

Konfigurace jednoho jazyka

Jazyk webu se nastavuje pomocí proměnné prostředí OVERLEAF_SITE_LANGUAGE. Podporované kódy jazyků:
  • en - angličtina (výchozí)
  • es - španělština
  • pt - portugalština
  • de - němčina
  • fr - francouzština
  • cs - čeština
  • nl - nizozemština
  • sv - švédština
  • it - italština
  • tr - turečtina
  • zh-CN - čínština (zjednodušená)
  • no - norština
  • da - dánština
  • ru - ruština
  • ko - korejština
  • ja - japonština
  • pl - polština
  • fi - finština
Výchozím jazykem je angličtina. Chcete-li změnit jazyk rozhraní (například na zjednodušenou čínštinu), přidejte do config/variables.env následující řádek:
config/variables.env
Poté konfiguraci použijte:
Po restartu služeb by se nové nastavení mělo projevit v jazyce nabídek webového rozhraní.

Konfigurace více jazyků

Aby uživatelé mohli přepínat jazyky bez odhlášení, musí být vaše instance Overleafu nakonfigurována tak, aby obsluhovala různé jazyky podle názvů domén. Tato část předpokládá, že:
  • Vaše primární doména je overleaftest.com
  • Máte wildcard certifikát TLS (např. *.overleaftest.com)
  • Nepoužíváte localhost (protože ten nepodporuje směrování jazyků podle subdomén)
Pro lokální testování můžete použít doménu jako dev-overleaf.com.
1

Konfigurace TLS proxy (Nginx)

Vaše reverzní TLS proxy musí předávat původní hlavičku Host, aby Overleaf mohl určit, na kterou jazykovou doménu uživatel přistoupil.Ujistěte se, že je přítomna následující direktiva:
Zde je příklad konfigurace Nginx:
2

Konfigurace domény cookies

Aby se uživatelé při přepínání jazyků neodhlašovali, musí být cookies sdíleny napříč jazykovými subdoménami.Přidejte do config/variables.env následující řádek:
config/variables.env
Tím zajistíte, že ověřovací cookies budou platné pro všechny subdomény pod overleaftest.com.
3

Mapování jazyků na domény

Dále definujte, jak se kódy jazyků mapují na subdomény, pomocí
OVERLEAF_LANG_DOMAIN_MAPPING.

Příklad konfigurace

config/variables.env
S touto konfigurací:
  • https://www.overleaftest.com → anglické rozhraní
  • https://cn.overleaftest.com → rozhraní ve zjednodušené čínštině
Toto mapování můžete podle potřeby rozšířit o další jazyky a subdomény.
Doporučujeme provozovat hlavní web na www a vždy uvést klíč www: nastavte OVERLEAF_SITE_URL na adresu www (například https://www.overleaftest.com), nasměrujte na ni klíč www a přesměrujte na ni apex doménu, jak je uvedeno níže. Klíč www představuje hlavní web a může používat libovolný jazyk. Bez něj zůstane výchozí položka www a výběr jazyka zobrazí navíc položku pro angličtinu, která odkazuje na http://127.0.0.1:3000.
4

Přesměrování hlavní domény

Nakonec přesměrujte hlavní doménu (overleaftest.com) na doménu výchozího jazyka (www.overleaftest.com).

Otázky a odpovědi

Odpověď: Tlačítko jazyka (ikona překladu) je v patičce stránky, například v dolní části seznamu projektů. V editoru se nezobrazuje.Tlačítko se zobrazí pouze tehdy, když OVERLEAF_LANG_DOMAIN_MAPPING mapuje dva nebo více jazyků, jak je popsáno v části Konfigurace více jazyků. Pokud je nastaveno pouze OVERLEAF_SITE_LANGUAGE, celý web používá tento jeden jazyk a tlačítko se nezobrazí.Výběrem jazyka se otevře stejná stránka na doméně daného jazyka, například cn.overleaftest.com. Neukládá se jako uživatelské nastavení.
Odpověď: OVERLEAF_LANG_DOMAIN_MAPPING nemá klíč www. Mapování se slučuje s výchozím, které obsahuje položku www pro angličtinu s interní adresou http://127.0.0.1:3000. Pokud vaše mapování používá pouze jiné klíče, například cn a en, tato výchozí položka zůstane zachována a zobrazí se ve výběru.Přidejte klíč www s adresou z OVERLEAF_SITE_URL, odstraňte druhou položku pro stejný jazyk a poté spusťte bin/up -d:
Naposledy změněno 2. listopadu 2026