Konfiguracja i18n w Overleaf
Ten dokument opisuje, jak skonfigurować internacjonalizację (i18n) dla samodzielnie hostowanej instancji Overleaf.
- 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 środowiskowejOVERLEAF_SITE_LANGUAGE.
Obsługiwane kody języków:
en- angielski (domyślny)es- hiszpańskipt- portugalskide- niemieckifr- francuskics- czeskinl- niderlandzkisv- szwedzkiit- włoskitr- tureckizh-CN- chiński (uproszczony)no- norweskida- duńskiru- rosyjskiko- koreańskija- japońskipl- polskifi- fiński
config/variables.env:
config/variables.env
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)
dev-overleaf.com.
1
Konfiguracja proxy TLS (Nginx)
Odwrotne proxy TLS musi przekazywać oryginalny nagłówek Oto przykładowa konfiguracja Nginx:
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: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 Dzięki temu ciasteczka uwierzytelniające są ważne dla wszystkich subdomen w obrębie
config/variables.env:config/variables.env
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
Przy tej konfiguracji:
OVERLEAF_LANG_DOMAIN_MAPPING.Przykładowa konfiguracja
config/variables.env
https://www.overleaftest.com→ interfejs w języku angielskimhttps://cn.overleaftest.com→ interfejs w języku chińskim uproszczonym
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
Gdzie jest przycisk zmiany języka?
Gdzie jest przycisk zmiany języka?
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.Dlaczego język w selektorze otwiera http://127.0.0.1:3000?
Dlaczego język w selektorze otwiera http://127.0.0.1:3000?
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:
