Utilizza le riscritture di internazionalizzazione ("riscritture i18n") per pubblicare contenuti diversi in base al paese o alla lingua preferita di un utente. Ecco alcuni esempi di configurazioni che puoi impostare:
Pubblica gli stessi contenuti in francese per tutti gli utenti che preferiscono il francese (indipendentemente dal paese).
Esempio: una home page con testo in francesePubblica contenuti in francese standard per gli utenti che preferiscono il francese, ma per gli utenti canadesi che preferiscono il francese, pubblica contenuti in francese canadese.
Esempio: una home page con una frase in francese standard o una home page con una frase in francese canadesePubblica gli stessi contenuti per tutti gli utenti canadesi (indipendentemente dalla loro preferenza linguistica).
Esempio: una home page con la lingua "predefinita" del tuo sito, ma con una funzionalità specifica per il Canada (ad esempio, il tema delle festività).Pubblicare 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 per le festività)
Firebase Hosting determina il paese di un utente in base all'indirizzo IP e
le preferenze per la lingua di un utente dall'intestazione della richiesta Accept-Language
(di solito
impostate automaticamente dal browser web).
Configurare le riscritture i18n
Per configurare le riscritture i18n per il tuo sito Hosting, devi creare una directory "contenuti i18n" per tutti i tuoi contenuti localizzati, quindi aggiungere l'attributo i18n
al file firebase.json
in modo che rimandi alla nuova directory "contenuti i18n".
Ecco la procedura dettagliata:
Nella cartella
public
della directory dell'app locale, crea una directory distinta per i "contenuti i18n", quindi 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 festività o pagine 404 specifiche per lingua.
Ecco un esempio di directory "contenuti i18n" 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
La directory
localized-files/
contiene sottocartelle separate per ogni combinazione di lingua e paese supportata dal tuo sito. Il modello di denominazione per ogni sottocartella deve seguire uno dei seguenti formati:languageCode_countryCode
: contiene contenuti specifici per gli utenti che hanno quella preferenza linguistica e quel codice paeselanguageCode
: contiene contenuti specifici per gli utenti che hanno questa preferenza linguistica, ma i contenuti non sono specifici per il paese; essenzialmente equivale alanguageCode_ALL
Per ulteriori dettagli su questi codici, consulta la sottosezione Codici paese e lingua di seguito. Puoi utilizzare il valore
ALL
(sensibile alle maiuscole) per indicare qualsiasi paese (ad esempioes_ALL/
) o qualsiasi lingua (ad esempioALL_ca/
).I file in una sottocartella non devono avere file analoghi nella directory
public
o in altre sottocartelle. Puoi creare contenuti interamente specifici per una lingua e/o un paese.Aggiungi l'attributo
i18n
al filefirebase.json
e specifica la directory che contiene i "contenuti i18n". Per continuare 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 sottodirectory "contenuti i18n". Se hai posizionato tutte le sottocartelle "contenuti i18n" nella directory principale dipublic
, utilizza/
per il valore diroot
. Le barre oblique iniziali e finali nel valoreroot
sono facoltative.Esegui il deployment dei "contenuti i18n" e della configurazione sul tuo sito Hosting.
Puoi testare la configurazione utilizzando le sostituzione dei cookie.
Codici paese e lingua
Quando assegni un nome alle sottocartelle "contenuti i18n", devi utilizzare le lettere minuscole sia per i codici paese sia per i codici lingua. Puoi utilizzare il valore 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'Accept-Language
intestazione della richiesta 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 sottotag regionali e dei paesi nell'
Accept-Language
header, pertanto il codice lingua nel nome di una sottocartella "contenuti i18n" non può contienere questi sottotag. Ad esempio, non puoi utilizzarees-419
oes-US
come codice lingua nel nome di una sottocartella, ma puoi utilizzarees
.Se vuoi pubblicare contenuti specifici per regione o paese, puoi creare sottocartelle contenenti i contenuti specifici per lingua e paese che vuoi supportare.
Ordine di priorità per "Contenuti i18n"
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
Codice lingua + Codice paese (ad es. contenuti di
fr_ca/
)
L'ordine segue i valori di qualità per ogni lingua nell'intestazioneAccept-Language
della richiesta.Solo il codice paese (ad es. contenuti di
ALL_ca/
)Solo codice lingua (ad es. contenuti in
fr/
oes_ALL/
)
L'ordine segue i valori di qualità per ogni lingua nell'Accept-Language
della richiesta.es_ALL/
Contenuti statici con corrispondenza esatta "predefiniti"
Si tratta di contenuti esterni alla directory "contenuti i18n", ad esempio nella directory principale della directorypublic
.
Riscritture configurate
Gestione delle pagine 404
Pagine 404 i18n
Segue lo stesso ordine di priorità indicato sopra per i contenuti statici con corrispondenza esatta.Pagina 404 personalizzata
Pagina 404 predefinita (fornita da Firebase)
Esempio di ordine di priorità
Continuiamo con l'esempio precedente. Useremo la stessa directory di esempio e una richiesta di esempio.
Esempio di directory del progetto locale con una directory "contenuti i18n" (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
Esempio di informazioni di richiesta
Codici lingua:
fr
,en
(francese, poi inglese)
I codici lingua sono ordinati in base ai valori di qualità nell'intestazioneAccept-Language
.Codice paese:
ca
(Canada)
In base all'ordine di priorità della corrispondenza esatta e ai valori di qualità per le preferenze linguistiche, Hosting cercherà la pagina richiesta nelle directory 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/
404 Gestione
Quale pagina verrà mostrata all'utente?
Pagina richiesta:
index.html
Pagina richiesta:
awesome-page.html
Tieni presente quanto segue in merito alla ricerca e alla pubblicazione della directory "contenuti i18n":
La directory
localized-files/
non contiene effettivamente sottocartelleen_ca/
,en_ALL/
oen/
, quindi Hosting salterà semplicemente giù nell'elenco di priorità finché non troverà una sottocartella corrispondente per la combinazione lingua-paese della richiesta.Anche se la directory
localized-files/
contiene una sottocartellaes_ALL/
, l'esempio di richiesta riportato sopra non include un codice linguaes
oes-foo
, pertanto Hosting non cercherà "contenuti i18n" corrispondenti aes
.Le sottocartelle denominate
fr/
efr_ALL/
sono equivalenti dal punto di vista delle preferenze relative a paese e lingua di un utente. Tuttavia, se esistono entrambe le sottocartelle, Hosting pubblicherà i contenutifr_ALL/
prima dei contenutifr/
.
Sostituire i codici lingua e paese con i cookie
Puoi modificare quali contenuti vengono pubblicati utilizzando i cookie per eseguire l'override delle intestazioni per paese e lingua.
Ecco alcuni modi in cui puoi utilizzare le sostituzioni dei cookie:
Testa una funzionalità con combinazioni diverse di lingua/paese per verificare quali contenuti vengono pubblicati.
Consenti agli utenti di modificare i contenuti che vedono. Ad esempio, puoi implementare un selettore di lingue, quindi impostare di conseguenza il cookie
firebase-language-override
dell'utente.
Per configurare le sostituzioni dei cookie, imposta i cookie con uno o entrambi i seguenti nomi:
firebase-country-override
e firebase-language-override
. Ad esempio,
lo snippet di codice JavaScript riportato di seguito sostituisce il codice paese con ca
e
l'intestazione Accept-Language
con fr,en
:
document.cookie = "firebase-country-override=ca";
document.cookie = "firebase-language-override=fr,en";
Le sostituzioni dei cookie per la lingua devono essere un elenco separato da virgole di codici lingua in ordine di preferenza, senza sottotag o valori di qualità.
Le sostituzioni dei cookie non vengono applicate nei log.