AEM網站 id205BE3008SW

Last update: Wed Apr 24 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
Publishing

建立對象：

User

下列選項可用於AEM Site輸出：

您可以透過兩種方式建立AEM網站預設集：

從網頁編輯器： 在「存放庫」面板中，在「地圖檢視」中開啟DITA map檔案，然後在「輸出」標籤中，選取+圖示以建立輸出預設集，然後從「新增預設集」對話方塊的型別下拉式清單中選取「AEM網站」。在Web編輯器中，這些設定已整理在「一般」和「進階」標籤下：

一般

此一般索引標籤包含以下設定：

網站名稱
輸出路徑
現有的輸出頁面
刪除孤立的網站頁面
套用條件使用\（如果條件為對映定義\）
使用基準線\（如果為地圖建立了基準線\）
貼文產生工作流程

進階

進階標籤包含以下設定：

下載暫存檔案
為每個主題產生個別PDF
使用地圖屬性作為預設值

如需詳細資訊，請參閱 AEM網站設定.

從地圖儀表板

若要開啟AEM Site的輸出預設集，請從Assets UI按一下DITA map檔案，然後按一下輸出預設集，再按一下AEM Site輸出選項。在map控制面板中，按一下編輯以更新各種設定，然後按一下儲存.

TIP

請參閱 AEM網站發佈 區段，以取得建立AEM網站輸出相關的最佳實務。

AEM網站設定 id_aem_site_config

下列選項可用於AEM Site輸出：

AEM Site選項

說明

輸出類型

您要產生的輸出型別。若要產生回應式AEM網站輸出，請選擇AEM網站選項。

設定名稱

為您正在建立的AEM網站設定提供描述性名稱。例如，您可以指定 內部客戶輸出 或 一般使用者輸出.

網站名稱

儲存輸出至AEM存放庫的網站名稱。

AEM存放庫中的節點會以此處指定的名稱建立。如果您未指定「場地名稱」，則會以DITA map檔案名稱建立場地節點。

您在此指定的網站名稱也會當作瀏覽器標籤中的標題。

您也可以在設定網站名稱時使用變數。如需使用變數的詳細資訊，請參閱使用變數來設定目的地路徑、網站名稱或檔案名稱選項.

設計

選取您要用來產生輸出的設計範本。

如需有關如何使用自訂設計範本產生輸出的詳細資訊，請聯絡您的發佈管理員。

目的地路徑

AEM存放庫內儲存輸出的路徑。在產生最終輸出時，網站名稱和目的地路徑會合併。例如，如果您將「場地名稱」指定為 user-guide 而目的地路徑為 /content/output/aem-guides，則最終輸出會在 /content/output/aem-guides/user-guide 節點。

您也可以在設定目的地路徑時使用變數。如需使用變數的詳細資訊，請參閱使用變數來設定目的地路徑、網站名稱或檔案名稱選項.

套用條件，使用

選取下列其中一個選項：

未套用任何：如果您不想對發佈的輸出套用任何條件，請選取此選項。
DITAVal檔案：選取DITAVal檔案以產生條件式內容。您可以使用瀏覽對話方塊或輸入檔案路徑來選取多個DITAVal檔案。使用檔案名稱附近的十字圖示可將其移除。 DITAVal檔案會依指定的順序計算，因此第一個檔案中指定的條件優先於後續檔案中指定的相符條件。您可以透過新增或刪除檔案來維持檔案順序。如果DITAVal檔案被移動到其他位置或被刪除，它不會自動從對映圖示板中刪除。您必須更新位置，才能移動或刪除檔案。您可以將滑鼠停留在檔案名稱上，以檢視儲存檔案的AEM存放庫中的路徑。您只能選取DITAVal檔案，如果您選取任何其他檔案型別，則會顯示錯誤。
條件預設集：從下拉式選單中選取條件預設集，以在發佈輸出時套用條件。如果您已為DITA map檔案新增條件，則會顯示此選項。條件設定可在DITA map主控台的「條件預設集」標籤中使用。若要進一步瞭解條件預設集，請參閱使用條件預設集.

現有的輸出頁面

選取 覆寫內容 覆寫現有頁面內容的選項。此選項只會覆寫存在於頁面內容和標題節點下方的內容。此選項可啟用混合式發佈內容。選取此選項可提供一個選項，讓您選取從已發佈輸出中刪除孤立頁面。這也是預設用於建立AEM網站輸出的選項。

選取 刪除並建立 選項，可在發佈期間強制刪除任何現有頁面。此選項會刪除頁面節點，及其內容和其下的所有子頁面。如果您已變更輸出預設集的設計範本，或想要移除目的地中已存在的任何額外頁面，請使用此選項。

刪除孤立的網站頁面

選取 覆寫內容 在 現有的輸出頁面 設定會顯示此選項。如果您選取此選項，則會從已發佈的AEM網站中刪除所有孤立頁面。若要成功執行此功能，您必須發佈整個DITA map，而不使用增量發佈。

假設您已發佈DITA map，其中包含主題a.dita、b.dita和c.dita。再次發佈對應之前，您已從對應移除b.dita主題。現在，如果您已選取此選項，則會從AEM網站輸出中移除與b.dita相關的所有內容，並且僅發佈a.dita和c.dita。

此功能不會移除任何已發佈的子對應。例如，如果您的父對映包含子對映，而您移除整個子對映，則不會從發佈的輸出中刪除子對映內容。不過，如果您從子地圖中移除任何主題並重新發佈，則移除的主題內容會從網站輸出中刪除。

此外，如果有任何參考內容，且在重新發佈前已移除該內容，則不會移除參考內容的資料。

注意：有關已刪除孤立頁面的資訊也會擷取至輸出產生記錄中。如需有關存取記錄檔的詳細資訊，請參閱檢視並檢查記錄檔.

下載暫存檔案

選取此選項可下載DITA-OT產生的暫存檔案。可以在輸出產生記錄中找到DITA-OT儲存暫存檔的位置。如果您在透過DITA-OT產生輸出時發生錯誤，請選取此選項以保留暫存檔案。然後，您可以使用這些檔案來疑難排解輸出產生錯誤。

產生輸出後，選取 下載暫存檔案

圖示可下載包含暫存檔的ZIP資料夾。

注意：如果您選取一些檔案屬性，然後下載暫存檔，您也會取得 metadata.xml ZIP資料夾中的檔案。

為每個主題產生個別PDF

如果選取，也會針對DITA map中的每個主題建立PDF。選擇此選項時，會顯示新的「分割PDF路徑」選項。

在「分割PDF路徑」欄位中，指定儲存針對每個主題產生的PDF的路徑。

注意： AEM Guides使用名為pdfx的DITA-OT外掛程式來產生每個主題的PDF。此外掛程式隨附於現成可用的DITA-OT套件。您可以自訂此外掛程式，以根據您的需求產生PDF。如果您使用自訂DITA-OT外掛程式，請確定您整合pdfx外掛程式，以擁有主題層級的PDF產生功能。

執行後期產生工作流程

選擇此選項時，會顯示新的「產生後工作流程」下拉式清單，其中包含AEM中設定的所有工作流程。您必須選取要在輸出產生工作流程完成後執行的工作流程。

使用基準線

如果您已經為選取的DITA map建立基準線，請選取此選項以指定要發佈的版本。

重要：當您產生AEM Site的增量輸出時，會使用檔案的目前版本而不是附加的基準線來建立輸出。

另請參閱使用基準線以取得詳細資訊。

檔案屬性

選取您要當作中繼資料處理的屬性。這些屬性是從DITA map或bookmap檔案的「屬性」頁面設定的。您從下拉式清單選取的屬性會顯示在 檔案屬性 欄位。選取屬性旁的十字圖示以將其移除。

注意：中繼資料屬性區分大小寫。

如果您已選取「基準線」，則特性的值會以所選「基準線」的版本為基礎。 如果您尚未選取「基準線」，則屬性的值會根據最新版本。

您也可以使用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 內容會顯示在搜尋結果中。

NOTE

如果您已為以下專案產生個別頁面： conref 內容若使用AEM Guides 3.5版或較舊版本，建議使用清除/刪除這些頁面刪除孤立的網站頁面選項。