Naar hoofdinhoud gaan

i18n-configuratie van Overleaf

Dit document beschrijft hoe u internationalisatie (i18n) configureert voor een zelfgehoste Overleaf-instantie.
Overleaf is in meerdere talen vertaald. Met de juiste configuratie kunt u:
  • 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 omgevingsvariabele OVERLEAF_SITE_LANGUAGE. Ondersteunde taalcodes zijn onder meer:
  • en - Engels (standaard)
  • es - Spaans
  • pt - Portugees
  • de - Duits
  • fr - Frans
  • cs - Tsjechisch
  • nl - Nederlands
  • sv - Zweeds
  • it - Italiaans
  • tr - Turks
  • zh-CN - Chinees (vereenvoudigd)
  • no - Noors
  • da - Deens
  • ru - Russisch
  • ko - Koreaans
  • ja - Japans
  • pl - Pools
  • fi - Fins
Engels is de standaardtaal. Om de interfacetaal te wijzigen (bijvoorbeeld naar vereenvoudigd Chinees), voegt u de volgende regel toe aan config/variables.env:
config/variables.env
Pas daarna de configuratie toe:
Nadat de services opnieuw zijn gestart, zou de interfacetaal in de menu’s van de web-UI de nieuwe instelling moeten weergeven.

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.com is
  • U een wildcard-TLS-certificaat hebt (bijv. *.overleaftest.com)
  • U geen localhost gebruikt (omdat dat geen taalroutering op basis van subdomeinen ondersteunt)
Voor lokale tests kunt u een domein zoals dev-overleaf.com gebruiken.
1

TLS-proxyconfiguratie (Nginx)

Uw TLS-reverse proxy moet de oorspronkelijke Host-header doorsturen, zodat Overleaf kan bepalen via welk taaldomein de gebruiker de site heeft bezocht.Zorg ervoor dat de volgende directive aanwezig is:
Hier is een voorbeeld van een Nginx-configuratie:
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 config/variables.env:
config/variables.env
Dit zorgt ervoor dat authenticatiecookies geldig zijn voor alle subdomeinen onder overleaftest.com.
3

Koppeling tussen taal en domein

Definieer vervolgens hoe taalcodes aan subdomeinen worden gekoppeld met
OVERLEAF_LANG_DOMAIN_MAPPING.

Voorbeeldconfiguratie

config/variables.env
Met deze configuratie:
  • https://www.overleaftest.com → Engelse interface
  • https://cn.overleaftest.com → vereenvoudigd Chinese interface
U kunt deze koppeling naar behoefte uitbreiden met extra talen en subdomeinen.
We raden aan de hoofdsite op www aan te bieden en altijd een www-sleutel op te nemen: stel OVERLEAF_SITE_URL in op het www-adres (bijvoorbeeld https://www.overleaftest.com), laat de www-sleutel daarnaar verwijzen en stuur het apex-domein daarnaar door zoals hieronder getoond. De www-sleutel is de hoofdsite en kan elke taal gebruiken. Zonder deze sleutel blijft de standaardvermelding www bestaan en toont de taalkiezer een extra Engelse optie die naar http://127.0.0.1:3000 linkt.
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

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.
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:
Laatst gewijzigd op 2 november 2026