Konfigurowanie przepisywania internacjonalizacji (i18n)

Używaj przekształceń na potrzeby międzynarodowości („przekształceń i18n”), aby wyświetlać różne treści w zależności od kraju użytkownika lub preferowanego języka. Oto kilka przykładów Dostępne konfiguracje:

• Udostępniaj te same treści w języku francuskim wszystkim użytkownikom, którzy wolą język francuski (niezależnie od tego, kraju).
  Przykład: strona główna z tekstem w języku francuskim

• Wyświetlaj standardowe treści w języku francuskim użytkownikom, którzy wolą język francuski, ale w przypadku Użytkownicy z Kanady, którzy wolą język francuski, wyświetlają treści w języku francuskim kanadyjskim
  Przykład: strona główna ze standardowym sformułowaniem w języku francuskim oraz strona główna z Francuska kanadyjska fraza

• Udostępniaj te same treści wszystkim użytkownikom w Kanadzie (niezależnie od ich ustawienia języka).
  Przykład: strona główna z domyślnym ustawieniem Twojej witryny. ale dzięki Obiekt charakterystyczny dla Kanady (np. motyw świąteczny)

• Wyświetlaj treści w języku francuskim kanadyjskie użytkownikom z Kanady, którzy wolą język francuski.
  Przykład: strona główna z kanadyjskim sformułowaniem w języku francuskim i charakterystyczna dla Kanady obiekt (np. motyw świąteczny)

Firebase Hosting określa kraj użytkownika na podstawie jego adresu IP oraz ustawienia języka użytkownika z nagłówka żądania Accept-Language (zwykle ustawione automatycznie przez przeglądarkę).

Skonfiguruj przepisy i18n

Aby skonfigurować przepisy i18n w witrynie Hosting, musisz utworzyć plik „i18n” treści katalogu dla wszystkich zlokalizowanych treści, a następnie dodaj atrybut i18n do pliku firebase.json w celu wskazania nowej „treści i18n” katalogu.

Aby to zrobić:

1. W folderze public lokalnego katalogu aplikacji utwórz oddzielny katalog dla „treści i18n”, a następnie utwórz podfoldery dla każdego języka kombinację krajów obsługiwanych przez Twoją witrynę.

   W każdym podfolderze dodaj treści odpowiednie dla tej kombinacji, takie jak strony główne o tematyce świątecznej lub strony 404 w określonych językach.

   Oto przykład: „treść i18n” katalogu o nazwie 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

   Wyświetlanie żądań pasujących do treści podfolderów

   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

   Katalog localized-files/ zawiera oddzielne podfoldery dla każdego z nich obsługiwanych w Twojej witrynie kombinacji języka i kraju. Wzorzec nazewnictwa każdego podfolderu musi być zgodny z jednym z tych formatów:

   • languageCode_countryCode: zawiera treści przeznaczone dla użytkowników, którzy mają wybrany ten język i ten kod kraju.

   • languageCode: zawiera treści przeznaczone dla użytkowników, którzy mają ten problem. preferowany język, ale treść nie jest przeznaczona dla konkretnego kraju; zasadniczo odpowiednik languageCode_ALL

   Więcej informacji znajdziesz w podsekcji Kody krajów i języków poniżej . Wartość ALL (z rozróżnianiem wielkości liter) może wskazywać dowolny kraj (np. es_ALL/) lub dowolny język (np. ALL_ca/).

   Pliki w podfolderze nie muszą mieć analogicznych plików w folderze public lub innych podfolderach. Możesz tworzyć treści, które są przeznaczone wyłącznie dla określonego języka lub kraju.

   Uwaga: aby dowiedzieć się, w jakiej kolejności Hosting wyświetla pliki „treści zlokalizowanych”, zapoznaj się z poniższą listą priorytetów.

2. Dodaj atrybut i18n do pliku firebase.json i określ katalog zawierający „treści z lokalizacją”. W nawiązaniu do naszego przykładu:

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

   Katalog określony dla root musi być nazwą katalogu, który zawiera wszystkie „treści i18n” podfolderów. Jeśli wszystkie „treści i18n” podfolderów w katalogu głównym katalogu public, użyj / dla wartości root. Średniki na początku i na końcu wartości root są opcjonalne.

3. Wdrażanie „treści i18n” i skonfigurować w witrynie Hosting.

Konfigurację możesz przetestować, używając zastępowania plików cookie.

Kody krajów i języków

Podczas wybierania nazwy „treści i18n” podfolderów, w obu krajach musisz użyć małych liter i kodów języków. Możesz użyć wartości ALL (z uwzględnieniem wielkości liter), aby wskazać dowolny kraj (np. es_ALL/) lub dowolny język (np. ALL_ca/).

Funkcja Hosting pobiera kod kraju na podstawie adresu IP użytkownika. Kody krajów są dwuliterowe Kody ISO 3166-1 alfa-2.

Kody języków są pobierane z nagłówka żądania Accept-Language użytkownika (zwykle ustawione automatycznie przez przeglądarkę). Są to kody ISO 639-1. Korzystając z kodów językowych, pamiętaj o tych kwestiach:

• Gdy Hosting wyszukuje, jakie „treści w języku i18n” ma wyświetlić, sortuje języki według wartości jakości w nagłówku Accept-Language.

• Hosting usuwa wszystkie subtagi regionalne i krajowe w Accept-Language nagłówek, więc kod języka w sekcji „treść i18n” nazwa podfolderu nie może zawierających te subtagi. Nie możesz na przykład użyć atrybutów es-419 ani es-US jako kodu języka w nazwie podfolderu, ale możesz użyć es.

  Jeśli chcesz wyświetlać treści dostosowane do konkretnego regionu lub kraju, możesz podfoldery zawierające treści w określonych językach i krajach, które chcesz .

  Przykłady treści regionalnych lub krajowych

  Wyświetlanie treści w języku hiszpańskim w Hiszpanii w porównaniu z dowolnym innym krajem (naśladowanie działania es-419)

  W tym przykładzie żądanie z Hiszpanii z preferowanym językiem ustawionym na es, es-es, a nawet es-419 będą otrzymywać treści z es_es/ podfolder, bo Hosting traktuje wszystkie te kody języków jako es.

  Wniosek ze Stanów Zjednoczonych, Meksyku lub innego kraju, w którym obowiązuje ustawiony język es-419 będzie otrzymywać treści z usługi es_ALL/ podfolder, bo Hosting traktuje es-419 jako 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

  Wyświetlaj treści w języku hiszpańskim dotyczące: określonych krajów

  W tym przykładzie żądanie z Meksyku z preferowanym językiem es-419 otrzyma treść z podfolderu es_mx/, ponieważ Hosting traktuje kod języka es-419 jako es.

  Jednak w przypadku żądania ze Stanów Zjednoczonych z preferowanym językiem es-419 otrzyma treść z podfolderu es_ALL/, ponieważ Hosting traktuje element es-419 jako es i nie zawiera on podfolderu 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

Priorytet dla „treści i18n”

Jeśli skonfigurujesz przepisy i18n, Hosting będzie wyświetlać treści na podstawie tych kryteriów: priorytet:

1. Zarezerwowane przestrzenie nazw, które zaczynają się od segmentu ścieżki /__/*

2. Skonfigurowane przekierowania

3. Ścisłe dopasowanie treści statycznej

   1. Kod języka + kod kraju (np. treści z: fr_ca/)
      Kolejność jest zgodna z wartościami jakości dotyczącymi każdego języka w żądaniu Accept-Language.

   2. Tylko kod kraju (na przykład treści z: ALL_ca/)

   3. Tylko kod języka (np. treści z fr/ lub es_ALL/)
      Kolejność jest zgodna z wartościami jakości dotyczącymi każdego języka w żądaniu Accept-Language.

   4. „Domyślne” treści statyczne w dopasowaniu ścisłym
      To nie są „treści i18n” np. w katalogu katalogu głównego katalogu public.

4. Skonfigurowane przepisy

5. Obsługa błędów 404

   1. Strony i18n 404
      Kolejność jest taka sama jak dla dopasowania ścisłego treści statycznych.

   2. Strona Niestandardowa strona 404

   3. Domyślna strona 404 (udostępniona przez Firebase)

Przykład kolejności priorytetu

Posłużmy się powyższym przykładem. Użyjemy tego samego przykładowego katalogu przykład żądania.

• Przykład katalogu lokalnego projektu z katalogiem „treści i18n” (o nazwie 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

• Przykładowe informacje o żądaniu

  • Kody języków: fr, en (francuski, a potem angielski)
    Kody języków są uporządkowane według wartości jakości w Accept-Language.

  • Kod kraju: ca (Kanada)

Zgodnie z kolejnością priorytetów dopasowania ścisłego i wartościami jakości dla preferencji językowych Hosting będzie przeszukiwać katalogi w takiej kolejności:

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. Obsługa 404

Która strona będzie wyświetlana użytkownikowi?

• Żądana strona: index.html

  Odpowiedz

  index.html z podfolderu fr_ca/

  Ponieważ Hosting najpierw przeszukuje podfolder fr_ca/, znajdzie dokładne dopasowanie do atrybutu index.html w tym podfolderze.

• Żądana strona: awesome-page.html

  Odpowiedz

  404.html z podfolderu fr/

  Hosting najpierw przeszukuje cały katalog (łącznie z „treści i18n” podfolderów i katalogu głównego) w kolejności zależnej od priorytetu dokładne dopasowanie, ale nie ma dokładnego dopasowania dla awesome-page.html.

  Dlatego Hosting rozpocznie obsługę kodu 404, który występuje w ten sam sposób priorytet na wyszukiwania w dopasowaniu ścisłym. Podfolder fr/ jest pierwszy wyszukiwany podfolder zawierający stronę 404.

Pamiętaj o tych kwestiach dotyczących wyszukiwania i obsługi katalogu „Treści w języku i18n”:

• Katalog localized-files/ nie zawiera pliku en_ca/, en_ALL/ lub en/ podfolderów, więc Hosting po prostu przeskoczy w dół listę priorytetową, aż znajdzie podfolder pasujący do kombinacji języka i kraju.

• Mimo że katalog localized-files/ zawiera podfolder es_ALL/, podany powyżej przykład żądania nie zawiera kodu języka es ani es-foo, więc Hosting nie będzie wyszukiwać „treści z uwzględnieniem lokalizacji”, które pasują do es.

• Podfoldery o nazwie fr/ i fr_ALL/ są równoważne z punktu widzenia ustawień kraju i języka użytkownika. Jeśli jednak oba podfoldery istnieje, Hosting będzie wyświetlać treści z kategorii fr_ALL/ przed treścią fr/.

Zastąp kody języków i krajów plikami cookie

Za pomocą plików cookie możesz zmienić wyświetlane treści, aby zastąpić nagłówki kraju i języka.

Oto kilka sposobów korzystania z zastąpienia plików cookie:

• Przetestuj funkcję z różnymi kombinacjami języka i kraju, aby sprawdzić, treści wyświetlane w internecie.

• Pozwól użytkownikom zmieniać treści, które widzą. Możesz na przykład: zaimplementuj selektor języka, a potem ustaw firebase-language-override plik cookie odpowiednio.

Aby skonfigurować zastąpienia plików cookie, ustaw pliki cookie o tych nazwach: firebase-country-override i firebase-language-override. Przykład: następujący fragment kodu JavaScript zastępuje kod kraju na ca i nagłówek Accept-Language na fr,en:

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

Zastąpienia plików cookie języka muszą mieć postać listy rozdzielonych przecinkami kodów języków w według preferencji, bez subtagów ani wartości jakości.

Zastąpienia plików cookie nie są odzwierciedlane w logach.