i18n-configuratie van Overleaf
Dit document beschrijft hoe u internationalisatie (i18n) configureert voor een zelfgehoste Overleaf-instantie.
- Uw Overleaf-instantie in één vaste taal draaien, of
- Meerdere talen inschakelen, zodat gebruikers dynamisch van taal kunnen wisselen, vergelijkbaar met
www.overleaf.com.
Configuratie met één taal
De taal van de site wordt ingesteld met de omgevingsvariabeleOVERLEAF_SITE_LANGUAGE.
Ondersteunde taalcodes zijn onder meer:
en- Engels (standaard)es- Spaanspt- Portugeesde- Duitsfr- Franscs- Tsjechischnl- Nederlandssv- Zweedsit- Italiaanstr- Turkszh-CN- Chinees (vereenvoudigd)no- Noorsda- Deensru- Russischko- Koreaansja- Japanspl- Poolsfi- Fins
config/variables.env:
config/variables.env
Configuratie met meerdere talen
Om gebruikers van taal te laten wisselen zonder uit te loggen, moet uw Overleaf-instantie zo zijn geconfigureerd dat verschillende talen worden aangeboden op basis van domeinnamen. Deze sectie gaat ervan uit dat:- Uw primaire domein
overleaftest.comis - U een wildcard-TLS-certificaat hebt (bijv.
*.overleaftest.com) - U geen
localhostgebruikt (omdat dat geen taalroutering op basis van subdomeinen ondersteunt)
dev-overleaf.com gebruiken.
1
TLS-proxyconfiguratie (Nginx)
Uw TLS-reverse proxy moet de oorspronkelijke Hier is een voorbeeld van een Nginx-configuratie:
Host-header doorsturen, zodat Overleaf kan bepalen via welk taaldomein de gebruiker de site heeft bezocht.Zorg ervoor dat de volgende directive aanwezig is:2
Cookiedomein configureren
Om te voorkomen dat gebruikers worden uitgelogd wanneer ze van taal wisselen, moeten cookies over alle taalsubdomeinen worden gedeeld.Voeg de volgende regel toe aan Dit zorgt ervoor dat authenticatiecookies geldig zijn voor alle subdomeinen onder
config/variables.env:config/variables.env
overleaftest.com.3
Koppeling tussen taal en domein
Definieer vervolgens hoe taalcodes aan subdomeinen worden gekoppeld met
Met deze configuratie:
OVERLEAF_LANG_DOMAIN_MAPPING.Voorbeeldconfiguratie
config/variables.env
https://www.overleaftest.com→ Engelse interfacehttps://cn.overleaftest.com→ vereenvoudigd Chinese interface
4
Het apex-domein omleiden
Leid tot slot het apex-domein (
overleaftest.com) om naar het domein van de standaardtaal (www.overleaftest.com).Q&A
Waar is de knop om van taal te wisselen?
Waar is de knop om van taal te wisselen?
Antwoord: De taalknop (vertaalpictogram) staat in de voettekst van de pagina, bijvoorbeeld onderaan de projectlijst. Deze wordt niet getoond in de editor.De knop verschijnt alleen wanneer
OVERLEAF_LANG_DOMAIN_MAPPING twee of meer talen koppelt, zoals beschreven in Configuratie met meerdere talen. Als alleen OVERLEAF_SITE_LANGUAGE is ingesteld, gebruikt de hele site die ene taal en is er geen knop.Als u een taal kiest, wordt dezelfde pagina geopend op het domein van die taal, bijvoorbeeld cn.overleaftest.com. De keuze wordt niet opgeslagen als gebruikersinstelling.Waarom opent een taal in de kiezer http://127.0.0.1:3000?
Waarom opent een taal in de kiezer http://127.0.0.1:3000?
Antwoord:
OVERLEAF_LANG_DOMAIN_MAPPING heeft geen www-sleutel. De koppeling wordt samengevoegd met de standaardkoppeling, die een www-vermelding voor Engels bevat met het interne adres http://127.0.0.1:3000. Als uw koppeling alleen andere sleutels gebruikt, zoals cn en en, blijft die standaardvermelding behouden en verschijnt deze in de kiezer.Voeg een www-sleutel toe met het adres van OVERLEAF_SITE_URL, verwijder een tweede vermelding voor dezelfde taal en voer vervolgens bin/up -d uit:
