使用翻譯器管理字典

AEM提供主控台，可管理元件UI中使用的各種文字翻譯。 此控制台可在

https://<hostname>:<port-number>/libs/cq/i18n/translator.html

使用翻譯工具管理英文字串及其翻譯。 字典是在存放庫中建立，例如/apps/myproject/i18n。

請注意，翻譯工具和您管理的字典是用於以不同語言呈現元件UI。 如果要翻譯頁面或用戶生成的內容，請參閱翻譯多語言站點的內容和翻譯用戶生成的內容。

翻譯器列出AEM中使用的各種語言翻譯的文本：

您可以搜尋、篩選及編輯英文和翻譯的文字。 您也可以將字典匯出為XLIFF格式以進行轉譯，然後將翻譯匯回字典。

您也可以從此主控台將i18n字典新增至翻譯專案。 您可以建立新專案或新增至現有專案。

1. 按一下「翻譯字典」。

   

2. 視需要選取「建立」或「新增」選項。 對話方塊隨即開啟。

   

3. 視需要填寫欄位，然後按一下「確定」。

4. 您現在可以按一下​OK​或查看Target字典。

   注意

   有關翻譯項目的詳細資訊，請參閱管理翻譯項目。

建立字典

建立字典以管理本地化的UI字串。 建立字典後，可以使用翻譯工具來管理它。

1. 使用CRXDE Lite，為新字典新增根節點(sling:Folder)，作為存放語言定義的結構：

   /apps/<projectName>/i18n

   例如， /apps/myProject/i18n

2. 在此根下添加所需的語言結構。 例如：

   /apps/myProject/i18n [sling:Folder]
       - de.json [nt:file] [mix:language]
           + jcr:language = de
       - fr.json [nt:file] [mix:language]
           + jcr:language = fr
   

   注意

   這是Sling i18n模組中的結構。

3. 重新載入翻譯器和字典路徑(例如/apps/myProject/i18n)將可在工具列的下拉式選取器中使用。 選擇此選項可開始添加字串及其翻譯。

   注意

   翻譯器只會儲存路徑下實際存在的語言的翻譯(例如/apps/myProject/i18n)。

   請確定這些語言對應至格線中顯示的語言。

管理字典字串

使用翻譯工具管理字典中的字串。 您可以新增、修改和移除英文字串，也可提供翻譯的字串。

添加、更改和刪除字串

將英文字串添加到元件已國際化的字典中。 僅添加國際化的字串，這樣您就不會通過轉換未使用的字串來浪費資源。

您新增至字典的字串必須與程式碼中指定的字串完全相符。 如果程式碼中使用的預設英文字串與字典中的英文字串不符，則視需要翻譯的字串不會出現在UI中。 字串區分大小寫。

提供翻譯提示

使用字典字串的Commenet屬性向翻譯者提供資訊以釐清字串的意義。 通常，UI會協助使用者判斷模糊字詞的含義。 不過，轉譯器在UI的內容中不會看到字串。 翻譯提示可消除模糊。 例如，注釋有助於翻譯人員了解英文單詞Request是作為名詞而不是動詞。

翻譯提示還能區分相同且含義不同的字串。 例如，Search可以是名詞或動詞，需要字典中兩個「Search」項，並有兩個不同的翻譯提示。 要求字串的程式碼也包含翻譯提示，以便在UI中使用正確的字串。

包括索引變數

在本地化字串中加入變數，將內容含義建置至句子中。 例如，登入Web應用程式後，首頁會顯示訊息「歡迎返回管理員」。 收件箱中有2條郵件。」 頁面內容會決定使用者名稱和訊息數量。

若要在本地化字串中加入變數，請將括弧內的索引放置在get方法第一個引數中變數的位置。 請使用本地化提示來說明值。 翻譯者必須了解變數的意義，因為不同語言使用不同的句子結構。

請注意，要求翻譯字串🔗的代碼會根據上下文為索引變數提供值。

例如，當使用者登入網站且包含在字典中時，會顯示下列字串：

Welcome back {0}. You have {1} messages.

以下備注說明變數：

{0} = the user name, {1} = the number of items in the user's inbox

修改字串

變更或移除程式碼中已變更或移除的英文字串。 當您變更字串時，原始字串會持續存在，並會產生反映變更的新字串。 移除字串之前，請確定沒有程式碼使用該字串。

請依照下列程式新增字串。

1. 在「字典」下拉式功能表中，選取您要新增字串的字典。 在下拉式功能表中，字典由其在存放庫中的路徑表示。

2. 在「字串和翻譯」表格上方，按一下「新增」。

   

3. 在新增字串對話方塊的字串方塊中，輸入英文字串。 在「注釋」框中，為翻譯鍵入翻譯提示（如有必要）。

4. 按一下「確定」。

5. 按一下「儲存」。

   

使用以下過程更改字典中的字串。

1. 在「字典」下拉式功能表中，選取包含要變更之字串的字典。

2. 按兩下要更改的字串。

3. 在「編輯字串」對話框中，選擇「修改字串」或「注釋」（建立副本）。

   

4. 修改字串或注釋，然後按一下「確定」。

5. 按一下「儲存」。

   

使用以下過程從字典中刪除字串。

1. 在「字典」下拉式功能表中，選取您要移除字串的字典。

2. 按一下「移除」。

   

3. 按一下「儲存」。

   

搜索字串

「轉換器」工具底部的搜索欄提供了字串選擇選項：

• 依文字篩選： 與英文字串、註解或翻譯相符的模式。只有符合模式全部或部分的項目才會出現在表格中。

• 變更：任何、已修改、新增、已刪除： 顯示已變更且未儲存的項目。

  • 任何：顯示已修改、新增或移除的項目。
  • 已修改：顯示已變更的項目。
  • 新增：顯示已新增的項目。
  • 已刪除：顯示要移除的項目。
  • 多個選擇：顯示具有所有所選屬性的項目。

• 有評論:顯示具有筆譯員注釋的項目。

• 缺少翻譯： 顯示至少有一個語言沒有翻譯的項目。

1. 在搜尋列上，選取篩選選項。
2. 若要使用選項進行篩選，請按一下「篩選」。
3. 若要移除篩選器並查看字典中的所有項目，請按一下清除。

編輯翻譯的字串

將英文字串新增至字典後，您可以新增字串的翻譯。 您也可以匯出字典，讓第三方翻譯字典。

1. 選擇您的項目特定字典，因為它指定了包含翻譯的儲存庫中的路徑。 例如，選擇​字典​作為：

   /apps/myProject/i18n

   注意

   僅編輯為您的項目建立並位於/apps下的字典。

   AEM系統字典也可在此工具中使用。 請勿變更AEM系統字典，因為這可能會造成AEM UI問題。 此外，升級時可能會遺失變更。 AEM系統字典位於/libs下。

2. 若要編輯其中一個字串的翻譯文本，您可以執行以下操作：

   • 按兩下所需字串的適當語言以編輯該單一文字：

   

   • 連按兩下所需字串的​字串​或​注釋​欄位以開啟​編輯字串​對話方塊，視需要編輯翻譯，然後按一下​確定​以關閉對話方塊：

   

3. 按一下工具列中的​儲存​以提交變更。

   注意

   按一下​重設並重新整理（而非​儲存）會回復對先前文字的任何變更。

使用第三方翻譯員

為支援使用第三方翻譯服務，翻譯工具允許您導出和導入字典。

導出字典

將字典匯出至XLIFF檔案，讓協力廠商服務可翻譯字典字串。

• 匯出字典，並包含語言的英文和翻譯詞語。
• 匯出部分或全部英文字串。

導出XLIFF檔案並包含語言時，儲存庫中字典的節點結構必須包含該語言。 如果未包含該語言，則會發生錯誤。 例如，要導出法文XLIFF檔案，字典資料夾必須包含名為fr的mix:language子節點。 （請參閱建立字典。）

使用以下過程導出特定語言的XLIFF檔案。

1. 開啟翻譯工具http://<host>:<port>/libs/cq/i18n/translator.html

2. 使用「字典」下拉式功能表來選取要匯出的字典。

3. 按一下「導出」>「導出完整​XX Xliff選項」，其中​XX​是雙字母語言代碼，如DE或FR。

   「XLIFF檔案」（XLIFF檔案）將在新頁簽或窗口中開啟。

4. 使用Web瀏覽器命令將頁面另存為檔案系統上的檔案，如「檔案」(File)>「另存為」(Save Page As)。

請依照下列步驟，匯出全部或部分英文字串。

1. 開啟「翻譯」工具。http://<host>:<port>/libs/cq/i18n/translator.html
2. 使用「字典」下拉式功能表來選取要匯出的字典。
3. 如果要匯出字串的子集，請選取要匯出的字典中的項目。 選擇任何項目將導出所有項目。
4. 按一下「匯出>將選取項目匯出為Xliff」（僅限字串）。
5. 在出現的對話方塊中，複製文字並貼到文字檔案中。

導入字典

將XLIFF檔案匯入字典以填入字典。 當字典包含英文字串的翻譯，而XLIFF檔案包含相同字串的不同翻譯時，將替換字典翻譯。

1. 開啟翻譯工具http://<host>:<port>/libs/cq/i18n/translator.html
2. 按一下「導入」(Import)>「XLIFF翻譯」(XLIFF Translations)。
3. 選擇要導入的檔案，然後按一下「確定」。

管理支援的語言

新增或移除翻譯工具支援以及提供給網頁使用者的語言。

更改字典表中列出的語言

「翻譯工具」在字典表中包含以下語言：

• de — 德文
• fr — 法文
• it — 義大利文
• es — 西班牙文
• ja — 日文
• pt-br — 巴西葡萄牙文
• zh-cn — 簡體中文
• zh-tw — 繁體中文（有限支援）
• ko-kr — 朝鮮語

使用以下過程添加或刪除語言。

1. 使用CRXDE Lite建立新節點：

   /etc/languages

2. 在此節點上，建立屬性：

   • 名稱: languages

   • 類型: Multi-String

   • 值:要顯示的語言清單。例如：

     • fr
     • es
   注意

   語言代碼必須為小寫。

3. 按一下CRXDE Lite中的「保存全部」並重新載入轉換器。 將更新格線以顯示定義的語言。

   注意

   翻譯器將僅保存字典🔗中實際存在的語言的翻譯（即字典路徑下的/apps/myProject/i18n）。

   請確定這些語言對應至格線中顯示的語言。

讓作者能使用語言

為AEM例項的新語言定義字典後，您需要讓作者可以選取該語言（例如，用於​Preferences）:

1. 要更改​Security​控制台的​Preferences​中可用語言的清單：

   1. 在您的應用程式程式碼中建立覆蓋，以執行下列作業：

              /libs/cq/security/widgets/source/widgets/security/Preferences.js
       and update as required.
      

2. 若要從​Websites​控制台使語言在​Preferences​中可用，您需要在應用程式中進行以下更改：

   1. 在下面為結構建立覆蓋：

      /libs/cq/security/content/tools/userProperties

   2. 覆蓋內會更新下方的語言清單：

      items/common/items /lang/options

3. 儲存所有內容並重新載入適當的主控台。

更改語言名稱和預設國家

各國都使用同樣的語言，例如美國、英國和澳大利亞都使用英語。 這由代碼指示，該代碼指示語言和國家/地區，如en_US、en_GB和en_AU。

顯示標幟時會使用預設國家（地區）（例如在語言復本對話方塊中），而用來解析語言代碼的國家（地區）。

若要變更預設定義：

1. 語言清單儲存在下：

   /libs/wcm/core/resources/languages

   將其複製至：

   /apps/wcm/core/resources/languages

   然後在那裡更改或擴展清單。 語言節點上的屬性defaultCountry(例如ja)必須包含完整代碼，例如ja_jp，這會將jp定義為語言ja的預設國家/地區。

2. 更新​CQ WCM語言管理器。

   • 語言清單:

     存放庫中語言清單的路徑。 將此值設為用來覆蓋的位置：

            /apps/wcm/core/resources/languages
     

   您可以使用OSGi Web控制台執行此操作：

   https://<hostname>:<port-number>/system/console/configMgr/com.day.cq.wcm.core.impl.LanguageManagerImpl
   

發佈字典

將字典併入AEM應用程式的發行管理程式。 例如，將字典包含在應用程式的內容套件中，以部署至發佈例項。 此策略提供下列優點：

• 字典適用於其發佈環境中的元件。
• 元件UI字串的變更會與更新的翻譯一併部署。

同樣地，測試字典字串也應在您正常的軟體開發生命週期中執行。