chrome.i18n

Açıklama

Manifest

Bir uzantının /_locales dizini varsa manifest, "default_locale" öğesini tanımlamalıdır.

Kavramlar ve kullanım

Kullanıcı tarafından görülebilen tüm dizeleri messages.json adlı bir dosyaya yerleştirmeniz gerekir. Her yeni yerel ayar eklediğinizde, /_locales/_localeCode_ adlı bir dizinin altına bir mesaj dosyası eklersiniz. Burada localeCode, İngilizce için en gibi bir koddur.

İngilizce (en), İspanyolca (es) ve Korece (ko) dillerini destekleyen uluslararası bir uzantının dosya hiyerarşisi aşağıda verilmiştir:

Birden fazla dili destekleme

Aşağıdaki şekilde gösterilen dosyalara sahip bir uzantınız olduğunu varsayalım:

Bu uzantıyı uluslararası hale getirmek için kullanıcı tarafından görülebilen her dizeyi adlandırır ve bir messages dosyasına yerleştirirsiniz. Uzantının manifesti, CSS dosyaları ve JavaScript kodu, yerelleştirilmiş sürümünü almak için her dizenin adını kullanır.

Uzantı, uluslararası hale getirildiğinde aşağıdaki gibi görünür (yalnızca İngilizce dizeler içerdiğini unutmayın):

Ulusallaştırma ile ilgili bazı notlar:

• Desteklenen yerel ayarlardan herhangi birini kullanabilirsiniz. Desteklenmeyen bir yerel ayar kullanıyorsanız Google Chrome bunu yoksayar.

• manifest.json ve CSS dosyalarında, messagename adlı bir dizeye şu şekilde referans verin:

  __MSG_messagename__
  

• Uzantınızın veya uygulamanızın JavaScript kodunda, messagename adlı bir dizeye şu şekilde referans verin:

  chrome.i18n.getMessage("messagename")
  

• getMessage() çağrılarında, iletiye eklenecek en fazla 9 dize sağlayabilirsiniz. Ayrıntılar için Örnekler: getMessage konusuna bakın.

• @@bidi_dir ve @@ui_locale gibi bazı mesajlar, uluslararasılaştırma sistemi tarafından sağlanır. Önceden tanımlanmış mesaj adlarının tam listesi için Önceden tanımlanmış mesajlar bölümüne bakın.

• messages.json içinde, kullanıcı tarafından görülebilen her dizenin bir adı, bir "message" öğesi ve isteğe bağlı bir "description" öğesi vardır. Ad, dizeyi tanımlayan "extName" veya "search_string" gibi bir anahtardır. "message", bu yerel ayardaki dizenin değerini belirtir. İsteğe bağlı "açıklama", dizenin uzantınızda nasıl kullanıldığını göremeyebilecek çevirmenlere yardımcı olur. Örneğin:

  {
    "search_string": {
      "message": "hello%20world",
      "description": "The string we search for. Put %20 between words that go together."
    },
    ...
  }
  

Daha fazla bilgi için Biçimler: Yerel Ayara Özgü Mesajlar bölümünü inceleyin.

Ulusallaştırılan uzantıları çevirmek kolaydır. messages.json dosyasını kopyalayıp çevirir ve kopyayı /_locales altında yeni bir dizine yerleştirirsiniz. Örneğin, İspanyolca dilini desteklemek için messages.json dosyasının çevrilmiş bir kopyasını /_locales/es altına yerleştirmeniz yeterlidir. Aşağıdaki şekilde, önceki uzantının yeni İspanyolca çevirisi gösterilmektedir.

Önceden tanımlanmış mesajlar

Uluslararasılaştırma sistemi, yerelleştirme yapmanıza yardımcı olmak için önceden tanımlanmış birkaç mesaj sunar. Bunlar arasında @@ui_locale bulunur. Böylece mevcut kullanıcı arayüzü yerel ayarını algılayabilir ve metin yönünü algılamanıza olanak tanıyan birkaç @@bidi_... mesajı kullanabilirsiniz. İkinci gruptaki mesajlar, gadgets BIDI (çift yönlü) API'deki sabitlerle benzer adlara sahiptir.

Uzantı veya uygulama yerelleştirilmiş olsun ya da olmasın, özel mesaj @@extension_id CSS ve JavaScript dosyalarında kullanılabilir. Bu mesaj, manifest dosyalarında çalışmaz.

Aşağıdaki tabloda, her bir önceden tanımlanmış mesaj açıklanmaktadır.

Bir CSS dosyasında URL oluşturmak için @@extension_id kullanma örneğini aşağıda bulabilirsiniz:

body {
  background-image:url('chrome-extension://__MSG_@@extension_id__/background.png');
}

Uzantı kimliği abcdefghijklmnopqrstuvwxyzabcdef ise önceki kod snippet'indeki kalın çizgi şu şekilde değişir:

  background-image:url('chrome-extension://abcdefghijklmnopqrstuvwxyzabcdef/background.png');

Aşağıda, CSS dosyasında @@bidi_* mesajlarının kullanımına dair bir örnek verilmiştir:

body {
  direction: __MSG_@@bidi_dir__;
}

div#header {
  margin-bottom: 1.05em;
  overflow: hidden;
  padding-bottom: 1.5em;
  padding-__MSG_@@bidi_start_edge__: 0;
  padding-__MSG_@@bidi_end_edge__: 1.5em;
  position: relative;
}

İngilizce gibi soldan sağa okunan dillerde kalın çizgiler şu şekilde olur:

  dir: ltr;
  padding-left: 0;
  padding-right: 1.5em;

Yerel ayarlar

Tek bir çevirinin bir dilin birden fazla varyasyonunu (ör. en_GB ve en_US) desteklemesine olanak tanıyanlar (ör. en) da dahil olmak üzere birçok yerel ayar arasından seçim yapabilirsiniz.

Uzantınızı Chrome Web Mağazası'nın desteklediği herhangi bir yerel ayara göre yerelleştirebilirsiniz. Yerel ayarınız burada listelenmiyorsa en yakın alternatifi seçin. Örneğin, uzantınızın varsayılan yerel ayarı "de_CH" ise Chrome Web Mağazası'nda "de" seçeneğini belirleyin.

İleti ara

Desteklenen her yerel ayar için her dizeyi tanımlamanız gerekmez. Varsayılan yerel ayarın messages.json dosyasında her dize için bir değer olduğu sürece, çeviri ne kadar seyrek olursa olsun uzantınız veya uygulamanız çalışır. Uzantı sisteminin mesaj arama şekli aşağıda açıklanmıştır:

1. Kullanıcının tercih ettiği yerel ayar için mesaj dosyasını (varsa) arayın. Örneğin, Google Chrome'un yerel ayarı Birleşik Krallık İngilizcesi (en_GB) olarak ayarlandığında sistem önce /_locales/en_GB/messages.json içindeki mesajı arar. Bu dosya varsa ve mesaj da mevcutsa sistem başka bir dosya aramaz.
2. Kullanıcının tercih ettiği yerel ayarda bir bölge varsa (yani yerel ayarda alt çizgi varsa: _), bölge olmadan yerel ayarı arayın. Örneğin, en_GB mesaj dosyası yoksa veya mesajı içermiyorsa sistem en mesaj dosyasına bakar. Bu dosya varsa ve ileti orada bulunuyorsa sistem başka bir yere bakmaz.
3. Varsayılan yerel ayar için mesaj dosyasında arama yapın. Örneğin, uzantının "default_locale" değeri "es" olarak ayarlanmışsa ve ne /_locales/en_GB/messages.json ne de /_locales/en/messages.json mesajı içermiyorsa uzantı, /_locales/es/messages.json içindeki mesajı kullanır.

Aşağıdaki şekilde, "colores" adlı mesaj, uzantının desteklediği üç yerel ayarın tümünde yer alırken "extName" yalnızca ikisinde yer alıyor. ABD İngilizcesi'nde Google Chrome'u çalıştıran bir kullanıcı "Colors" etiketini görürken Birleşik Krallık İngilizcesi'ni kullanan bir kullanıcı "Colours" etiketini görür. ABD İngilizcesi ve Birleşik Krallık İngilizcesi kullanıcıları, uzantı adını "Hello World" olarak görür. Varsayılan dil İspanyolca olduğundan, Google Chrome'u İngilizce dışındaki bir dilde çalıştıran kullanıcılar "Colores" etiketini ve "Hola mundo" uzantı adını görür.

Tarayıcınızın yerel ayarını belirleme

Çevirileri test etmek için tarayıcınızın yerel ayarını belirlemeniz gerekebilir. Bu bölümde Windows, Mac OS, Linux ve ChromeOS'te yerel ayarların nasıl yapılacağı açıklanmaktadır.

Windows

Yerel ayarı, yerel ayara özgü bir kısayol veya Google Chrome kullanıcı arayüzünü kullanarak değiştirebilirsiniz. Kısayol yaklaşımı, ayarladıktan sonra daha hızlıdır ve aynı anda birden fazla dil kullanmanıza olanak tanır.

Yerel ayara özel bir kısayol kullanma

Google Chrome'u belirli bir yerel ayarla başlatan bir kısayol oluşturmak ve kullanmak için:

1. Masaüstünüzde bulunan Google Chrome kısayolunun bir kopyasını oluşturun.
2. Yeni kısayolu yeni yerel ayara uygun şekilde yeniden adlandırın.

3. Hedef alanında --lang ve --user-data-dir işaretleri belirtilecek şekilde kısayolun özelliklerini değiştirin. Hedef aşağıdaki gibi görünmelidir:

   path_to_chrome.exe --lang=locale --user-data-dir=c:\locale_profile_dir
   

4. Kısayolu çift tıklayarak Google Chrome'u başlatın.

Örneğin, Google Chrome'u İspanyolca (es) olarak başlatan bir kısayol oluşturmak için aşağıdaki hedefi içeren chrome-es adlı bir kısayol oluşturabilirsiniz:

path_to_chrome.exe --lang=es --user-data-dir=c:\chrome-profile-es

İstediğiniz kadar kısayol oluşturarak birden fazla dilde kolayca test yapabilirsiniz. Örneğin:

path_to_chrome.exe --lang=en --user-data-dir=c:\chrome-profile-en
path_to_chrome.exe --lang=en_GB --user-data-dir=c:\chrome-profile-en_GB
path_to_chrome.exe --lang=ko --user-data-dir=c:\chrome-profile-ko

Kullanıcı arayüzünü kullanma

Windows için Google Chrome'da kullanıcı arayüzünü kullanarak yerel ayarı değiştirme:

1. Uygulama simgesi > Seçenekler
2. Under the Hood (Kaputun Altında) sekmesini seçin.
3. Web İçeriği'ne gidin.
4. Yazı tipi ve dil ayarlarını değiştir'i tıklayın.
5. Diller sekmesini seçin.
6. Açılır listeyi kullanarak Google Chrome dilini ayarlayın.
7. Chrome'u yeniden başlatın.

Mac OS

Mac'te yerel ayarı değiştirmek için sistem tercihlerini kullanırsınız.

1. Apple menüsünden Sistem Tercihleri'ni seçin.
2. Kişisel bölümünde Uluslararası'yı seçin.
3. Dilinizi ve konumunuzu seçin
4. Chrome'u yeniden başlatın.

Linux

Linux'ta yerel ayarı değiştirmek için önce Google Chrome'dan çıkın. Ardından, LANGUAGE ortam değişkenini tek bir satırda ayarlayın ve Google Chrome'u başlatın. Örneğin:

LANGUAGE=es ./chrome

ChromeOS

ChromeOS'te yerel ayarı değiştirmek için:

1. Sistem tepsisinden Ayarlar'ı seçin.
2. Diller ve giriş bölümünde Dil açılır listesini seçin.
3. Diliniz listede yoksa Dil ekle'yi tıklayıp dili ekleyin.
4. Ekledikten sonra dilinizin yanındaki 3 noktalı Diğer işlemler menü öğesini tıklayın ve ChromeOS'i bu dilde görüntüle'yi seçin.
5. ChromeOS'i yeniden başlatmak için ayarlanan dilin yanında görünen Yeniden başlat düğmesini tıklayın.

Örnekler

Uluslararası hale getirme örneklerini examples/api/i18n dizininde bulabilirsiniz. Tam bir örnek için examples/extensions/news adresine bakın. Diğer örnekler ve kaynak kodu görüntüleme konusunda yardım için Örnekler bölümüne bakın.

getMessage()

Aşağıdaki kod, tarayıcıdan yerelleştirilmiş bir mesaj alır ve bunu dize olarak görüntüler. İletideki iki yer tutucuyu "string1" ve "string2" dizeleriyle değiştirir.

function getMessage() {
  var message = chrome.i18n.getMessage("click_here", ["string1", "string2"]);
  document.getElementById("languageSpan").innerHTML = message;
}

Tek bir dizeyi nasıl sağlayıp kullanacağınız aşağıda açıklanmıştır:

  // In JavaScript code
  status.innerText = chrome.i18n.getMessage("error", errorDetails);

"error": {
  "message": "Error: $details$",
  "description": "Generic error template. Expects error parameter to be passed in.",
  "placeholders": {
    "details": {
      "content": "$1",
      "example": "Failed to fetch RSS feed."
    }
  }
}

Yer tutucular hakkında daha fazla bilgi için Yerel Ayara Özel Mesajlar sayfasına bakın. getMessage() işlevini çağırma hakkında ayrıntılı bilgi için API referansı bölümüne bakın.

getAcceptLanguages()

Aşağıdaki kod, tarayıcıdan kabul edilen dilleri alır ve her bir kabul edilen dili "," ile ayırarak bunları dize olarak görüntüler.

function getAcceptLanguages() {
  chrome.i18n.getAcceptLanguages(function(languageList) {
    var languages = languageList.join(",");
    document.getElementById("languageSpan").innerHTML = languages;
  })
}

getAcceptLanguages() işlevini çağırma hakkında ayrıntılı bilgi için API referansına bakın.

detectLanguage()

Aşağıdaki kod, verilen dizedeki en fazla 3 dili algılar ve sonucu yeni satırlarla ayrılmış dizeler olarak gösterir.

function detectLanguage(inputText) {
  chrome.i18n.detectLanguage(inputText, function(result) {
    var outputLang = "Detected Language: ";
    var outputPercent = "Language Percentage: ";
    for(i = 0; i < result.languages.length; i++) {
      outputLang += result.languages[i].language + " ";
      outputPercent +=result.languages[i].percentage + " ";
    }
    document.getElementById("languageSpan").innerHTML = outputLang + "\n" + outputPercent + "\nReliable: " + result.isReliable;
  });
}

detectLanguage(inputText) işlevini çağırma hakkında daha fazla bilgi için API referansına bakın.

chrome.i18n.detectLanguage(
  text: string,
): Promise<object>

chrome.i18n.getAcceptLanguages(): Promise<LanguageCode[]>

chrome.i18n.getMessage(
  messageName: string,
  substitutions?: any,
  options?: object,
): string

chrome.i18n.getUILanguage(): string