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

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

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

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

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

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

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

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

अपनी Hosting साइट के लिए i18n रीराइट सेट अप करने के लिए, आपको सभी स्थानीय भाषा में उपलब्ध कॉन्टेंट के लिए "i18n content" डायरेक्ट्री बनानी होगी. इसके बाद, अपनी firebase.json फ़ाइल में i18n एट्रिब्यूट जोड़ना होगा, ताकि वह आपकी नई "i18n content" डायरेक्ट्री की ओर इशारा करे.

यहां रिस्पॉन्सिव साइट में बदलने के तरीके के बारे में ज़्यादा जानकारी दी गई है:

1. अपनी स्थानीय ऐप्लिकेशन डायरेक्ट्री के public फ़ोल्डर में, "i18n कॉन्टेंट" के लिए एक अलग डायरेक्ट्री बनाएं. इसके बाद, अपनी साइट पर इस्तेमाल की जा सकने वाली हर भाषा और देश के कॉम्बिनेशन के लिए सबफ़ोल्डर बनाएं.

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

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

   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 डायरेक्ट्री या अन्य सबफ़ोल्डर में मिलती-जुलती फ़ाइलें होना ज़रूरी नहीं है. आपके पास किसी भाषा और/या देश के हिसाब से कॉन्टेंट बनाने का विकल्प होता है.

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. अपनी Hosting साइट पर "i18n कॉन्टेंट" और कॉन्फ़िगरेशन डिप्लॉय करें.

कुकी बदलने की सुविधा का इस्तेमाल करके, अपने सेटअप की जांच की जा सकती है.

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

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

Hosting उपयोगकर्ता के आईपी पते से देश का कोड हासिल करता है. देश के कोड, दो अक्षर वाले ISO 3166-1 alpha-2 कोड होते हैं.

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

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

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

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

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

  स्पेन के लिए स्पैनिश कॉन्टेंट दिखाओ, न कि किसी दूसरे देश के लिए (es-419 के जैसा व्यवहार करो)

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

  अमेरिका, मेक्सिको या किसी अन्य देश से es-419 भाषा में किए गए अनुरोध पर, es_ALL/ सबफ़ोल्डर से कॉन्टेंट मिलेगा. ऐसा इसलिए, क्योंकि Hosting, 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/ सबफ़ोल्डर से कॉन्टेंट मिलेगा. ऐसा इसलिए, क्योंकि Hosting भाषा कोड es-419 को es के तौर पर मानता है.

  हालांकि, अगर अमेरिका से कोई अनुरोध es-419 भाषा में किया जाता है, तो उसे es_ALL/ सबफ़ोल्डर से कॉन्टेंट मिलेगा. ऐसा इसलिए, क्योंकि Hosting, 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 रीराइट सेट अप किए हैं, तो Hosting कॉन्टेंट को प्राथमिकता के इस क्रम के हिसाब से दिखाता है:

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 content" डायरेक्ट्री (जिसे 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 (कनाडा)

पूरी तरह मेल खाने वाले कीवर्ड को प्राथमिकता देने के क्रम और भाषा की प्राथमिकताओं के लिए क्वालिटी वैल्यू के हिसाब से, Hosting अनुरोध किए गए पेज के लिए डायरेक्ट्री में इस क्रम में खोज करेगा.

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

  Hosting सबसे पहले fr_ca/ सबफ़ोल्डर में खोज करता है. इसलिए, उसे उस सबफ़ोल्डर में index.html का एग्ज़ैक्ट मैच मिल जाएगा.

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

  जवाब दें

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

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

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

"i18n कॉन्टेंट" डायरेक्ट्री को खोजने और उसे दिखाने के बारे में यहां कुछ बातें बताई गई हैं:

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

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

• fr/ और fr_ALL/ नाम के सबफ़ोल्डर, उपयोगकर्ता के देश और भाषा की प्राथमिकताओं के हिसाब से एक जैसे होते हैं. हालांकि, अगर दोनों सबफ़ोल्डर मौजूद हैं, तो Hosting, 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";

भाषा कुकी ओवरराइड, भाषा कोड की कॉमा-सेपरेटेड लिस्ट होनी चाहिए. इसमें भाषा कोड को प्राथमिकता के क्रम में रखा जाता है. इसमें सबटैग या क्वालिटी वैल्यू शामिल नहीं होती हैं.

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