इंटरनैशनलाइजेशन (i18n) रीराइट को कॉन्फ़िगर करें

अलग-अलग तरह का कॉन्टेंट दिखाने के लिए, अंतरराष्ट्रीय मानकों के मुताबिक लिखे गए जवाबों ("i18n रीराइट") का इस्तेमाल करना उपयोगकर्ता के देश या पसंदीदा भाषा के आधार पर. यहां कुछ उदाहरण दिए गए हैं कॉन्फ़िगरेशन की जानकारी है, जिसे आप सेट अप कर सकते हैं:

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

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

• कनाडा के सभी उपयोगकर्ताओं को एक जैसा कॉन्टेंट उपलब्ध कराना पसंदीदा भाषा चुनें).
  अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है उदाहरण: आपकी साइट के लिए "डिफ़ॉल्ट" सेटिंग वाला होम पेज लेकिन एक पासवर्ड के साथ कनाडा के लिए खास सुविधा (जैसे कि हॉलिडे थीम)

• कनाडा में रहने वाले उन लोगों को फ़्रेंच कॉन्टेंट दिखाना जो फ़्रेंच भाषा पसंद करते हैं.
  अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है उदाहरण: ऐसा होम पेज जिसमें कनाडा के हिसाब से फ़्रेंच वाक्यांश का इस्तेमाल किया गया हो और कनाडा से जुड़ा हो सुविधा (जैसे छुट्टी की थीम)

Firebase होस्टिंग की मदद से, उपयोगकर्ता के आईपी पते की मदद से उसके देश का पता लगाया जाता है. साथ ही, Accept-Language अनुरोध हेडर से उपयोगकर्ता की भाषा की प्राथमिकताएं (आम तौर पर) अपने वेब ब्राउज़र से अपने-आप सेट हो जाता है).

i18n रीराइट सेट अप करें

अपनी होस्टिंग साइट के लिए i18n रीराइट सेट अप करने के लिए आपको एक "i18n कॉन्टेंट" डायरेक्ट्री का इस्तेमाल करें. इसके बाद, i18n एट्रिब्यूट जोड़ें अपनी firebase.json फ़ाइल में जोड़ें, ताकि आपको नए "i18n कॉन्टेंट" पर ले जाया जा सके डायरेक्ट्री.

यहां सिलसिलेवार तरीके से बताया गया है:

1. अपनी लोकल ऐप्लिकेशन डायरेक्ट्री के public फ़ोल्डर में, एक अलग डायरेक्ट्री बनाएं जोड़ें, और फिर हर भाषा के लिए सब-फ़ोल्डर बनाएं और अलग-अलग देशों के लिए एक साथ उपलब्ध नहीं है.

   हर सब-फ़ोल्डर में, उस कॉम्बिनेशन के लिए खास कॉन्टेंट जोड़ें, जैसे छुट्टियों की थीम वाले होम पेज या किसी खास भाषा में 404 कोड वाले पेज.

   यहां "i18n कॉन्टेंट" का उदाहरण दिया गया है localized-files नाम की डायरेक्ट्री:

   public/
       index.html  // your site's default homepage
       404.html  // your site's custom 404 page
   
       localized-files/
           ALL_ca/
               index.html
           es_ALL/
               index.html
               404.html
           fr/
               index.html
               404.html
           fr_ca/
               index.html
   

   हर सब-फ़ोल्डर के कॉन्टेंट से मेल खाने वाले अनुरोध देखें

   public/
       // matches requests that aren't specified by your "i18n content" subfolders
       // example: display your homepage in the "default" language for your site with no country-specific features
       index.html  // your site's default homepage
       404.html  // your site's custom 404 page
   
       localized-files/
   
           // matches requests from Canada with any language preference
           // example: display your homepage in the "default" language for your site with a Canada-specific feature
           ALL_ca/
               index.html
   
           // matches requests from any country with a language preference of `es` or `es-foo`
           // example: display your homepage in Spanish with no country-specific features
           es_ALL/
               index.html
               404.html  // your site's custom 404 page in Spanish
   
           // matches requests from any country with a language preference of `fr` or `fr-foo`
           // example: display your homepage in Standard French with no country-specific features
           fr/
               index.html
               404.html  // your site's custom 404 page in French
   
           // matches requests from Canada with a language preference of `fr` or `fr-foo`
           // example: display your homepage in Canadian French and/or with a Canada-specific feature
           fr_ca/
               index.html
   
   

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

   • languageCode_countryCode: इसमें उपयोगकर्ताओं के हिसाब से कॉन्टेंट शामिल है जिनके पास भाषा की प्राथमिकता और देश का कोड है

   • languageCode: इसमें उन उपयोगकर्ताओं के लिए खास कॉन्टेंट शामिल होता है जिनके पास वह होता है भाषा प्राथमिकता, लेकिन सामग्री देश-विशिष्ट नहीं है; बुनियादी तौर पर languageCode_ALL के बराबर

   सब-सेक्शन देखें देश और भाषा के कोड नीचे दिए गए हैं देखें. ALL की वैल्यू का इस्तेमाल किया जा सकता है किसी भी देश (जैसे es_ALL/) या किसी देश के बारे में बताने के लिए (केस-सेंसिटिव) भाषा (जैसे ALL_ca/).

   सब-फ़ोल्डर की फ़ाइलों के लिए, public में मिलती-जुलती फ़ाइलें होना ज़रूरी नहीं है डायरेक्ट्री या अन्य सब-फ़ोल्डर का इस्तेमाल करें. आपके पास ऐसा कॉन्टेंट बनाने का विकल्प है जो ख़ास भाषा और/या देश के लिए.

   ध्यान दें: समीक्षा करें "i18n कॉन्टेंट" के लिए प्राथमिकता क्रम नीचे दिया गया है यह पता लगाने के लिए कि होस्टिंग की सेवा आपके "i18n कॉन्टेंट" को किस क्रम में दिखाती है फ़ाइलें शामिल हैं.

2. अपनी firebase.json फ़ाइल में i18n एट्रिब्यूट जोड़ें और जिसमें आपका "i18n कॉन्टेंट" शामिल है. अपने उदाहरण को आगे देखें:

   // firebase.json
   
   "hosting": {
   
     "public": "public",
   
     "ignore": [
       "firebase.json",
       "**/.*",
       "**/node_modules/**"
     ],
   
     "i18n": {
       "root": "/localized-files"  // directory that contains your "i18n content"
     }
   
     ...
   }
   

   root के लिए तय की गई डायरेक्ट्री, उस डायरेक्ट्री का नाम होनी चाहिए आपकी सभी "i18n सामग्री" शामिल है सबफ़ोल्डर में. अगर आपने सभी "i18n कॉन्टेंट" सब-फ़ोल्डर के लिए, जो आपकी public डायरेक्ट्री के रूट में मौजूद है, / का इस्तेमाल करें root के मान के लिए. root वैल्यू में आगे और पीछे स्लैश वैकल्पिक हैं.

3. अपना "i18n कॉन्टेंट" डिप्लॉय करें और अपनी होस्टिंग साइट से कॉन्फ़िगर करें.

कुकी ओवरराइड का इस्तेमाल करके अपने सेटअप की जांच की जा सकती है.

देश और भाषा कोड

"i18n content" का नाम रखते समय सबफ़ोल्डर के लिए, आपको दोनों देशों के लिए लोअरकेस का उपयोग करना होगा और भाषा कोड शामिल हैं. यह बताने के लिए कि आप ALL वैल्यू (केस-सेंसिटिव) का इस्तेमाल कर सकते हैं कोई देश (जैसे es_ALL/) या कोई भी भाषा (जैसे ALL_ca/).

होस्टिंग को उपयोगकर्ता के आईपी पते से देश का कोड मिलता है. देश कोड अंग्रेज़ी के छोटे अक्षरों का इस्तेमाल करके ISO 3166-1 alpha-2 कोड.

भाषा के कोड, उपयोगकर्ता के Accept-Language अनुरोध हेडर से मिलते हैं (आम तौर पर अपने वेब ब्राउज़र से अपने-आप सेट हो जाता है). ये ISO 639-1 कोड हैं. भाषा कोड का इस्तेमाल करते समय इन बातों का ध्यान रखें:

• होस्ट करने की वजह से जब "i18n content" खोजा जाता है करने के लिए, यह Accept-Language हेडर में क्वालिटी वैल्यू के आधार पर भाषाएं चुनी गई हैं.

• होस्टिंग की मदद से, Accept-Language में किसी भी इलाके और देश के सबटैग को लॉन्च कर दिया जाता है हेडर है, इसलिए "i18n कॉन्टेंट" में भाषा कोड सब-फ़ोल्डर का नाम नहीं जोड़ा जा सकता इनमें ये सब-टैग शामिल होने चाहिए. उदाहरण के लिए, आप es-419 या es-US का इस्तेमाल भाषा कोड को सब-फ़ोल्डर के नाम में रखें, लेकिन आप es का इस्तेमाल कर सकते हैं.

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

  किसी खास इलाके या देश के हिसाब से कॉन्टेंट दिखाने के लिए, उदाहरण देखें

  स्पेन बनाम स्पेन में लागू होने वाला कॉन्टेंट दिखाना कोई दूसरा देश (es-419 के व्यवहार की नकल करने वाला)

  इस उदाहरण में, की भाषा प्राथमिकता के साथ स्पेन से अनुरोध es, es-es या यहां तक कि es-419 को भी es_es/ से कॉन्टेंट मिलेगा सबफ़ोल्डर में है, क्योंकि होस्टिंग उन सभी भाषा कोड को es मानती है.

  संयुक्त राज्य अमेरिका, मेक्सिको या किसी अन्य देश से es-419 की भाषा प्राथमिकता es_ALL/ से सामग्री मिलेगी सबफ़ोल्डर में है, क्योंकि होस्टिंग की सेवा es-419 को es मानती है.

  public/
      // matches requests that aren't specified by your "i18n content" subfolders
      index.html  // the site's default homepage
  
      localized-files/
  
          // matches requests from Spain with a language preference of `es` or `es-foo`
          es_es/
              index.html
  
          // matches requests from any other country with a language preference of `es` or `es-foo`
          es_ALL/
              index.html
  

  इसके लिए लागू स्पैनिश कॉन्टेंट दिखाना खास देश

  इस उदाहरण में, की भाषा प्राथमिकता के साथ मेक्सिको से किया गया अनुरोध es-419 को es_mx/ सब-फ़ोल्डर से कॉन्टेंट मिलेगा, क्योंकि होस्टिंग भाषा कोड es-419 को es मानती है.

  हालांकि, संयुक्त राज्य अमेरिका से इस भाषा की प्राथमिकता के साथ अनुरोध es-419 को es_ALL/ सब-फ़ोल्डर से कॉन्टेंट मिलेगा, क्योंकि होस्ट करने वाली सेवा, es-419 को es मानती है और इसमें कोई es_us/ सब-फ़ोल्डर नहीं है.

  public/
      // matches requests that aren't specified by your "i18n content" subfolders
      index.html  // the site's default homepage
  
      localized-files/
  
          // matches requests from Argentina with a language preference of `es` or `es-foo` (mimics behavior of `es-ar` header tag)
          es_ar/
              index.html
  
          // matches requests from Spain with a language preference of `es` or `es-foo` (mimics behavior of `es-es` header tag)
          es_es/
              index.html
  
          // matches requests from Mexico with a language preference of `es` or `es-foo` (mimics behavior of `es-mx` header tag)
          es_mx/
              index.html
  
          // matches requests from any other country with a language preference of `es` or `es-foo` (mimics behavior of `es-419` header tag)
          es_ALL/
              index.html
  

"i18n सामग्री" के लिए प्राथमिकता क्रम

अगर आपने i18n रीराइट सेट अप किए हैं, तो होस्टिंग सेवा इन शर्तों के हिसाब से कॉन्टेंट दिखाती है प्राथमिकता क्रम:

1. रिज़र्व किए गए ऐसे नेमस्पेस जो /__/* पाथ सेगमेंट से शुरू होते हैं

2. कॉन्फ़िगर किए गए रीडायरेक्ट

3. एग्ज़ैक्ट मैच वाला स्टैटिक कॉन्टेंट

   1. भाषा का कोड + देश का कोड (उदाहरण के लिए, fr_ca/ से कॉन्टेंट)
      यह क्रम, अनुरोध की हर भाषा के क्वालिटी की वैल्यू के मुताबिक होता है Accept-Language हेडर.

   2. सिर्फ़ देश का कोड (उदाहरण के लिए, ALL_ca/ से कॉन्टेंट)

   3. सिर्फ़ भाषा का कोड (उदाहरण के लिए, fr/ या es_ALL/ का कॉन्टेंट)
      यह क्रम, अनुरोध की हर भाषा के क्वालिटी की वैल्यू के मुताबिक होता है Accept-Language हेडर.

   4. "डिफ़ॉल्ट" एग्ज़ैक्ट मैच वाला स्टैटिक कॉन्टेंट
      यह ऐसा कॉन्टेंट है जो "i18n कॉन्टेंट" में नहीं है डायरेक्ट्री, जैसे कि public डायरेक्ट्री का रूट डालें.

4. फिर से लिखने के लिए कॉन्फ़िगर किया गया

5. 404 कोड वाली सेटिंग

   1. i18n 404 पेज
      यह पूरी तरह मिलान के लिए ऊपर दिए गए प्राथमिकता के क्रम का पालन करता है स्टैटिक कॉन्टेंट.

   2. कस्टम 404 पेज

   3. डिफ़ॉल्ट 404 पेज (Firebase से मिला)

प्रायॉरिटी ऑर्डर का उदाहरण

चलिए, ऊपर दिए गए उदाहरण को देखते हैं. हम उदाहरण के तौर पर उसी डायरेक्ट्री का इस्तेमाल करेंगे और अनुरोध का उदाहरण.

• "i18n कॉन्टेंट" वाली लोकल प्रोजेक्ट डायरेक्ट्री का उदाहरण डायरेक्ट्री (जिसे localized-files कहा जाता है)

  public/
      index.html  // your site's default homepage
      404.html  // your site's custom 404 page
  
      localized-files/
          ALL_ca/
              index.html
          es_ALL/
              index.html
              404.html
          fr/
              index.html
              404.html
          fr_ca/
              index.html
  

• अनुरोध की जानकारी का उदाहरण

  • भाषा के कोड: fr, en (फ़्रेंच और फिर अंग्रेज़ी)
    भाषा कोड को क्वालिटी वैल्यू के हिसाब से क्रम में लगाया जाता है Accept-Language हेडर.

  • देश का कोड: ca (कनाडा)

एग्ज़ैक्ट मैच के प्राथमिकता ऑर्डर और भाषा की प्राथमिकताएं, होस्टिंग की मदद से अनुरोध किए गए अनुरोध के लिए डायरेक्ट्री देखी जा सकती हैं पेज को नीचे दिए गए क्रम में रखें.

1. public/localized-files/fr_ca/

2. public/localized-files/en_ca/

3. public/localized-files/ALL_ca/

4. public/localized-files/fr_ALL/

5. public/localized-files/fr/

6. public/localized-files/en_ALL/

7. public/localized-files/en/

8. public/

9. 404 कोड वाली सेटिंग

उपयोगकर्ता को कौनसा पेज दिखाया जाएगा?

• अनुरोध किया गया पेज: index.html

  जवाब दें

  fr_ca/ सबफ़ोल्डर से index.html

  होस्ट करने की सुविधा, सबसे पहले fr_ca/ सब-फ़ोल्डर में खोज करती है. इसलिए, इसे उस सब-फ़ोल्डर में मौजूद index.html से एग्ज़ैक्ट मैच करें.

• अनुरोध किया गया पेज: awesome-page.html

  जवाब दें

  fr/ सबफ़ोल्डर से 404.html

  होस्टिंग सबसे पहले पूरी डायरेक्ट्री खोजता है (इसमें वे सभी "i18n कॉन्टेंट" और रूट डायरेक्ट्री में सेव किया जाता है) एग्ज़ैक्ट मैच वाला कीवर्ड, लेकिन awesome-page.html के लिए एग्ज़ैक्ट मैच उपलब्ध नहीं है.

  इसलिए, होस्टिंग की सुविधा 404 कोड वाली गड़बड़ी को हैंडल करना शुरू कर देगी. यह सब उसी i18n के बाद होगा मिलती-जुलती खोजों के तौर पर प्राथमिकता क्रम में व्यवस्थित किया जा सकता है. पहला fr/ सब-फ़ोल्डर एक ऐसे सब-फ़ोल्डर के बारे में खोजा गया जिसमें 404 पेज है.

"i18n कॉन्टेंट" के इस खोज और सेवा के बारे में नीचे दी गई बातों का ध्यान रखें डायरेक्ट्री:

• localized-files/ डायरेक्ट्री में, en_ca/ नहीं होता है, en_ALL/ या en/ सबफ़ोल्डर का इस्तेमाल करता है, तो होस्टिंग की सूची में ऊपर बताई गई चीज़ें शामिल नहीं हैं. प्राथमिकता सूची, जब तक कि इसमें अनुरोध के मेल खाने वाला सब-फ़ोल्डर नहीं मिल जाता देश और भाषा के हिसाब से.

• भले ही, localized-files/ डायरेक्ट्री में es_ALL/ मौजूद हो सब-फ़ोल्डर मौजूद है, तो ऊपर दिए गए अनुरोध के उदाहरण में es या es-foo शामिल नहीं हैं भाषा कोड है, इसलिए होस्टिंग की ओर से "i18n content" को नहीं खोजा जाएगा वह es से मेल खाता है.

• fr/ और fr_ALL/ नाम के सब-फ़ोल्डर, उपयोगकर्ता के देश और भाषा की पसंद. हालांकि, अगर दोनों सब-फ़ोल्डर मौजूद है, होस्टिंग सेवा fr/ सामग्री से पहले fr_ALL/ सामग्री प्रस्तुत करेगी.

कुकी से भाषा और देश के कोड बदलें

देश को बदलने के लिए, कुकी का इस्तेमाल करके यह तय किया जा सकता है कि किस तरह का कॉन्टेंट दिखाया जाए और भाषा हेडर.

कुकी में किए गए बदलाव को इस्तेमाल करने के कुछ तरीके यहां दिए गए हैं:

• किसी सुविधा की जांच करने के लिए, अलग-अलग भाषा/देश के कॉम्बिनेशन वाली सुविधा इस्तेमाल करें. कॉन्टेंट दिखाया जाता है.

• अपने उपयोगकर्ताओं को उनके लिए कॉन्टेंट में बदलाव करने की अनुमति दें. उदाहरण के लिए, आपके पास भाषा चुनने की सुविधा लागू करें. इसके बाद, उपयोगकर्ता के firebase-language-override कुकी ज़रूरत के मुताबिक है.

कुकी में बदलाव करने के लिए उसे कॉन्फ़िगर करें. इसके लिए, इन दोनों या किसी एक नाम की मदद से कुकी सेट करें: firebase-country-override और firebase-language-override. उदाहरण के लिए, नीचे दिया गया JavaScript कोड स्निपेट देश के कोड को ca में बदल देता है और Accept-Language हेडर को fr,en किया जाएगा:

document.cookie = "firebase-country-override=ca";
document.cookie = "firebase-language-override=fr,en";

भाषा कोड बदलने की सुविधा, कॉमा लगाकर अलग की गई, भाषा कोड की सूची होनी चाहिए सबटैग या क्वालिटी वैल्यू के बिना, प्राथमिकता का क्रम.

कुकी में हुए बदलाव, लॉग में नहीं दिखते.