Ana içeriğe atla

Overleaf i18n Yapılandırması

Bu belge, kendi sunucunuzda barındırılan bir Overleaf örneği için uluslararasılaştırmanın (i18n) nasıl yapılandırılacağını açıklar.
Overleaf birçok dile çevrilmiştir. Uygun yapılandırmayla şunları yapabilirsiniz:
  • Overleaf örneğinizi tek bir sabit dilde çalıştırabilir veya
  • www.overleaf.com’a benzer şekilde kullanıcıların dili dinamik olarak değiştirmesine olanak tanıyan birden çok dili etkinleştirebilirsiniz.

Tek Dil Yapılandırması

Site dili, OVERLEAF_SITE_LANGUAGE ortam değişkeni kullanılarak yapılandırılır. Desteklenen dil kodları şunlardır:
  • en - İngilizce (varsayılan)
  • es - İspanyolca
  • pt - Portekizce
  • de - Almanca
  • fr - Fransızca
  • cs - Çekçe
  • nl - Felemenkçe
  • sv - İsveççe
  • it - İtalyanca
  • tr - Türkçe
  • zh-CN - Çince (basitleştirilmiş)
  • no - Norveççe
  • da - Danca
  • ru - Rusça
  • ko - Korece
  • ja - Japonca
  • pl - Lehçe
  • fi - Fince
Varsayılan dil İngilizcedir. Arayüz dilini değiştirmek için (örneğin Basitleştirilmiş Çince olarak), config/variables.env dosyasına aşağıdaki satırı ekleyin:
config/variables.env
Ardından yapılandırmayı uygulayın:
Servisler yeniden başladıktan sonra, web arayüzü menülerindeki arayüz dili yeni ayarı yansıtmalıdır.

Çoklu Dil Yapılandırması

Kullanıcıların oturumu kapatmadan dil değiştirebilmesi için Overleaf örneğinizin alan adlarına göre farklı diller sunacak şekilde yapılandırılması gerekir. Bu bölümde şunlar varsayılmaktadır:
  • Birincil alan adınız overleaftest.com
  • Bir joker karakterli (wildcard) TLS sertifikanız var (ör. *.overleaftest.com)
  • localhost kullanmıyorsunuz (çünkü alt alan adı tabanlı dil yönlendirmesini destekleyemez)
Yerel testler için dev-overleaf.com gibi bir alan adı kullanabilirsiniz.
1

TLS Proxy Yapılandırması (Nginx)

Overleaf’in kullanıcının hangi dil alan adına eriştiğini belirleyebilmesi için TLS ters proxy’nizin orijinal Host başlığını iletmesi gerekir.Aşağıdaki yönergenin mevcut olduğundan emin olun:
İşte örnek bir Nginx yapılandırması:
2

Çerez Alan Adını Yapılandırma

Dil değiştirirken kullanıcıların oturumunun kapanmasını önlemek için çerezlerin dil alt alan adları arasında paylaşılması gerekir.config/variables.env dosyasına aşağıdaki satırı ekleyin:
config/variables.env
Bu, kimlik doğrulama çerezlerinin overleaftest.com altındaki tüm alt alan adları için geçerli olmasını sağlar.
3

Dil–Alan Adı Eşlemesi

Ardından, dil kodlarının alt alan adlarıyla nasıl eşleneceğini
OVERLEAF_LANG_DOMAIN_MAPPING kullanarak tanımlayın.

Örnek Yapılandırma

config/variables.env
Bu yapılandırmayla:
  • https://www.overleaftest.com → İngilizce arayüz
  • https://cn.overleaftest.com → Basitleştirilmiş Çince arayüz
Bu eşlemeyi gerektiğinde ek diller ve alt alan adlarıyla genişletebilirsiniz.
Ana siteyi www üzerinde sunmanızı ve her zaman bir www anahtarı eklemenizi öneririz: OVERLEAF_SITE_URL değerini www adresine ayarlayın (örneğin https://www.overleaftest.com), www anahtarını bu adrese yönlendirin ve apex alan adını aşağıda gösterildiği gibi bu adrese yönlendirin. www anahtarı ana sitedir ve herhangi bir dili kullanabilir. Bu anahtar olmadan varsayılan www girdisi kalır ve dil seçici, http://127.0.0.1:3000 adresine bağlanan fazladan bir İngilizce öğe gösterir.
4

Apex Alan Adını Yönlendirme

Son olarak, apex alan adını (overleaftest.com) varsayılan dil alan adına (www.overleaftest.com) yönlendirin.

Soru&Cevap

Yanıt: Dil düğmesi (çeviri simgesi) sayfa altbilgisinde, örneğin proje listesinin en altında bulunur. Düzenleyicide gösterilmez.Düğme yalnızca OVERLEAF_LANG_DOMAIN_MAPPING, Çoklu Dil Yapılandırması bölümünde açıklandığı gibi iki veya daha fazla dili eşlediğinde görünür. Yalnızca OVERLEAF_SITE_LANGUAGE ayarlandığında sitenin tamamı tek bir dili kullanır ve düğme yoktur.Bir dil seçmek, aynı sayfayı o dilin alan adında açar, örneğin cn.overleaftest.com. Bu seçim bir kullanıcı ayarı olarak kaydedilmez.
Yanıt: OVERLEAF_LANG_DOMAIN_MAPPING içinde www anahtarı yoktur. Eşleme, İngilizce için dahili http://127.0.0.1:3000 adresine sahip bir www girdisi içeren varsayılan eşlemeyle birleştirilir. Eşlemeniz yalnızca cn ve en gibi başka anahtarlar kullanıyorsa, bu varsayılan girdi korunur ve seçicide görünür.OVERLEAF_SITE_URL adresini içeren bir www anahtarı ekleyin, aynı dil için ikinci bir girdi varsa kaldırın ve ardından bin/up -d komutunu çalıştırın:
Son değiştirilme tarihi 2 Kasım 2026