支援語言變數
AEM Guides提供使用語言變數的功能。 您可以使用語言變數來定義PDF輸出中的當地語系化字串,或將輸出範本中的任何靜態文字當地語系化。 您可以使用CSS樣式將來自CSS的字串當地語系化。
在PDF輸出中使用語言變數
您可以使用語言變數來定義PDF輸出中現成可用標籤(例如「注意」、「警告」和「警告」或靜態文字)的本地化版本。 所有語言的變數名稱都相同,但各種語言的值可能不同。 您可以更新一或多種語言中這些變數的值,然後本地化值會自動在PDF輸出中選取。
例如,您可以在PDF輸出中顯示標籤Note
,方法如下:
-
英文:備註
-
法文:雷馬克
-
德文:欣威文
{width="550"}
英文、法文和德文的範例附註。
en_us
),或挑選英文(en
)值並在PDF輸出中顯示相同的值。語言變數的型別
AEM Guides支援兩種變數型別:應用程式變數和使用者變數。
應用程式變數
AEM Guides提供一組預先定義或現成可用的應用程式變數。 您可以使用這些預先定義的變數來新增AEM Guides專屬檔案的相關資訊。 例如,chapter-number
變數(若包含在頁面中)會顯示頁面所屬的章節編號。 author-label
變數會顯示檔案作者的名稱。
使用者變數
您也可以建立新的語言變數。 例如,您可以為檔案的發行者標籤建立使用者變數Publisher。
{width="550"}
新增並檢視所選語言的語言變數。
新增語言變數
-
在Web編輯器中,移至「輸出」標籤。
-
選取 語言變數 左側面板中的 {width="25"}。
-
選取 編輯 以開啟 語言變數 視窗。 以選取的語言呈現的應用程式和使用者變數會依字母順序列出。 值會根據選取的語言顯示。 例如,如果您選取法文,則「提示」會顯示為「Conseil」。
-
從 語言 下拉式清單中,選取您要編輯變數的所需語言。
note note NOTE 如果您沒有檢視所需的語言,請從 語言變數設定 啟用所需的語言。 選取設定 {width="25"}以開啟 語言變數設定 對話方塊。 -
在 Name 資料行中輸入變數名稱,並在 Value 資料行中輸入其值。
note note NOTE 您可以使用任何HTML內容作為變數值,以特定格式顯示變數值。 例如,您可以新增 <b>
標籤至變數值,以粗體顯示Publisher。 -
選取 新增語言變數 {width="25"}以新增語言變數至選取的語言。 將變數新增至一種語言會自動將其新增至所有語言。 您無法建立與現有變數同名的變數。 顯示錯誤。
匯出和匯入語言變數
Experience Manager Guides支援匯出和匯入以所選語言呈現的語言變數。 您可以輕鬆匯出所有語言變數以及定義的值。 這包括應用程式和使用者變數。 使用匯出的檔案在值中進行所需的變更,或將其當地語系化成其他語言。
您也可以匯入包含語言變數的XML檔案。 Experience Manager Guides只會匯入已定義的語言變數,包括應用程式和使用者變數。 它不會匯入任何尚未定義的變數。
匯出語言變數
若要匯出語言的語言變數,請從下拉式清單中選取語言,然後選取 匯出
{width="25"}。
它會建立格式為language_variable_<ln>
的XML檔案,其中<ln>
是所選語言的程式碼。 例如,language_variable_en.xml
代表英文,language_variable_fr.xml
代表法文。
匯入語言變數
若要匯入語言變數:
-
從下拉式清單中選取語言,然後選取 匯入
{width="25"}
。
-
瀏覽並選取包含語言變數的XML。 例如,language_variable_en.xml。
您可以匯入下列格式的XML檔案:
<?xml version="1.0" encoding="UTF-8"?>
<variables>
<variable id="note-important">Important: </variable>
<variable id="note-caution">Avertir: </variable>
<variable id="image-with-text">Text and image <img src="/content/dam/assets/images/image_with_text.png" /> </variable>
</variables>
匯入檔案後,系統就會匯入具有相同ID的變數。 所選取語言中的變數值會以XML檔案中的變數值更新。 畫面上會顯示已更新變數數目的相關訊息。
- 如果檔案不是XML檔案,或如果檔案包含不正確的格式,且未與語言變數對應,您會檢視錯誤,指出XML檔案有問題。 >
- 如果檔案未包含具有相同ID的變數,您會檢視警告,指出匯入的檔案中找不到相符的語言變數。
語言變數的選項
將滑鼠停留在變數上以檢視它的 選項 功能表。
{width="550"}
使用 選項 功能表來刪除、預覽或複製語言變數。
您可以預覽應用程式和使用者變數。 若要檢視變數值在輸出中的顯示方式,請從所選變數的 選項 選單中選取 預覽。
您也可以選擇 刪除 或 複製 使用者變數。 從一種語言刪除變數會自動從所有語言刪除它。
編輯或還原應用程式變數
您也可以編輯應用程式變數的值。 稍後,您可以將應用程式變數回覆成原始值。 還原變數 {width="25"}會針對值已變更的應用程式變數顯示。
在輸出範本中使用語言變數
您應在當地語系化檔案中新增語言變數。 您可以在出現於本地化檔案中不同頁面的版面配置中插入這些語言變數。 例如,您可以為出現在頁面配置頁首區域(或任何其他部分,如頁尾或內文)中的author-name
新增語言變數。
{width="550"}
在針對法文語言產生的PDF輸出中本地化的作者與品牌名稱。
若要在標頭區域中插入語言變數(如copyright-label
),請執行下列步驟:
-
開啟編輯所需的版面配置。
note note NOTE 檢視自訂頁面配置區段,以開啟頁面配置以供自訂或編輯。 -
選取標頭,將其設為使用中以插入變數。
-
選取 插入變數 工具列中的 {width="25"}。
-
在 插入變數 快顯視窗中,選取要插入的語言變數名稱,然後按一下 插入,將其插入標頭區域。
note note NOTE 您也可以在文字方塊中輸入搜尋字串。 包含指定字串的變數名稱會經過篩選,並顯示在清單中。
選取的語言變數會插入頁首區域中。
{width="550"}
已在標頭區域中新增copyright-label
。
將內容樣式套用至語言變數
除了您指派給語言變數的值之外,您也可以使用HTML標籤,以特定格式顯示變數值。 例如,您可以以粗體顯示publisher-label
的值。
-
您也可以使用標籤來格式化值的樣式。 例如,使用page-number語言變數,您可以用英文以羅馬數字格式顯示頁碼,並指定其他語言的格式。
英文的值:
<span data-field="page-number" data-format="upper-roman">1</span>
泰米爾文的值:
<span data-field="page-number" data-format="tamil">1</span>
同樣地,您可以新增語言變數,並格式化列在頁面配置圖插入欄位功能中的其他欄位。 如需新增欄位的詳細資訊,請檢視新增欄位和中繼資料。
-
您也可以在值中新增本地化的影像。 例如,您可以使用章節編號語言新增影像圖示,並在PDF輸出中取得圖示的本地化影像。
如果是英文,影像的變數值可以類似於
<img src="banner-en.jpg">
,而相同變數的德文可以是<img src="banner-de.jpg">
。 因此,它會根據語言挑選影像。
使用CSS樣式本地化字串
使用CSS樣式,您也可以本地化Autonumber中使用的字串,例如Chapter、Section、Figure和Table。 由於這些字串來自CSS檔案,因此您無法使用語言變數將其當地語系化。 若要將這些字串當地語系化,您可以針對您想要當地語系化的每種語言建立CSS樣式。
例如,您可以使用以下CSS以各種語言顯示章節首碼和對應的數字格式。
例如,您可以使用以下CSS將章節以德文顯示為Hoofdstuk,將章節編號以小數格式顯示。 如果是日文,您可以使用日文數字格式,在目錄中顯示章節編號。
// for English
h1:before {
counter-increment: h11;
content: "Chapter " counter(h11, decimal)".";
}
// for German
:root:lang(de) h1:before {
content: "Hoofdstuk " counter(h11, decimal)".";
}
// for Japanese
:root:lang(ja) h1:before {
content: "章 " counter(h11, japanese-formal)".";
}
下列熒幕擷取畫面顯示德文和日文PDF輸出的當地語系化字串。
{width="550"}
{width="550"}
格式化字首
使用CSS樣式,您也可以格式化字首。 例如,您可以設定標籤Note
的格式,使其以紅色顯示在各種語言的PDF輸出中。
.note .prefix-content
{
color: red;
}