chrome.i18n

ब्यौरा

मेनिफ़ेस्ट

अगर किसी एक्सटेंशन में /_locales डायरेक्ट्री है, तो मेनिफ़ेस्ट को "default_locale" तय करना होगा.

कॉन्सेप्ट और इस्तेमाल करने का तरीका

आपको उपयोगकर्ता को दिखने वाली सभी स्ट्रिंग को messages.json नाम की फ़ाइल में डालना होगा. हर बार जब कोई नई स्थान-भाषा जोड़ी जाती है, तब /_locales/_localeCode_ नाम की डायरेक्ट्री में एक मैसेज फ़ाइल जोड़ी जाती है. यहां localeCode एक कोड होता है. जैसे, अंग्रेज़ी के लिए en.

यहां अंतरराष्ट्रीय स्तर पर उपलब्ध एक्सटेंशन के लिए फ़ाइल हैरारकी दी गई है. यह एक्सटेंशन अंग्रेज़ी (en), स्पैनिश (es), और कोरियन (ko) भाषाओं में काम करता है:

कई भाषाओं में उपलब्ध है

मान लें कि आपके पास एक एक्सटेंशन है, जिसमें यहां दी गई फ़ाइलें हैं:

इस एक्सटेंशन को अंतरराष्ट्रीय स्तर पर उपलब्ध कराने के लिए, उपयोगकर्ता को दिखने वाली हर स्ट्रिंग का नाम दें और उसे messages फ़ाइल में डालें. एक्सटेंशन का मेनिफ़ेस्ट, सीएसएस फ़ाइलें, और JavaScript कोड, हर स्ट्रिंग के नाम का इस्तेमाल करके उसके स्थानीय भाषा में अनुवाद किए गए वर्शन को पाते हैं.

यहां बताया गया है कि अंतरराष्ट्रीय स्तर पर उपलब्ध होने पर एक्सटेंशन कैसा दिखता है. ध्यान दें कि इसमें अब भी सिर्फ़ अंग्रेज़ी स्ट्रिंग हैं:

अंतरराष्ट्रीय स्तर पर उपलब्ध कराने के बारे में कुछ ज़रूरी बातें:

• इन भाषाओं में से किसी का भी इस्तेमाल किया जा सकता है. अगर इस्तेमाल की जा रही भाषा काम नहीं करती है, तो Google Chrome उसे अनदेखा कर देता है.

• manifest.json और सीएसएस फ़ाइलों में, messagename नाम की स्ट्रिंग को इस तरह से रेफ़र करें:

  __MSG_messagename__
  

• अपने एक्सटेंशन या ऐप्लिकेशन के JavaScript कोड में, messagename नाम की स्ट्रिंग को इस तरह से रेफ़र करें:

  chrome.i18n.getMessage("messagename")
  

• getMessage() को किए गए हर कॉल में, मैसेज में शामिल करने के लिए ज़्यादा से ज़्यादा नौ स्ट्रिंग दी जा सकती हैं. ज़्यादा जानकारी के लिए, उदाहरण: getMessage देखें.

• कुछ मैसेज, जैसे कि @@bidi_dir और @@ui_locale, इंटरनैशनलाइज़ेशन सिस्टम उपलब्ध कराता है. पहले से तय किए गए मैसेज के नामों की पूरी सूची देखने के लिए, पहले से तय किए गए मैसेज सेक्शन देखें.

• messages.json में, उपयोगकर्ताओं को दिखने वाली हर स्ट्रिंग का एक नाम होता है. साथ ही, इसमें एक "message" आइटम और एक "description" आइटम होता है. "description" आइटम को शामिल करना ज़रूरी नहीं है. नाम एक कुंजी होता है, जैसे कि "extName" या "search_string", जो स्ट्रिंग की पहचान करता है. "message" में, इस स्थान-भाषा में स्ट्रिंग की वैल्यू दी जाती है. "ब्यौरा" फ़ील्ड में दी गई जानकारी, अनुवादकों के लिए मददगार होती है. ऐसा इसलिए, क्योंकि वे यह नहीं देख पाते कि आपके एक्सटेंशन में स्ट्रिंग का इस्तेमाल कैसे किया गया है. उदाहरण के लिए:

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

ज़्यादा जानकारी के लिए, फ़ॉर्मैट: स्थानीय भाषा के हिसाब से मैसेज लेख पढ़ें.

एक्सटेंशन को अंतरराष्ट्रीय स्तर पर उपलब्ध कराने के बाद, उसका अनुवाद करना आसान होता है. messages.json को कॉपी करें, उसका अनुवाद करें, और कॉपी को /_locales में मौजूद नई डायरेक्ट्री में डालें. उदाहरण के लिए, स्पैनिश भाषा में सहायता देने के लिए, /_locales/es में messages.json का अनुवाद किया गया वर्शन डालें. नीचे दिए गए चित्र में, स्पैनिश में अनुवाद किए गए नए वर्शन के साथ पिछला एक्सटेंशन दिखाया गया है.

पहले से तय किए गए मैसेज

इंटरनैशनलाइज़ेशन सिस्टम, स्थानीय भाषा में उपलब्ध कराने के लिए कुछ पहले से तय किए गए मैसेज उपलब्ध कराता है. इनमें @@ui_locale शामिल हैं. इनकी मदद से, यूज़र इंटरफ़ेस (यूआई) की मौजूदा स्थान-भाषा का पता लगाया जा सकता है. साथ ही, कुछ @@bidi_... मैसेज की मदद से, टेक्स्ट की दिशा का पता लगाया जा सकता है. बाद के मैसेज के नाम, गैजेट के लिए BIDI (दोनों दिशाओं में काम करने वाला) API में मौजूद कॉन्स्टेंट के नाम से मिलते-जुलते हैं.

खास मैसेज @@extension_id का इस्तेमाल सीएसएस और JavaScript फ़ाइलों में किया जा सकता है. इससे कोई फ़र्क़ नहीं पड़ता कि एक्सटेंशन या ऐप्लिकेशन स्थानीय भाषा में उपलब्ध है या नहीं. यह मैसेज, मेनिफ़ेस्ट फ़ाइलों में काम नहीं करता.

यहां दी गई टेबल में, पहले से तय किए गए हर मैसेज के बारे में बताया गया है.

यहां सीएसएस फ़ाइल में @@extension_id का इस्तेमाल करके, यूआरएल बनाने का एक उदाहरण दिया गया है:

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

अगर एक्सटेंशन आईडी abcdefghijklmnopqrstuvwxyzabcdef है, तो पिछले कोड स्निपेट में बोल्ड की गई लाइन यह बन जाती है:

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

यहां सीएसएस फ़ाइल में @@bidi_* मैसेज इस्तेमाल करने का एक उदाहरण दिया गया है:

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;
}

अंग्रेज़ी जैसी बाईं से दाईं ओर लिखी जाने वाली भाषाओं के लिए, बोल्ड लाइनें इस तरह दिखेंगी:

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

Locales

आपके पास कई स्थानीय भाषाएँ चुनने का विकल्प होता है. इनमें से कुछ (जैसे कि en) ऐसी होती हैं जिनमें एक ही अनुवाद को किसी भाषा के कई वर्शन (जैसे कि en_GB और en_US) के लिए इस्तेमाल किया जा सकता है.

अपने एक्सटेंशन को Chrome Web Store पर उपलब्ध किसी भी भाषा में बदला जा सकता है. अगर आपकी भाषा यहां नहीं दी गई है, तो सबसे मिलता-जुलता विकल्प चुनें. उदाहरण के लिए, अगर आपके एक्सटेंशन की डिफ़ॉल्ट स्थान-भाषा "de_CH" है, तो Chrome Web Store में "de" चुनें.

संदेश खोजें

यह ज़रूरी नहीं है कि हर स्ट्रिंग को हर उस स्थान-भाषा के लिए तय किया जाए जिसमें ऐप्लिकेशन काम करता है. जब तक डिफ़ॉल्ट स्थान-भाषा की messages.json फ़ाइल में हर स्ट्रिंग के लिए कोई वैल्यू मौजूद है, तब तक आपका एक्सटेंशन या ऐप्लिकेशन काम करेगा. भले ही, अनुवाद कितना भी कम हो. एक्सटेंशन सिस्टम, मैसेज को इस तरह खोजता है:

1. उपयोगकर्ता की पसंदीदा स्थान-भाषा के लिए, मैसेज फ़ाइल (अगर कोई हो) खोजें. उदाहरण के लिए, जब Google Chrome का स्थान-भाषा (लोकल) ब्रिटिश अंग्रेज़ी (en_GB) पर सेट होती है, तो सिस्टम सबसे पहले /_locales/en_GB/messages.json में मैसेज ढूंढता है. अगर वह फ़ाइल मौजूद है और उसमें मैसेज है, तो सिस्टम आगे की जांच नहीं करता.
2. अगर उपयोगकर्ता की पसंदीदा भाषा में कोई क्षेत्र शामिल है (यानी कि भाषा में अंडरस्कोर है: _), तो उस क्षेत्र के बिना भाषा खोजें. उदाहरण के लिए, अगर en_GB मैसेज फ़ाइल मौजूद नहीं है या उसमें मैसेज नहीं है, तो सिस्टम en मैसेज फ़ाइल में देखता है. अगर वह फ़ाइल मौजूद है और उसमें मैसेज है, तो सिस्टम आगे की जांच नहीं करता.
3. डिफ़ॉल्ट स्थान-भाषा के लिए, मैसेज फ़ाइल खोजें. उदाहरण के लिए, अगर एक्सटेंशन की "default_locale" को "es" पर सेट किया गया है और न तो /_locales/en_GB/messages.json और न ही /_locales/en/messages.json में मैसेज मौजूद है, तो एक्सटेंशन /_locales/es/messages.json से मैसेज का इस्तेमाल करेगा.

नीचे दिए गए डायग्राम में, "colores" नाम का मैसेज उन सभी तीन भाषाओं में है जिनमें एक्सटेंशन काम करता है. हालांकि, "extName" सिर्फ़ दो भाषाओं में है. अमेरिका में अंग्रेज़ी भाषा में Google Chrome का इस्तेमाल करने वाले व्यक्ति को जहां "Colors" लेबल दिखता है वहीं ब्रिटिश अंग्रेज़ी का इस्तेमाल करने वाले व्यक्ति को "Colours" लेबल दिखता है. अमेरिका में अंग्रेज़ी और ब्रिटेन में अंग्रेज़ी भाषा का इस्तेमाल करने वाले लोगों को एक्सटेंशन का नाम "Hello World" दिखता है. डिफ़ॉल्ट भाषा स्पैनिश होने की वजह से, Google Chrome को अंग्रेज़ी के अलावा किसी अन्य भाषा में इस्तेमाल करने वाले लोगों को "Colores" लेबल और "Hola mundo" एक्सटेंशन का नाम दिखता है.

अपने ब्राउज़र की स्थान-भाषा सेट करना

अनुवादों को टेस्ट करने के लिए, अपने ब्राउज़र का स्थान-भाषा सेट करें. इस सेक्शन में, आपको Windows, macOS, Linux, और ChromeOS में स्थान-भाषा सेट करने का तरीका बताया गया है.

Windows

भाषा बदलने के लिए, भाषा के हिसाब से शॉर्टकट या Google Chrome के यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल किया जा सकता है. इसे सेट अप करने के बाद, शॉर्टकट का इस्तेमाल करना ज़्यादा आसान होता है. इससे एक साथ कई भाषाओं का इस्तेमाल किया जा सकता है.

जगह और भाषा के हिसाब से शॉर्टकट का इस्तेमाल करना

किसी खास स्थान-भाषा में Google Chrome लॉन्च करने वाले शॉर्टकट को बनाने और उसका इस्तेमाल करने के लिए:

1. अपने डेस्कटॉप पर मौजूद Google Chrome के शॉर्टकट की कॉपी बनाएं.
2. नए शॉर्टकट का नाम बदलकर, नई स्थान-भाषा के हिसाब से रखें.

3. शॉर्टकट की प्रॉपर्टी बदलें, ताकि टारगेट फ़ील्ड में --lang और --user-data-dir फ़्लैग दिखें. टारगेट कुछ ऐसा दिखना चाहिए:

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

4. शॉर्टकट पर दो बार क्लिक करके, Google Chrome लॉन्च करें.

उदाहरण के लिए, अगर आपको स्पैनिश (es) में Google Chrome लॉन्च करने वाला शॉर्टकट बनाना है, तो आपको chrome-es नाम का शॉर्टकट बनाना होगा. इसका टारगेट यह होगा:

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

अपनी पसंद के मुताबिक जितने चाहें उतने शॉर्टकट बनाए जा सकते हैं. इससे, कई भाषाओं में टेस्ट करना आसान हो जाता है. उदाहरण के लिए:

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

यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करना

Windows के लिए Google Chrome पर यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, स्थान-भाषा बदलने का तरीका यहां बताया गया है:

1. ऐप्लिकेशन का आइकॉन > विकल्प
2. Under the Hood टैब चुनें
3. स्क्रोल करके, वेब कॉन्टेंट पर जाएं
4. फ़ॉन्ट और भाषा की सेटिंग बदलें पर क्लिक करें
5. भाषाएं टैब चुनें
6. ड्रॉप-डाउन का इस्तेमाल करके, Google Chrome की भाषा सेट करें
7. Chrome को रीस्टार्ट करें

Mac OS

Mac पर स्थान-भाषा बदलने के लिए, सिस्टम की सेटिंग का इस्तेमाल करें.

1. Apple मेन्यू में जाकर, System Preferences चुनें
2. निजी सेक्शन में जाकर, अंतरराष्ट्रीय को चुनें
3. अपनी भाषा और जगह की जानकारी चुनें
4. Chrome को रीस्टार्ट करें

Linux

Linux पर स्थान-भाषा बदलने के लिए, पहले Google Chrome बंद करें. इसके बाद, एक ही लाइन में LANGUAGE एनवायरमेंट वैरिएबल सेट करें और Google Chrome लॉन्च करें. उदाहरण के लिए:

LANGUAGE=es ./chrome

ChromeOS

ChromeOS पर स्थान-भाषा बदलने के लिए:

1. सिस्टम ट्रे में जाकर, सेटिंग को चुनें.
2. भाषाएं और इनपुट सेक्शन में जाकर, भाषा ड्रॉप-डाउन चुनें.
3. अगर आपकी भाषा सूची में मौजूद नहीं है, तो भाषाएं जोड़ें पर क्लिक करके उसे जोड़ें.
4. भाषा जोड़ने के बाद, अपनी भाषा के बगल में मौजूद तीन बिंदु वाले ज़्यादा कार्रवाइयां मेन्यू आइटम पर क्लिक करें. इसके बाद, ChromeOS को इस भाषा में दिखाएं को चुनें.
5. ChromeOS को फिर से चालू करने के लिए, सेट की गई भाषा के बगल में मौजूद फिर से चालू करें बटन पर क्लिक करें.

उदाहरण

examples/api/i18n डायरेक्ट्री में, अंतरराष्ट्रीय स्तर पर उपलब्ध कराने के उदाहरण देखे जा सकते हैं. पूरे उदाहरण के लिए, examples/extensions/news देखें. अन्य उदाहरणों और सोर्स कोड देखने में मदद पाने के लिए, सैंपल देखें.

getMessage()

नीचे दिया गया कोड, ब्राउज़र से स्थानीय भाषा में मैसेज पाता है और उसे स्ट्रिंग के तौर पर दिखाता है. यह मैसेज में मौजूद दो प्लेसहोल्डर को "string1" और "string2" स्ट्रिंग से बदलता है.

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

यहां एक स्ट्रिंग देने और उसका इस्तेमाल करने का तरीका बताया गया है:

  // 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."
    }
  }
}

प्लेसहोल्डर के बारे में ज़्यादा जानने के लिए, स्थानीय भाषा के हिसाब से मैसेज पेज देखें. getMessage() को कॉल करने के बारे में ज़्यादा जानकारी के लिए, एपीआई का संदर्भ देखें.

getAcceptLanguages()

यहां दिया गया कोड, ब्राउज़र से accept-languages को हासिल करता है और उन्हें स्ट्रिंग के तौर पर दिखाता है. इसके लिए, हर accept-language को ',' से अलग किया जाता है.

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

getAcceptLanguages() को कॉल करने के बारे में जानकारी के लिए, एपीआई का संदर्भ देखें.

detectLanguage()

नीचे दिया गया कोड, दी गई स्ट्रिंग में से ज़्यादा से ज़्यादा तीन भाषाओं का पता लगाता है. साथ ही, नतीजे को नई लाइनों से अलग की गई स्ट्रिंग के तौर पर दिखाता है.

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) को कॉल करने के बारे में ज़्यादा जानकारी के लिए, एपीआई का संदर्भ देखें.

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