AEM網站 id205BE3008SW
下列選項可用於AEM Site輸出:
您可以透過兩種方式建立AEM網站預設集:
從網頁編輯器: 在「存放庫」面板中,在「地圖檢視」中開啟DITA map檔案,然後在「輸出」標籤中,選取+圖示以建立輸出預設集,然後從「新增預設集」對話方塊的型別下拉式清單中選取「AEM網站」。 在Web編輯器中,這些設定已整理在「一般」和「進階」標籤下:
一般
此 一般 索引標籤包含以下設定:
- 網站名稱
- 輸出路徑
- 現有的輸出頁面
- 刪除孤立的網站頁面
- 套用條件使用\(如果條件為對映定義\)
- 使用基準線\(如果為地圖建立了基準線\)
- 貼文產生工作流程
進階
進階標籤包含以下設定:
- 下載暫存檔案
- 為每個主題產生個別PDF
- 使用地圖屬性作為預設值
如需詳細資訊,請參閱 AEM網站設定.
從地圖儀表板
若要開啟AEM Site的輸出預設集,請從Assets UI按一下DITA map檔案,然後按一下輸出預設集,再按一下AEM Site輸出選項。在map控制面板中,按一下 編輯 以更新各種設定,然後按一下 儲存.
AEM網站設定 id_aem_site_config
下列選項可用於AEM Site輸出:
AEM存放庫中的節點會以此處指定的名稱建立。 如果您未指定「場地名稱」,則會以DITA map檔案名稱建立場地節點。
您在此指定的網站名稱也會當作瀏覽器標籤中的標題。
您也可以在設定網站名稱時使用變數。 如需使用變數的詳細資訊,請參閱 使用變數來設定目的地路徑、網站名稱或檔案名稱選項.
如需有關如何使用自訂設計範本產生輸出的詳細資訊,請聯絡您的發佈管理員。
user-guide
而目的地路徑為 /content/output/aem-guides
,則最終輸出會在 /content/output/aem-guides/user-guide
節點。您也可以在設定目的地路徑時使用變數。 如需使用變數的詳細資訊,請參閱 使用變數來設定目的地路徑、網站名稱或檔案名稱選項.
未套用任何:如果您不想對發佈的輸出套用任何條件,請選取此選項。
DITAVal檔案:選取DITAVal檔案以產生條件式內容。 您可以使用瀏覽對話方塊或輸入檔案路徑來選取多個DITAVal檔案。 使用檔案名稱附近的十字圖示可將其移除。 DITAVal檔案會依指定的順序計算,因此第一個檔案中指定的條件優先於後續檔案中指定的相符條件。 您可以透過新增或刪除檔案來維持檔案順序。 如果DITAVal檔案被移動到其他位置或被刪除,它不會自動從對映圖示板中刪除。 您必須更新位置,才能移動或刪除檔案。 您可以將滑鼠停留在檔案名稱上,以檢視儲存檔案的AEM存放庫中的路徑。 您只能選取DITAVal檔案,如果您選取任何其他檔案型別,則會顯示錯誤。
條件預設集:從下拉式選單中選取條件預設集,以在發佈輸出時套用條件。 如果您已為DITA map檔案新增條件,則會顯示此選項。 條件設定可在DITA map主控台的「條件預設集」標籤中使用。 若要進一步瞭解條件預設集,請參閱 使用條件預設集.
選取 刪除並建立 選項,可在發佈期間強制刪除任何現有頁面。 此選項會刪除頁面節點,及其內容和其下的所有子頁面。 如果您已變更輸出預設集的設計範本,或想要移除目的地中已存在的任何額外頁面,請使用此選項。
假設您已發佈DITA map,其中包含主題a.dita、b.dita和c.dita。 再次發佈對應之前,您已從對應移除b.dita主題。 現在,如果您已選取此選項,則會從AEM網站輸出中移除與b.dita相關的所有內容,並且僅發佈a.dita和c.dita。
此功能不會移除任何已發佈的子對應。 例如,如果您的父對映包含子對映,而您移除整個子對映,則不會從發佈的輸出中刪除子對映內容。 不過,如果您從子地圖中移除任何主題並重新發佈,則移除的主題內容會從網站輸出中刪除。
此外,如果有任何參考內容,且在重新發佈前已移除該內容,則不會移除參考內容的資料。
注意:有關已刪除孤立頁面的資訊也會擷取至輸出產生記錄中。 如需有關存取記錄檔的詳細資訊,請參閱 檢視並檢查記錄檔.
產生輸出後,選取 下載暫存檔案 圖示可下載包含暫存檔的ZIP資料夾。
注意:如果您選取一些檔案屬性,然後下載暫存檔,您也會取得 metadata.xml ZIP資料夾中的檔案。
在「分割PDF路徑」欄位中,指定儲存針對每個主題產生的PDF的路徑。
注意: AEM Guides使用名為pdfx的DITA-OT外掛程式來產生每個主題的PDF。 此外掛程式隨附於現成可用的DITA-OT套件。 您可以自訂此外掛程式,以根據您的需求產生PDF。 如果您使用自訂DITA-OT外掛程式,請確定您整合pdfx外掛程式,以擁有主題層級的PDF產生功能。
重要:當您產生AEM Site的增量輸出時,會使用檔案的目前版本而不是附加的基準線來建立輸出。
另請參閱 使用基準線 以取得詳細資訊。
注意:中繼資料屬性區分大小寫。
如果您已選取「基準線」,則特性的值會以所選「基準線」的版本為基礎。 如果您尚未選取「基準線」,則屬性的值會根據最新版本。
您也可以使用DITA-OT發佈將中繼資料傳遞至輸出。 如需詳細資訊,請參閱 使用DITA-OT將中繼資料傳遞至輸出.
注意:如果您尚未定義
cq:tags
在「屬性」選項中,將其 cq:tags
即使「基準線」已選取發佈,也會從目前的工作復本中選取。只有字串、日期或長(單一和多值)屬性可以傳遞到AEM網站頁面。 字串型別屬性的中繼資料值不支援任何特殊字元(例如
@, #, " "
)。*此選項應與
Properties
選項。AEM網站上的其他附註
從網頁編輯器產生以文章為基礎的輸出
您可以從網頁編輯器產生一或多個主題的AEM網站輸出,或產生整個DITA map。 您需要為DITA map建立輸出預設集,然後就可以輕鬆為地圖產生AEM網站輸出。 如果您已更新地圖中的幾個主題,您也可以僅從網頁編輯器為這些主題產生AEM網站輸出。 如需詳細資訊,請參閱 從網頁編輯器以文章為基礎的發佈.
從其他地圖產生輸出連結主題
將大型檔案集分散到多個資料夾和DITA map中是非常常見的情況。 發佈從不同位置連結的內容會變得極為複雜。 依預設,所有連結 <xref>
使用建立 local
@scope
. 發佈這類主題不會有任何挑戰,因為它使用直接連結至主題。 如果主題在目前的DITA map之外,連結不會顯示連結的內容。
連結內容的另一種方式是使用建立連結 peer
@scope
. 對於此類內容,在執行階段會透過從DITA map的發佈內容中選取檔案標題和連結主題的已設定內容來解析連結。 下列熒幕擷圖顯示具有下列專案之連結的「屬性」面板: peer
@scope
:
{width="800"}
為簡化複雜地圖及連結至其他地圖中其他主題之主題的發佈作業,AEM Guides可讓您設定每個輸出預設集的發佈內容。
發佈內容可讓您指定必須從哪個對應使用哪個主題來發佈特定輸出。 讓我們透過範例來瞭解這一點 — 假設您有四個資料夾:範例a、範例b、範例c和範例d。每個資料夾都包含一個DITA map — DITA map A、DITA map B、DITA map C和DITA map D。當DITA map A中的主題連結到DITA map B、C或D中的主題時,就會發生交叉對映連結。在下列熒幕擷圖中,範例概念主題包含其他DITA map一部分檔案的連結\(或參照\)。
{width="350"}
現在,當您為包含此主題的對應檔案設定AEM網站發佈設定時,可以選取在發佈時所使用的連結內容發佈內容。 發佈內容是DITA map及其輸出預設集的組合。 輸出預設集又包含特定版本的內容和條件預設集。 這個DITA map、輸出預設集、(files)版本和條件的完整組合定義了連結地圖的發佈內容。
執行下列步驟,指定交叉連結檔案的發佈內容:
-
開啟 輸出預設集 要發佈的DITA map標籤。
-
選取 AEM網站 輸出預設集。
您可以取得「AEM預設集設定」和「發佈內容」標籤。
{width="800"}
-
開啟 發佈內容 標籤。
您會看到相依主題的清單。 這些是從目前地圖中的某個主題連結的主題,但它們可用於其他一些DITA地圖。
note note NOTE 「發佈前後關聯」標籤會顯示透過以下連結的主題: peer
@scope
僅限。 連結的對象local
@scope
,您不需要指定發佈內容。依預設,所有連結的主題都會選取其最新的輸出預設集和地圖。
{width="800"}
-
若要變更DITA map和預設集的預設選取範圍,請按一下 編輯 \(在主工具列中\)。
-
如果要使用地圖中每個相依檔案最近發佈的輸出,請選取 對所有相依主題使用最近產生的發佈內容.
-
在 父對應 從下拉式清單中,選取您要用來連結目前對映輸出的對映檔案。
選取對應檔案時,對應的UUID會顯示在「父對應UUID」欄中。 與所選地圖相關的輸出預設集會列在「父地圖」的「預設集」清單中。
-
在 父級地圖的預設集 下拉式清單,選取您要連結目前地圖輸出的輸出預設集。
-
為所有相依主題選取所需的對映及其輸出預設集,然後按一下 完成.
相依主題的內容現已設定。 您可以產生目前對應的輸出。 如需有關產生輸出的詳細資訊,請參閱 從Map主控台產生DITA Map的輸出.
混合式發佈
AEM Guides支援在現有AEM網站中發佈DITA內容。 例如,如果您有現有網站,您可以使用AEM網站輸出僅在該網站上發佈DITA內容。 在此程式中,發佈程式不會修改現有的非DITA內容。 如需將網站設定為僅發佈DITA內容的詳細資訊,請連絡您的發佈管理員。
發佈 conref
如果您使用 conref
然後,在您的內容中,它會以一般或內嵌內容的形式發佈,並連同來源\(或反向連結\)主題中的內容一起發佈。 此 conref
內容會與主要內容一起呈現,不會為相同內容建立單獨的網站頁面。 當您搜尋中參照的內容時 conref
,則只有主要主題或頁面包含 conref
內容會顯示在搜尋結果中。
conref
內容若使用AEM Guides 3.5版或較舊版本,建議使用清除/刪除這些頁面 刪除孤立的網站頁面 選項。搜尋內容中的字串
您可以在AEM Site輸出中搜尋字串。 依預設,您只能在標題中搜尋字串。 若要搜尋AEM網站輸出內容或本文中的字串,請聯絡您的系統管理員以啟用flattening.enabled屬性。
{width="650"}
如需詳細資訊,請參閱 設定AEM網站節點結構的平面化 安裝與設定Adobe Experience Manager指南中的區段。
父級主題: 瞭解輸出預設集