If you are building server-rendered Angular or Next.js apps, check out next-generation Firebase App Hosting, a full-stack solution for modern web frameworks.

Questa pagina è stata tradotta dall'API Cloud Translation.

Configurare le riscritture di internazionalizzazione (i18n)

Utilizza le riscritture di internazionalizzazione ("riscritture i18n") per pubblicare contenuti diversi a seconda del paese o della lingua preferita di un utente. Ecco alcuni esempi di configurazioni che potresti impostare:

Mostra gli stessi contenuti in francese a tutti gli utenti che preferiscono il francese (indipendentemente dal paese).
Esempio: una home page con testo in francese
Pubblica contenuti in francese standard per gli utenti che preferiscono il francese, ma per gli utenti canadesi che preferiscono il francese, pubblica invece contenuti in francese canadese.
Esempio: una home page con formulazione in francese standard rispetto a una home page con formulazione in francese canadese
Pubblica gli stessi contenuti per tutti gli utenti canadesi (indipendentemente dalla loro preferenza della lingua).
Esempio: una home page con la lingua "predefinita" del tuo sito, ma con una funzionalità specifica per il Canada (come un tema festivo)
Pubblica contenuti in francese canadese per gli utenti canadesi che preferiscono il francese.
Esempio: una home page con frasi in francese canadese e una funzionalità specifica per il Canada (ad esempio un tema festivo)

Firebase Hosting determina il paese di un utente in base al suo indirizzo IP e le preferenze della lingua di un utente dall'intestazione della richiesta Accept-Language (in genere impostate automaticamente dal browser web).

Configurare le riscritture i18n

Per configurare le riscritture i18n per il tuo sito Hosting, devi creare una directory "i18n content" per tutti i tuoi contenuti localizzati, quindi aggiungere l'attributo i18n al file firebase.json per indirizzare alla nuova directory "i18n content".

Ecco i passaggi dettagliati:

All'interno della cartella public della directory dell'app locale, crea una directory separata per i "contenuti i18n", poi crea sottocartelle per ogni combinazione di lingua e paese supportata dal tuo sito.

In ogni sottocartella, aggiungi i contenuti specifici per quella combinazione, ad esempio home page a tema festivo o pagine 404 specifiche per la lingua.

Ecco un esempio di directory "i18n content" chiamata 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

Visualizzare le richieste di corrispondenza per i contenuti di ogni sottocartella

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

La directory localized-files/ contiene sottocartelle separate per ogni combinazione di lingua e paese supportata dal tuo sito. Il pattern di denominazione di ogni sottocartella deve seguire uno di questi formati:

languageCode_countryCode: contiene contenuti specifici per gli utenti che hanno quella preferenza della lingua e quel codice paese
languageCode: contiene contenuti specifici per gli utenti che hanno questa preferenza della lingua, ma i contenuti non sono specifici per paese; in pratica equivalente a languageCode_ALL

Per ulteriori dettagli su questi codici, consulta la sottosezione Codici paese e lingua di seguito. Puoi utilizzare il valore di ALL (sensibile alle maiuscole) per indicare qualsiasi paese (ad esempio es_ALL/) o qualsiasi lingua (ad esempio ALL_ca/).

I file in una sottocartella non devono avere file analoghi nella directory public o in altre sottocartelle. Puoi creare contenuti completamente specifici per una lingua e/o un paese.

Aggiungi l'attributo i18n al file firebase.json e specifica la directory che contiene i "contenuti i18n". Continuando con il nostro esempio:
```
// firebase.json

"hosting": {

  "public": "public",

  "ignore": [
    "firebase.json",
    "**/.*",
    "**/node_modules/**"
  ],

  "i18n": {
    "root": "/localized-files"  // directory that contains your "i18n content"
  }

  ...
}
```
La directory specificata per root deve essere il nome della directory che contiene tutte le sottocartelle "i18n content". Se hai inserito tutte le sottocartelle "i18n content" nella directory principale di public, utilizza / per il valore di root. Le barre iniziali e finali nel valore root sono facoltative.
Esegui il deployment dei contenuti e della configurazione "i18n" sul tuo sito Hosting.

Puoi testare la configurazione utilizzando gli override dei cookie.

Codici paese e lingua

Quando assegni un nome alle sottocartelle "i18n content", devi utilizzare le lettere minuscole sia per i codici paese che per i codici lingua. Puoi utilizzare il valore di ALL (sensibile alle maiuscole) per indicare qualsiasi paese (ad esempio es_ALL/) o qualsiasi lingua (ad esempio ALL_ca/).

Hosting ottiene il codice paese dall'indirizzo IP dell'utente. I codici paese sono codici ISO 3166-1 alpha-2 di due lettere.

I codici lingua vengono ottenuti dall'intestazione della richiesta Accept-Language dell'utente (in genere impostata automaticamente dal browser web). Si tratta di codici ISO 639-1. Quando utilizzi i codici lingua, tieni presente quanto segue:

Quando Hosting cerca i contenuti i18n da pubblicare, ordina le lingue in base ai valori di qualità nell'intestazione Accept-Language.

Hosting elimina tutti i tag secondari regionali e di paese nell'intestazione Accept-Language, pertanto il codice della lingua nel nome di una sottocartella "i18n content" non può contenere questi tag secondari. Ad esempio, non puoi utilizzare es-419 o es-US come codice lingua nel nome di una sottocartella, ma puoi utilizzare es.

Se vuoi pubblicare contenuti specifici per regione o paese, puoi creare sottocartelle che contengano i contenuti specifici per lingua e paese che vuoi supportare.

Visualizzare esempi per supportare contenuti specifici per regione o paese

Pubblica contenuti in spagnolo applicabili alla Spagna anziché a qualsiasi altro paese (imita il comportamento di es-419)

In questo esempio, una richiesta dalla Spagna con la preferenza di lingua es, es-es o anche es-419 riceverebbe contenuti dalla sottocartella es_es/ perché Hosting considera tutti questi codici di lingua come es.

Una richiesta proveniente dagli Stati Uniti, dal Messico o da qualsiasi altro paese con la preferenza della lingua es-419 riceverebbe contenuti dalla sottocartella es_ALL/ perché Hosting considera es-419 come 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

Pubblicare contenuti in spagnolo applicabili a paesi specifici

In questo esempio, una richiesta dal Messico con la preferenza della lingua es-419 riceverebbe contenuti dalla sottocartella es_mx/ perché Hosting considera il codice lingua es-419 come es.

Tuttavia, una richiesta proveniente dagli Stati Uniti con la preferenza della lingua es-419 riceverebbe contenuti dalla sottocartella es_ALL/ perché Hosting considera es-419 come es e non esiste una sottocartella 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

Ordine di priorità per "i18n content"

Se configuri le riscritture i18n, Hosting pubblica i contenuti in base al seguente ordine di priorità:

Spazi dei nomi riservati che iniziano con un segmento di percorso /__/*
Reindirizzamenti configurati
Contenuti statici con corrispondenza esatta
1. Codice lingua + codice paese (ad esempio, contenuti di fr_ca/)
  L'ordine segue i valori di qualità per ogni lingua nell'intestazione Accept-Language della richiesta.
2. Solo il codice paese (ad es. contenuti di ALL_ca/)
3. Solo codice lingua (ad esempio, contenuti di fr/ o es_ALL/)
  L'ordine segue i valori di qualità per ogni lingua nell'intestazione Accept-Language della richiesta.
4. Contenuti statici con corrispondenza esatta "Predefinito"
  Si tratta di contenuti che si trovano al di fuori della directory "i18n content", ad esempio nella directory principale di public.
Configurato riscritture
Gestione degli errori 404
1. Pagine 404 i18n
  Segue lo stesso ordine di priorità elencato sopra per i contenuti statici con corrispondenza esatta.
2. Pagina Personalizza pagina 404
3. Pagina 404 predefinita (fornita da Firebase)

Esempio di ordine di priorità

Continuiamo con l'esempio precedente. Utilizzeremo la stessa directory di esempio e una richiesta di esempio.

Esempio di directory di progetto locale con una directory "i18n content" (denominata 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

Informazioni sulla richiesta di esempio
- Codici lingua: fr, en (francese, poi inglese)
  I codici lingua sono ordinati in base ai valori di qualità nell'intestazione Accept-Language.
- Codice paese: ca (Canada)

In base all'ordine di priorità della corrispondenza esatta e ai valori di qualità per le preferenze della lingua, Hosting cercherà le directory per una pagina richiesta nel seguente ordine.

public/localized-files/fr_ca/
public/localized-files/en_ca/
public/localized-files/ALL_ca/
public/localized-files/fr_ALL/
public/localized-files/fr/
public/localized-files/en_ALL/
public/localized-files/en/
public/
Gestione degli errori 404

Quale pagina verrà mostrata all'utente?

Pagina richiesta: index.html

Risposta

index.html dalla sottocartella fr_ca/

Poiché Hosting esegue la ricerca prima nella sottocartella fr_ca/, troverà la corrispondenza esatta per index.html in quella sottocartella.
Pagina richiesta: awesome-page.html

Risposta

404.html dalla sottocartella fr/

Hosting esegue prima la ricerca nell'intera directory (incluse tutte le sottocartelle"i18n content" e la directory principale) in ordine di priorità per una corrispondenza esatta, ma non esiste una corrispondenza esatta per awesome-page.html.

Pertanto, Hosting inizierà la gestione dell'errore 404, che segue lo stesso ordine di priorità di internazionalizzazione delle ricerche a corrispondenza esatta. La sottocartella fr/ è la prima sottocartella in cui è stata eseguita la ricerca e che contiene una pagina 404.

Tieni presente quanto segue in merito alla ricerca e alla pubblicazione della directory "i18n content":

La directory localized-files/ non contiene effettivamente le sottocartelle en_ca/, en_ALL/ o en/, quindi Hosting scorrerà l'elenco di priorità finché non trova una sottocartella corrispondente alla combinazione di lingua e paese della richiesta.
Anche se la directory localized-files/ contiene una sottocartella es_ALL/, la richiesta di esempio riportata sopra non include un codice lingua es o es-foo, pertanto Hosting non cercherà "contenuti i18n" che corrispondono a es.
Le sottocartelle denominate fr/ e fr_ALL/ sono equivalenti dal punto di vista delle preferenze di paese e lingua di un utente. Tuttavia, se esistono entrambe le sottocartelle, Hosting pubblicherà i contenuti di fr_ALL/ prima di quelli di fr/.

Puoi modificare i contenuti pubblicati utilizzando i cookie per ignorare le intestazioni di paese e lingua.

Ecco alcuni modi in cui puoi utilizzare gli override dei cookie:

Testa una funzionalità con diverse combinazioni di lingua/paese per verificare quali contenuti vengono pubblicati.
Consenti agli utenti di modificare i contenuti che visualizzano. Ad esempio, puoi implementare un selettore di lingua, quindi impostare il cookie firebase-language-override dell'utente di conseguenza.

Per configurare gli override dei cookie, imposta i cookie con uno o entrambi questi nomi: firebase-country-override e firebase-language-override. Ad esempio, il seguente snippet di codice JavaScript esegue l'override del codice paese impostandolo su ca e dell'intestazione Accept-Language impostandola su fr,en:

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

Gli override dei cookie della lingua devono essere un elenco separato da virgole di codici di lingua in ordine di preferenza, senza tag secondari o valori di qualità.

Gli override dei cookie non vengono visualizzati nei log.