chrome.i18n

ब्यौरा

मेनिफ़ेस्ट

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

सिद्धांत और इस्तेमाल

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

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

कई भाषाओं में काम करता है

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

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

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

>

अंतरराष्ट्रीय स्तर पर किए जाने वाले बदलावों के बारे में कुछ ज़रूरी बातें:

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

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

  __MSG_messagename__
  

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

  chrome.i18n.getMessage("messagename")
  

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

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

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

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

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

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

पहले से तय मैसेज

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

खास मैसेज @@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;

स्थान-भाषा

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

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

मैसेज खोजना

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

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

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

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

अनुवाद की जांच करने के लिए, आपको अपने ब्राउज़र की स्थान-भाषा सेट करनी पड़ सकती है. इस सेक्शन में, Windows, Mac OS X, 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 लॉन्च करें.

उदाहरण के लिए, Google Chrome को स्पैनिश (es) में लॉन्च करने वाला शॉर्टकट बनाने के लिए, 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. हुड के तहत टैब चुनें
3. नीचे की ओर स्क्रोल करके, वेब कॉन्टेंट पर जाएं
4. फ़ॉन्ट और भाषा की सेटिंग बदलें पर क्लिक करें
5. भाषाएं टैब चुनें
6. Google Chrome की भाषा सेट करने के लिए, ड्रॉप-डाउन का इस्तेमाल करें
7. Chrome को रीस्टार्ट करें

Mac OS X

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

प्लेसहोल्डर के बारे में ज़्यादा जानकारी के लिए, Locale-specific Messages पेज देखें. getMessage() को कॉल करने के बारे में जानकारी पाने के लिए, एपीआई का रेफ़रंस देखें.

getAcceptLanguages()

नीचे दिए गए कोड को ब्राउज़र से स्वीकार की गई भाषाएं मिलती हैं और स्वीकार की जाने वाली हर भाषा को ',' से अलग करके उन्हें एक स्ट्रिंग के रूप में दिखाया जाता है.

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,
  callback?: function,
)

chrome.i18n.getAcceptLanguages(
  callback?: function,
)

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

chrome.i18n.getUILanguage()