chrome.i18n

refresh date: 2026-09-25 robots: noindex

ब्यौरा

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

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

एक से ज़्यादा भाषाओं में सहायता देने का तरीका

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

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

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

<img "__msg_extname__",="" "default_locale"="" "en".="" "extname"."="" "hello="" _locales="" a="" alt="In the manifest.json file, " and="" been="" changed="" chrome.i18n.getmessage("extname").="" defines="" en="" file="" file,="" has="" hello="" in="" item="" javascript="" messages.json="" named="" new="" src="/static/images/i18n-after-1.gif" the="" to="" value="" world"="" />

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

• इन भाषाओं में से किसी का भी इस्तेमाल किया जा सकता है. अगर ऐसी जगह के लिए भाषा सेट की जाती है जहां यह सुविधा काम नहीं करती, तो 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" में, इस स्थान-भाषा में स्ट्रिंग की वैल्यू दी जाती है. वैकल्पिक "description" पैरामीटर, अनुवादकों की मदद करता है. ऐसा इसलिए, क्योंकि वे यह नहीं देख पाते कि आपके एक्सटेंशन में स्ट्रिंग का इस्तेमाल कैसे किया गया है. उदाहरण के लिए:

  {
    "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_... मैसेज की मदद से, टेक्स्ट की दिशा का पता लगाया जा सकता है. बाद के मैसेज के नाम, gadgets BIDI (bi-directional) 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 में उपलब्ध किसी भी भाषा का इस्तेमाल किया जा सकता है.

संदेश खोजना

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

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

उदाहरण के लिए, अगर आपको स्पैनिश (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 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."
    }
  }
}

प्लेसहोल्डर के बारे में ज़्यादा जानकारी के लिए, भाषा के हिसाब से मैसेज पेज देखें. 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,
  callback?: function,
): Promise<object>

chrome.i18n.getAcceptLanguages(
  callback?: function,
): Promise<LanguageCode[]>

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

chrome.i18n.getUILanguage(): string