如果您在构建服务器端渲染的 Angular 或 Next.js 应用，不妨试试我们新一代的 Firebase App Hosting，这是一款适用于现代 Web 框架的全栈解决方案。

本頁面由 Cloud Translation API 翻譯而成。

設定國際化 (i18n) 重寫

使用國際化改寫 (「i18n 改寫」) 提供不同內容根據使用者的國家/地區或偏好語言而定以下提供一些例子您可以設定的配置項目：

為偏好法文的「所有」使用者顯示相同的法文內容 (無論何者為何) 國家/地區)。
範例：含有法文文字的首頁
向偏好法文、 加拿大使用者偏好法文，提供加拿大法文內容。
範例：首頁寫法的法文語句和含有以下字詞的首頁加拿大法文語句
為所有加拿大使用者 (不論語言偏好設定)。
範例：包含網站的「預設」首頁但有了加拿大專屬功能 (例如節慶主題)
向偏好法文的加拿大使用者放送加拿大法文內容。
範例：含有加拿大法文語句的首頁，但以加拿大為主特色 (例如節慶主題)

Firebase Hosting 會根據使用者的 IP 位址判斷使用者所在國家/地區，並根據 Accept-Language 要求標頭判斷使用者的語言偏好設定 (通常是由使用者的網路瀏覽器自動設定)。

設定 i18n 改寫

如要為 Hosting 網站設定 i18n 重新寫入，您必須建立「i18n」內容」，然後加入 i18n 屬性。連結到您的 firebase.json 檔案，指向新的「i18n 內容」目錄。

詳細步驟如下：

在本機應用程式目錄的 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」中指定類似的檔案目錄或其他子資料夾您可以建立完全專為特定語言和/或國家/地區提供的產品設計

在 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 值開頭和結尾的斜線則為選用項目。
部署「i18n 內容」，並將其設為您的 Hosting 網站。

您可以使用 Cookie 覆寫來測試設定。

國家/地區和語言代碼

命名「i18n 內容」時子資料夾，且兩個國家/地區必須使用小寫和語言代碼您可以使用 ALL 的值 (區分大小寫) 來表示任何國家/地區 (例如 es_ALL/) 或任何語言 (例如 ALL_ca/)。

Hosting 會從使用者的 IP 位址取得國家/地區代碼。國家/地區代碼為兩個字母 ISO 3166-1 alpha-2 代碼。

從使用者的 Accept-Language 要求標頭中取得語言代碼 (通常由網路瀏覽器自動設定)。格式為 ISO 639-1。使用語言代碼時，請注意下列事項：

Hosting搜尋「i18n 內容」時才能放送偵測出語言、語言Accept-Language

Hosting 的Accept-Language區域和國家/地區子標記均下滑所以「i18n 內容」中的語言代碼子資料夾名稱不能包含這些子標記舉例來說，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. 語言代碼 + 國家/地區代碼 (例如來自 fr_ca/ 的內容)
  順序會依據要求 Accept-Language 標頭中各語言的品質值。
2. 僅限國家/地區代碼 (例如「ALL_ca/」的內容)
3. 僅限語言代碼 (例如來自 fr/ 或 es_ALL/ 的內容)
  此順序取決於要求中各語言的品質值 Accept-Language 標頭。
4. 「預設」完全比對靜態內容
  這是位於「i18n content」目錄以外的內容，例如位於 public 目錄根目錄中。
已設定的重寫
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 (加拿大)

根據完全比對優先順序和語言偏好設定的品質值，Hosting 會按照以下順序搜尋目錄，找出要求的網頁。

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 處理

系統會向使用者顯示哪一個網頁？

要求的網頁：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/ 內容。

您可以使用 Cookie 覆寫國家/地區和語言標頭，藉此變更要放送的內容。

以下列舉幾個使用 Cookie 覆寫功能的方法：

使用不同的語言/國家/地區組合測試功能，確認系統會提供哪些內容。
可讓使用者變更他們所看到的內容。舉例來說：導入語言選單，然後將系統會擷取 firebase-language-override 個 Cookie。

如要設定 Cookie 覆寫功能，請將 Cookie 設為同時使用以下兩種名稱：《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";

語言 Cookie 覆寫值必須是以逗號分隔的語言代碼清單，排列順序 (不含子標記或品質值)。

記錄檔中不會顯示 Cookie 覆寫值。