為以核心元件為主的最適化表單新增地區設定 supporting-new-locales-for-adaptive-forms-localization

URL地區設定選擇器（[地區設定]）：

系統會使用[locale]選取器來排定URL中所指定地區設定的優先順序。 此格式允許快取以獲得更好的效能。

格式： URL遵循以下格式： http:/[AEM Forms伺服器URL]/content/forms/af/[afName]。[locale].html？wcmmode=disabled。

範例： https://[server]/content/forms/af/contact-us.hi.html會以北印度文轉譯表單。

afAcceptLang要求引數：

若要覆寫使用者的瀏覽器地區設定，您可以在URL中使用afAcceptLang引數。

範例： https://[server]/forms/af/survey.ca-fr.html？afAcceptLang=ca-fr強制表單以加拿大法文轉譯。

使用者的瀏覽器地區設定（Accept-Language標題）：

如果未指定其他地區設定，AEM Forms會考慮使用Accept-Language標頭傳送的使用者瀏覽器地區設定。

開啟命令列或終端機視窗。

導覽至您電腦上儲存存放庫所需的位置（例如/adaptive-forms-core-components）。

執行以下命令以複製存放庫：

git clone https://github.com/adobe/aem-core-forms-components.git

這個命令會下載存放庫並在您的電腦上建立名為aem-core-forms-components的資料夾。 在本指南中，我們將此資料夾稱為[Adaptive Forms Core Components repository]

開啟命令列，並選擇要儲存AEM as a Cloud Service存放庫的目錄，例如/cloud-service-repository/。

執行以下命令以複製存放庫：

git clone https://git.cloudmanager.adobe.com/<organization-name>/<program id>/

若要複製Git存放庫，您需要一些資訊：

• 組織名稱：可在Adobe Experience Manager as a Cloud Service (AEM as a Cloud Service)中識別您的團隊或專案。

• 程式識別碼：這會指定與存放庫關聯的程式。

• 認證：您需要使用者名稱和密碼（或個人存取權杖），才能安全地存取存放庫。

在哪裡可以找到此資訊？

如需尋找這些詳細資訊的逐步指示，請參閱Adobe Experience League文章"存取Git"。

您的專案已就緒！

當命令成功完成時，您會看到在本機目錄中建立的新資料夾。 此資料夾以您的程式命名（例如，program-id）。 此資料夾包含從AEM as a Cloud Service Git存放庫下載的所有檔案和程式碼。

在本指南中，我們將此資料夾稱為[AEMaaCS project directory]。

在編輯器中開啟存放庫資料夾。

在編輯器中的

找到Guide Localization Service.cfg.json檔案。 此檔案可控制您的AEM Forms應用程式支援的地區設定。 您可以編輯此檔案以新增語言環境。

• 現有的檔案：如果檔案已經存在，請在您的AEM Forms專案目錄中尋找它。 典型位置為：

  code language-shell
  [AEMaaCS project directory]/ui.config/src/main/content/jcr_root/apps/<appid>/osgiconfig/config`.

  將<appid>取代為您的專案特定應用程式識別碼。 您可以在archetype.properties檔案中找到您AEM專案的<appid>。

  

• 新檔案：如果檔案不存在，您必須在上述相同位置建立檔案。 請勿從此檔案複製貼上檔案名稱，而是手動輸入名稱。 檔案名稱Guide Localization Service.cfg.json包含空格。 這是刻意的操作，不是檔案中的拼寫錯誤。

  包含OOTB支援地區設定清單的範例檔案為：

  code language-none
  { "supportedLocales":[ "en", "fr", "de", "ja", "pt-br", "zh-cn", "zh-tw", "ko-kr", "it", "es" ] }

將您所需語言的地區設定代碼新增到檔案中。

1. 使用ISO 639-1程式碼清單來尋找代表您所需語言的雙字母程式碼。

2. 將地區設定代碼包含到Guide Localization Service.cfg.json檔案中。 以下是一些範例：

   • 由左至右語言：

     • 英文（美國）：en-US
     • 西班牙文（西班牙）： es-ES
     • 法文（法國）：fr-FR

   • 由右至左語言：

     • 阿拉伯文（阿拉伯聯合大公國）： ar-ae
     • 希伯來文： he （或iw以供歷史參考）
     • 波斯文： fa

進行變更後，請確定Guide Localization Service.cfg.json檔案的格式正確為有效的JSON檔案。 JSON格式設定錯誤可能會使其無法正常運作。 儲存檔案。

找到範例使用者端程式庫：

在[最適化Forms核心元件存放庫]的本機復本中，導覽至下列路徑：

    /aem-core-forms-components/it/apps/src/main/content/jcr_root/apps/forms-core-components-it/clientlibs

複製並貼上程式庫：

1. 複製clientlib-it-custom-locale資料夾。

   

2. 導覽至[AEMaaCS專案目錄]中的下列目錄：

   code language-none
   /ui.apps/src/main/content/jcr_root/apps/<app-id>/clientlib

   重要：將<app-id>取代為您應用程式的實際ID。

3. 將複製的clientlib-it-custom-locale資料夾貼到此目錄中。

   

瀏覽到地區設定目錄：

在您的[AEMaaCS project directory]內，瀏覽至下列路徑：

    /ui.apps/src/main/content/jcr_root/apps/<program-id>/clientlibs/clientlib-it-custom-locale/resources/i18n/

重要：將<program-id>取代為您的實際應用程式識別碼。

找到範例英文檔案：

AEM Forms在GitHub🔗上提供範例英文地區設定檔(.json)。

英文檔案包含預設的參考字串集。 您的地區設定特定檔案應模擬英文檔案的結構。

對於阿拉伯文、希伯來文和波斯文等語言，文字會從右至左(RTL)閱讀，而非像英文那樣從左至右(LTR)閱讀。 為確保您的表單在這些語言中正確顯示，我們建議使用我們的範例地區設定檔案作為指南。 這些檔案提供如何設定RTL語言文字、日期和其他元素格式的參考。 您可以找到下列的範例地區設定檔案：

• 阿拉伯文
• 希伯來文
• 波斯文

運用這些範例檔案，您可以確保表單為使用RTL語言的使用者提供順暢的體驗。

建立您的地區設定檔：

1. 在i18n目錄中建立新的.json檔案。
2. 使用您所需語言的適當地區設定代碼為檔案命名（例如，法文為fr-FR.json，阿拉伯文為ar-ae.json）。 此檔案的結構應該會反映英文地區設定檔案。

結構和翻譯：

1. 在文字編輯器中開啟新建立的檔案。

2. 將英文值取代為您目標語言的對應翻譯。

3. 當您完成字串的翻譯後，請儲存檔案。

找到設定資料夾：

導覽至[AEMaaCS專案目錄]中的下列目錄：

/ui.content/src/main/content/jcr_root/etc

建立必要的資料夾（如果遺失）：

如果etc資料夾不存在於jcr_root資料夾中，請建立它。 在etc內，建立另一個名為languages的資料夾（如果遺失）。

建立地區設定檔：

在languages資料夾中，建立名為.content.xml的新檔案。 請勿從此檔案複製貼上檔案名稱，而是手動輸入名稱。

的新檔案

開啟此檔案並貼上下列內容，將[LOCALE_CODE]取代為實際的地區設定代碼（例如，阿拉伯文的ar-ae）。

<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:jcr="http://www.jcp.org/jcr/1.0" xmlns:nt="http://www.jcp.org/jcr/nt/1.0"
      jcr:primaryType="nt:unstructured"
      languages="[de,es,fr,it,pt-br,zh-cn,zh-tw,ja,ko-kr,hi]"/>

警告：請勿取代現有清單。 請改為將新的地區設定代碼附加在方括弧內（以逗號分隔），如下所示（以ar-ae為例）：

languages="[de,es,fr,it,pt-br,zh-cn,zh-tw,ja,ko-kr,hi,ar-ae]"

在filter.xml中包含新資料夾：

導覽至[AEMaaCS專案目錄]中的/ui.content/src/main/content/meta-inf/vault/filter.xml檔案。

開啟檔案，並在結尾新增下列行：

<filter root="/etc/languages"/>

下的filter.xml中新增建立的資料夾

儲存檔案。