地圖主控台中的AEM Sites預設集
您可以從「地圖」控制檯建立AEM Sites預設集,並將其設定為產生AEM Sites輸出。 建立AEM Sites輸出的方式有兩種:
使用複合元件對應
相較於舊版元件對應,複合元件對應提供更快速且可擴充的發佈至AEM Sites。 隨附立即可用的可編輯範本,您可視需求使用AEM範本編輯器加以自訂。 範本運用WCM核心元件和專業guides-components
的混合,以確保您的使用者在您的AEM Sites頁面上獲得最佳體驗。 您也可以使用複合元件對應方法來自訂現有的範本。
Experience Manager Guides為建立AEM Sites提供預先定義的範本。 這些範本可協助您確保內容版面配置與結構的一致性。
- 根據這些預先定義的範本建立首頁。
- 您可以編輯主題範本,並根據您的需求套用樣式。
- 您也可以自訂現有的AEM Sites範本。
建立AEM Sites預設集
執行以下步驟,使用複合元件對應來建立AEM Sites預設集:
-
在對應主控台中開啟DITA map檔案。
-
在 輸出預設集 面板中,選取+圖示以建立輸出預設集。
-
從 新增輸出預設集 對話方塊的 型別 下拉式清單中選取 AEM Sites。
-
取消選取 使用舊版元件對應 選項。
-
選取 新增至目前的資料夾設定檔 選項,以在目前的資料夾設定檔中建立輸出預設集。
深入瞭解管理全域和資料夾設定檔輸出預設集。
-
選取「新增」。
隨即建立AEM Sites的預設集。
複合元件對映的AEM Sites預設集設定
- 內部部署軟體:深入瞭解如何下載並安裝內部部署軟體的AEM Sites範本。
- Cloud Service:進一步瞭解如何下載並安裝適用於Cloud Service的AEM Sites範本。
在「對映」主控台中,複合元件對應的預設組態選項會整理在下列標籤下:
- 一般
- 內容
- 主題清單
- 交叉對應參考
一般
一般 索引標籤包含下列組態選項:
您也可以在設定網站路徑時使用變數。 如需詳細資訊,請檢視使用變數來設定目的地路徑、網站名稱或檔案名稱選項
選取 重新整理
AEMG-Docs
,並將發佈路徑指定為aemg-docs-en/docs/product-abc.
,則會在aemg-docs-en/docs/product-abc/
中的crx/de
節點下產生AEM Sites輸出。主題標題:使用DITA主題的標題來建立Experience Manager網站名稱。
假設您已發佈DITA map,其中包含主題a.dita、b.dita和c.dita。 再次發佈對應之前,您已從對應移除b.dita主題。 現在,如果您已選取此選項,則會從AEM Sites輸出中移除與b.dita相關的所有內容,並且僅發佈a.dita和c.dita。
注意:有關已刪除頁面的資訊也會擷取到輸出產生記錄檔中。 如需有關存取記錄檔的詳細資訊,請檢視並檢查記錄檔。
警告:刪除主題時,已發佈網站的頁面會變成無法使用。 因此,在刪除主題之前,會顯示警告。 您必須確認以刪除它們。
- 刪除此路徑上其他來源建立的所有頁面:如果您選取此選項,會刪除其他地圖、個別主題或任何其他來源在此路徑上發佈的所有頁面。 已發佈網站的頁面也會變得無法使用。 因此,在刪除主題之前,會顯示警告。 您必須確認以刪除它們。
內容
Content 索引標籤包含下列組態選項:
無:如果您不想在發佈的輸出上套用任何條件,請選取此選項。
使用DITAVAL:選取DITAVal檔案以產生條件式內容。 您可以使用瀏覽對話方塊或輸入檔案路徑來選取多個DITAVal檔案。 使用檔案名稱附近的十字圖示可將其移除。 DITAVal檔案會依指定的順序計算,因此第一個檔案中指定的條件優先於後續檔案中指定的相符條件。 您可以透過新增或刪除檔案來維持檔案順序。 如果DITAVal檔案被移動到其他位置或被刪除,它不會自動從對映圖示板中刪除。 您必須更新位置,才能移動或刪除檔案。 您可以將滑鼠停留在檔案名稱上,檢視檔案儲存所在的AEM存放庫中的路徑。 您只能選取DITAVal檔案,如果您選取任何其他檔案型別,則會顯示錯誤。
條件預設集:從下拉式清單中選取條件預設集,以在發佈輸出時套用條件。 如果您已為DITA map檔案新增條件,則會顯示此選項。 條件設定可在DITA map主控台的「條件預設集」標籤中使用。 若要進一步瞭解條件預設集,請檢視使用條件預設集。
檔案(Assets)屬性
注意:中繼資料屬性區分大小寫。
如果您已選取「基準線」,則屬性的值會以所選「基準線」的版本為基礎。 如果您尚未選取「基準線」,則屬性的值會以最新版本為基礎。
您也可以使用DITA-OT發行將中繼資料傳遞至輸出。 如需詳細資料檢視,請使用DITA-OT將中繼資料傳遞至輸出。
注意:如果您尚未在[屬性]選項中定義
cq:tags
,則即使您已選取要發佈的基準線,cq:tags
的值也會從目前的工作復本中挑選出來。使用地圖屬性作為遞補
只能將字串、日期或長(單一和多值)屬性傳遞至AEM網站頁面。 字串型別屬性的中繼資料值不支援任何特殊字元(例如
@, #, " "
)。*此選項應與
Properties
選項搭配使用。主題清單
主題清單 索引標籤會顯示DITA map目前工作復本中的主題清單。 依預設,會包含所有主題。 您可以選取特定主題,並僅為其產生AEM Sites輸出。 例如,您已更新一些主題,因此您可以僅發佈這些主題,而非發佈整個DITA map。
交叉對應參考
此清單包含的主題包含具有scope ="peer"
的交叉對映參考。 您可以為其他DITA map中可用主題的交叉對映參照清單指定發佈內容,其中包含scope="peer"
。 如果您使用Experience Manager Guides (UUID)版本,此標籤就會出現。
如需詳細資訊,請參閱下方的使用連結的主題區段。
設定之後,儲存對預設集所做的變更,並選取「產生」以產生對應地圖的AEM Sites。
使用舊版元件對應
使用舊版元件對應來建立AEM Sites預設集的步驟,與上述複合元件對應一節中概述的步驟相同。 不過,在建立預設集時,請確定您在 新增輸出預設集 對話方塊中選取 使用舊版元件對應 選項。
在「對應」控制檯中,舊版元件對應的預設設定選項會整理在下列標籤下:
- 一般
- 內容
- 交叉對應參考
一般
一般 索引標籤包含下列組態選項:
AEM存放庫中的節點是以此處指定的名稱建立的。 如果您未指定「場地名稱」,則會以DITA map檔案名稱建立場地節點。
您在此指定的網站名稱也會當作瀏覽器標籤中的標題。
您也可以在設定網站名稱時使用變數。 如需詳細資訊,請檢視使用變數來設定目的地路徑、網站名稱或檔案名稱選項
user-guide
,並將輸出路徑指定為/content/output/aem-guides
,則最終輸出會在/content/output/aem-guides/user-guide
節點下產生。您也可以在設定輸出路徑時使用變數。 如需詳細資訊,請檢視使用變數來設定目的地路徑、網站名稱或檔案名稱選項
選取 刪除並建立 選項,以在發佈期間強制刪除任何現有頁面。 此選項會刪除頁面節點,及其內容和其下的所有子頁面。 如果您已變更輸出預設集的設計範本,或想要移除目的地中已存在的任何額外頁面,請使用此選項。
假設您已發佈DITA map,其中包含主題a.dita、b.dita和c.dita。 再次發佈對應之前,您已從對應移除b.dita主題。 現在,如果您已選取此選項,則會從AEM Sites輸出中移除與b.dita相關的所有內容,並且僅發佈a.dita和c.dita。
注意:有關已刪除頁面的資訊也會擷取到輸出產生記錄檔中。 如需有關存取記錄檔的詳細資訊,請檢視並檢查記錄檔。
警告:刪除主題時,已發佈網站的頁面會變成無法使用。 因此,在刪除主題之前,會顯示警告。 您必須確認以刪除它們。
如需有關如何使用自訂設計範本產生輸出的詳細資訊,請連絡您的發佈系統管理員。
產生輸出後,請選取 下載暫存檔
注意:如果在產生期間新增檔案屬性,輸出暫存檔也會包含包含包含這些屬性的 metadata.xml 檔案。
內容
Content 索引標籤包含下列組態選項:
無:如果您不想在發佈的輸出上套用任何條件,請選取此選項。
使用DITAVAL:選取DITAVal檔案以產生條件式內容。 您可以使用瀏覽對話方塊或輸入檔案路徑來選取多個DITAVal檔案。 使用檔案名稱附近的十字圖示可將其移除。 DITAVal檔案會依指定的順序計算,因此第一個檔案中指定的條件優先於後續檔案中指定的相符條件。 您可以透過新增或刪除檔案來維持檔案順序。 如果DITAVal檔案被移動到其他位置或被刪除,它不會自動從對映圖示板中刪除。 您必須更新位置,才能移動或刪除檔案。 您可以將滑鼠停留在檔案名稱上,檢視檔案儲存所在的AEM存放庫中的路徑。 您只能選取DITAVal檔案,如果您選取任何其他檔案型別,則會顯示錯誤。
條件預設集:從下拉式清單中選取條件預設集,以在發佈輸出時套用條件。 如果您已為DITA map檔案新增條件,則會顯示此選項。 條件設定可在DITA map主控台的「條件預設集」標籤中使用。 若要進一步瞭解條件預設集,請檢視使用條件預設集。
檔案(Assets)屬性
注意:中繼資料屬性區分大小寫。
如果您已選取「基準線」,則屬性的值會以所選「基準線」的版本為基礎。 如果您尚未選取「基準線」,則屬性的值會以最新版本為基礎。
您也可以使用DITA-OT發行將中繼資料傳遞至輸出。 如需詳細資料檢視,請使用DITA-OT將中繼資料傳遞至輸出。
注意:如果您尚未在[屬性]選項中定義
cq:tags
,則即使您已選取要發佈的基準線,cq:tags
的值也會從目前的工作復本中挑選出來。使用地圖屬性作為遞補
只能將字串、日期或長(單一和多值)屬性傳遞至AEM網站頁面。 字串型別屬性的中繼資料值不支援任何特殊字元(例如
@, #, " "
)。*此選項應與
Properties
選項搭配使用。交叉對應參考
此清單包含的主題包含具有scope ="peer"
的交叉對映參考。 您可以為其他DITA map中可用主題的交叉對映參照清單指定發佈內容,其中包含scope="peer"
。 如果您使用Experience Manager Guides (UUID)版本,此標籤就會出現。
如需詳細資訊,請參閱下方的使用連結的主題區段。
使用連結的主題
Experience Manager Guides可讓您使用peer @scope
建立主題參考。 然後,您可以從AEM Sites預設集定義這些參照的發佈內容,最後產生連結主題的輸出。
如需詳細資訊,請檢視從其他地圖產生連結主題的輸出。
執行下列步驟,指定交叉連結檔案的發佈內容:
-
開啟 交叉對應參考 標籤。 若要檢視此標籤,請確定
<xrefs>
具有唯一識別碼。 如果沒有<xrefs>
的唯一ID,系統會在編輯/儲存較舊內容時自動產生該ID。在下列情況下,您將無法檢視跨對應連結:
- 對於4.6版之前建立的預設集,「互動參照」索引標籤會停用,且工具提示「參考對映儀表板」會出現。
- 對於從對應儀表板建立的預設集,請參考對應儀表板 工具提示出現。
- 針對OOTB預設集,請參閱對應儀表板 工具提示出現。
- 對於全域預設集,請建立此全域預設集的本機副本,以設定交叉對映參照。
-
隨即顯示主題及其參照的清單
note note NOTE 交叉對應參考 索引標籤僅顯示使用 scope="peer"
連結的主題。 對於具有scope="local"
的連結,您不需要指定發佈內容。依預設,所有連結的主題都會選取其最新的輸出預設集和地圖。 所有連結主題的發佈內容預設為
<Most recently generated>
對應。 -
如果要使用地圖中每個相依檔案最近發佈的輸出,請選取 對所有相依主題使用最近產生的 發佈內容。
在發佈包含連結主題的地圖之前,您應該發佈選取為父對映的地圖。 如果含有已連結主題的地圖未發佈,則連結會在AEM Sites輸出中顯示為普通文字,而非超連結。
您應該為連結的主題選取相同型別的AEM Sites預設集。 例如,如果目前的AEM Sites預設集使用舊版元件對應,則選取連結主題的類似AEM Sites預設集。 -
在「父對映」下拉式清單中,選取要與其輸出連結目前對映輸出的對映檔案。
選取對應檔案會在「父系對應UUID」欄中顯示對應的UUID。 與所選地圖相關的輸出預設集會列在「父地圖」的「預設集」清單中。 例如,地圖A中的主題1包含對主題2的參照。 主題2可以出現在單一或多個地圖中。 您可以選取上層地圖和特定的預設集,或每個連結最近發佈的輸出。 -
如果同一主題在檔案中被參照多次,則您可以為每個執行個體新增不同的發佈內容。 這可提供更大的彈性並控制其內容。 例如,主題3同時存在於對映B和對映C中。主題1包含兩個對主題3的參照。 您可以選擇對應B作為第一個連結的父對應,選擇對應C作為第二個連結的父對應。
-
在「父對映」的「預設集」下拉式清單中,選取您要與目前對映的輸出連結的輸出預設集。
note note NOTE 目前地圖的其他AEM Sites預設集會出現在下拉式清單中。 如果您未選取預設集,則會出現警告圖示,且輸出產生會失敗。 -
為所有來源主題選取必要的對映及其輸出預設集,並選取 產生。
父級主題: 瞭解輸出預設集