Siirry pääsisältöön

Overleafin i18n-määritys

Tässä dokumentissa kuvataan, miten kansainvälistäminen (i18n) määritetään itse ylläpidetylle Overleaf-instanssille.
Overleaf on käännetty useille kielille. Sopivilla määrityksillä voit:
  • ajaa Overleaf-instanssiasi yhdellä kiinteällä kielellä, tai
  • ottaa käyttöön useita kieliä, jolloin käyttäjät voivat vaihtaa kieltä lennossa, samaan tapaan kuin www.overleaf.com-sivustolla.

Yhden kielen määritys

Sivuston kieli määritetään ympäristömuuttujalla OVERLEAF_SITE_LANGUAGE. Tuettuja kielikoodeja ovat:
  • en - englanti (oletus)
  • es - espanja
  • pt - portugali
  • de - saksa
  • fr - ranska
  • cs - tšekki
  • nl - hollanti
  • sv - ruotsi
  • it - italia
  • tr - turkki
  • zh-CN - kiina (yksinkertaistettu)
  • no - norja
  • da - tanska
  • ru - venäjä
  • ko - korea
  • ja - japani
  • pl - puola
  • fi - suomi
Englanti on oletuskieli. Vaihtaaksesi käyttöliittymän kielen (esimerkiksi yksinkertaistetuksi kiinaksi) lisää seuraava rivi tiedostoon config/variables.env:
config/variables.env
Ota määritys sitten käyttöön:
Kun palvelut ovat käynnistyneet uudelleen, verkkokäyttöliittymän valikoiden kielen pitäisi vastata uutta asetusta.

Usean kielen määritys

Jotta käyttäjät voivat vaihtaa kieltä kirjautumatta ulos, Overleaf-instanssisi on määritettävä tarjoamaan eri kieliä verkkotunnusten perusteella. Tässä osiossa oletetaan, että:
  • ensisijainen verkkotunnuksesi on overleaftest.com
  • sinulla on wildcard-TLS-varmenne (esim. *.overleaftest.com)
  • et käytä localhost-osoitetta (koska se ei tue aliverkkotunnuksiin perustuvaa kielireititystä)
Paikallista testausta varten voit käyttää esimerkiksi verkkotunnusta dev-overleaf.com.
1

TLS-välityspalvelimen määritys (Nginx)

TLS-käänteisvälityspalvelimesi on välitettävä alkuperäinen Host-otsake, jotta Overleaf voi päätellä, minkä kielen verkkotunnuksen kautta käyttäjä saapui.Varmista, että seuraava direktiivi on mukana:
Tässä on esimerkki Nginx-määrityksestä:
2

Määritä evästeiden verkkotunnus

Jotta käyttäjät eivät kirjautuisi ulos kieltä vaihtaessaan, evästeiden on oltava jaettuja kaikkien kielten aliverkkotunnusten kesken.Lisää seuraava rivi tiedostoon config/variables.env:
config/variables.env
Tämä varmistaa, että todennusevästeet ovat voimassa kaikissa overleaftest.com-verkkotunnuksen aliverkkotunnuksissa.
3

Kielten ja verkkotunnusten vastaavuus

Määritä seuraavaksi, miten kielikoodit vastaavat aliverkkotunnuksia, muuttujalla
OVERLEAF_LANG_DOMAIN_MAPPING.

Esimerkkimääritys

config/variables.env
Tällä määrityksellä:
  • https://www.overleaftest.com → englanninkielinen käyttöliittymä
  • https://cn.overleaftest.com → yksinkertaistetun kiinan käyttöliittymä
Voit laajentaa tätä vastaavuutta tarpeen mukaan lisäkielillä ja -aliverkkotunnuksilla.
Suosittelemme, että tarjoat pääsivuston www-osoitteessa ja lisäät aina www-avaimen: aseta OVERLEAF_SITE_URL www-osoitteeseen (esimerkiksi https://www.overleaftest.com), osoita www-avain siihen ja ohjaa juuriverkkotunnus siihen alla esitetyllä tavalla. www-avain on pääsivusto, ja se voi käyttää mitä tahansa kieltä. Ilman sitä oletusarvoinen www-merkintä säilyy, ja kielivalitsin näyttää ylimääräisen englanninkielisen kohdan, joka linkittää osoitteeseen http://127.0.0.1:3000.
4

Ohjaa pääverkkotunnus uudelleen

Ohjaa lopuksi pääverkkotunnus (overleaftest.com) oletuskielen verkkotunnukseen (www.overleaftest.com).

Q&A

Vastaus: Kielipainike (käännöskuvake) on sivun alatunnisteessa, esimerkiksi projektiluettelon alaosassa. Sitä ei näytetä editorissa.Painike näkyy vain, kun OVERLEAF_LANG_DOMAIN_MAPPING määrittää kaksi tai useampia kieliä, kuten kohdassa Usean kielen määritys kuvataan. Kun vain OVERLEAF_SITE_LANGUAGE on asetettu, koko sivusto käyttää sitä yhtä kieltä eikä painiketta ole.Kielen valitseminen avaa saman sivun kyseisen kielen verkkotunnuksessa, esimerkiksi cn.overleaftest.com. Valintaa ei tallenneta käyttäjän asetukseksi.
Vastaus: OVERLEAF_LANG_DOMAIN_MAPPING ei sisällä www-avainta. Vastaavuus yhdistetään oletusvastaavuuteen, jossa on englannin www-merkintä sisäisellä osoitteella http://127.0.0.1:3000. Jos vastaavuutesi käyttää vain muita avaimia, kuten cn ja en, oletusmerkintä säilyy ja näkyy valitsimessa.Lisää www-avain OVERLEAF_SITE_URL-muuttujan osoitteella, poista saman kielen toinen merkintä ja aja sitten bin/up -d:
Viimeksi muokattu 2. marraskuuta 2026