Konfigurace i18n v Overleafu
Tento dokument popisuje, jak nakonfigurovat internacionalizaci (i18n) pro self-hosted instanci Overleafu.
- 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štinapt- portugalštinade- němčinafr- francouzštinacs- češtinanl- nizozemštinasv- švédštinait- italštinatr- turečtinazh-CN- čínština (zjednodušená)no- norštinada- dánštinaru- ruštinako- korejštinaja- japonštinapl- polštinafi- finština
config/variables.env následující řádek:
config/variables.env
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)
dev-overleaf.com.
1
Konfigurace TLS proxy (Nginx)
Vaše reverzní TLS proxy musí předávat původní hlavičku Zde je příklad konfigurace Nginx:
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: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 Tím zajistíte, že ověřovací cookies budou platné pro všechny subdomény pod
config/variables.env následující řádek:config/variables.env
overleaftest.com.3
Mapování jazyků na domény
Dále definujte, jak se kódy jazyků mapují na subdomény, pomocí
S touto konfigurací:
OVERLEAF_LANG_DOMAIN_MAPPING.Příklad konfigurace
config/variables.env
https://www.overleaftest.com→ anglické rozhraníhttps://cn.overleaftest.com→ rozhraní ve zjednodušené čínštině
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
Kde je tlačítko pro přepnutí jazyka?
Kde je tlačítko pro přepnutí jazyka?
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í.Proč jazyk ve výběru otevírá http://127.0.0.1:3000?
Proč jazyk ve výběru otevírá http://127.0.0.1:3000?
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:
