Konfigurasi i18n Overleaf
Dokumen ini menjelaskan cara mengonfigurasi internasionalisasi (i18n) untuk instance Overleaf yang di-host sendiri.
- Menjalankan instance Overleaf Anda dalam satu bahasa tetap, atau
- Mengaktifkan beberapa bahasa, sehingga pengguna dapat berganti bahasa secara dinamis, seperti di
www.overleaf.com.
Konfigurasi Satu Bahasa
Bahasa situs dikonfigurasi menggunakan variabel lingkunganOVERLEAF_SITE_LANGUAGE.
Kode bahasa yang didukung meliputi:
en- Inggris (default)es- Spanyolpt- Portugisde- Jermanfr- Pranciscs- Cekonl- Belandasv- Swediait- Italiatr- Turkizh-CN- Tionghoa (sederhana)no- Norwegiada- Denmarkru- Rusiako- Koreaja- Jepangpl- Polandiafi- Finlandia
config/variables.env:
config/variables.env
Konfigurasi Beberapa Bahasa
Agar pengguna dapat berganti bahasa tanpa harus keluar, instance Overleaf Anda harus dikonfigurasi untuk menyajikan bahasa yang berbeda berdasarkan nama domain. Bagian ini mengasumsikan:- Domain utama Anda adalah
overleaftest.com - Anda memiliki sertifikat TLS wildcard (misalnya
*.overleaftest.com) - Anda tidak menggunakan
localhost(karena tidak mendukung perutean bahasa berbasis subdomain)
dev-overleaf.com.
1
Konfigurasi Proxy TLS (Nginx)
Reverse proxy TLS Anda harus meneruskan header Berikut contoh konfigurasi Nginx:
Host asli agar Overleaf dapat menentukan domain bahasa mana yang diakses pengguna.Pastikan direktif berikut ada:2
Mengonfigurasi Domain Cookie
Agar pengguna tidak keluar saat berganti bahasa, cookie harus dibagikan ke seluruh subdomain bahasa.Tambahkan baris berikut ke Ini memastikan cookie autentikasi berlaku untuk semua subdomain di bawah
config/variables.env:config/variables.env
overleaftest.com.3
Pemetaan Bahasa–Domain
Selanjutnya, tentukan bagaimana kode bahasa dipetakan ke subdomain menggunakan
Dengan konfigurasi ini:
OVERLEAF_LANG_DOMAIN_MAPPING.Contoh Konfigurasi
config/variables.env
https://www.overleaftest.com→ antarmuka bahasa Inggrishttps://cn.overleaftest.com→ antarmuka bahasa Tionghoa Sederhana
4
Mengalihkan Domain Apex
Terakhir, alihkan domain apex (
overleaftest.com) ke domain bahasa default (www.overleaftest.com).Tanya Jawab
Di mana tombol pengalih bahasa?
Di mana tombol pengalih bahasa?
Jawaban: Tombol bahasa (ikon terjemahan) berada di footer halaman, misalnya di bagian bawah daftar proyek. Tombol ini tidak ditampilkan di editor.Tombol ini hanya muncul jika
OVERLEAF_LANG_DOMAIN_MAPPING memetakan dua bahasa atau lebih, seperti yang dijelaskan di Konfigurasi Beberapa Bahasa. Jika hanya OVERLEAF_SITE_LANGUAGE yang diatur, seluruh situs menggunakan satu bahasa tersebut dan tidak ada tombol.Memilih bahasa akan membuka halaman yang sama di domain bahasa tersebut, misalnya cn.overleaftest.com. Pilihan ini tidak disimpan sebagai pengaturan pengguna.Mengapa sebuah bahasa di pemilih membuka http://127.0.0.1:3000?
Mengapa sebuah bahasa di pemilih membuka http://127.0.0.1:3000?
Jawaban:
OVERLEAF_LANG_DOMAIN_MAPPING tidak memiliki kunci www. Pemetaan ini digabungkan ke pemetaan default, yang memiliki entri www untuk bahasa Inggris dengan alamat internal http://127.0.0.1:3000. Jika pemetaan Anda hanya menggunakan kunci lain, seperti cn dan en, entri default tersebut tetap ada dan muncul di pemilih.Tambahkan kunci www dengan alamat OVERLEAF_SITE_URL, hapus entri kedua untuk bahasa yang sama, lalu jalankan bin/up -d:
