設定輸出產生設定 id181AI0B0E30

AEM Guides隨附許多設定選項，供您自訂輸出產生程式。 本主題涵蓋可協助您設定輸出產生程式的所有設定和自訂。

在DITA map圖示板上設定基準線標籤 id223MD0D0YRM

若要隱藏DITA map圖示板上的「基準線」標籤，請執行下列步驟：

在現有AEM網站中設定混合發佈 id1691I0V0MGR

如果您的AEM網站包含DITA內容，您可以設定AEM網站輸出，將DITA內容發佈至網站內預先定義的位置。 例如，在以下AEM Site頁面的熒幕擷圖中， ditacontent 節點已保留以儲存DITA內容：

頁面中的其餘節點會直接從AEM網站編輯器撰寫。 將發佈設定設為將DITA內容發佈至預先定義的位置，可確保不會由AEM Guides發佈程式修改任何現有的非DITA內容。

您需要在現有網站上執行下列設定，以允許將DITA內容發佈到預先定義的節點：

執行以下步驟來設定您現有網站的範本屬性：

下次當您使用網站的範本設定發佈任何DITA內容時，該內容會發佈到 topicContentNode 和 topicHeadNode 屬性。

自訂AEM網站輸出 id166TG0B30WR

AEM Guides支援以下列格式建立輸出：

對於AEM Site輸出，您可以為不同的輸出任務指派不同的設計範本。 這些設計範本可以不同的版面配置呈現DITA內容。 例如，您可以為內部和外部對象指定不同的設計範本。

您也可以使用自訂的DITA Open Toolkit (DITA-OT)外掛程式搭配AEM Guides。 您可以上傳這些自訂DITA-OT外掛程式，以特定方式產生PDF輸出。

自訂設計範本以產生輸出 customize_xml-add-on

AEM Guides使用一組預先定義的設計範本來產生AEM Site輸出。 您可以自訂AEM Guides設計範本，以產生符合您公司品牌的輸出結果。 設計範本是各種樣式(CSS)、指令碼\（伺服器端和使用者端\）、資源\（影像、標誌和其他資產\）以及將所有這些資源繫結在一起的JCR節點的集合。 設計範本可以像單一伺服器端指令碼一樣簡單，只包含幾個JCR節點，或樣式、資源和JCR節點的複雜組合。 AEM Guides發佈子系統會在產生AEM Site輸出時使用設計範本，這些範本可控制所產生輸出的結構、外觀和風格。

設計範本資源在伺服器上的放置位置沒有限制，但通常會根據其功能進行邏輯組織。 例如，預設範本的所有JavaScript和CSS檔案都儲存在 /etc/designs/fmdita/clientlibs/siteoutput/default 資料夾。 無論這些檔案位於何處，都會由JCR節點集合連結在一起。 這些JCR節點和檔案共同構成了整個設計範本。

AEM Guides隨附的預設設計範本可讓您自訂登陸、主題和搜尋頁面元件。 您可以複製預設設計和對應的參照範本，並指定不同的元件以產生所需的輸出。

執行以下步驟，指定您自己的設計範本，以用於AEM Site輸出產生：

如需詳細資訊，請參閱 建立您的第一個Adobe Experience Manager網站 和 基本資訊 在AEM上開發您自己的網站。

使用檔案標題來產生AEM網站輸出

產生AEM Site輸出時，產生URL的方式在內容的可發現性方面扮演重要角色。 如果您使用UUID型檔案名稱，根據檔案的UUID產生URL將不利於搜尋。 身為管理員或發佈者，您可以控制要如何產生AEM Site輸出的URL。 AEM Guides提供設定，您可選擇使用檔案標題而非UUID型檔案名稱來產生AEM Site輸出的URL。 對於以UUID為基礎的檔案系統，此選項預設為開啟。 這表示當您產生UUID型檔案系統的AEM Site輸出時，會使用檔案的標題來產生URL，而非檔案的UUID。

使用中提供的指示 設定覆寫 以建立組態檔。 在設定檔案中，提供下列(property)詳細資訊，以設定AEM Site輸出中的URL產生：

設定AEM網站輸出的URL以使用檔案標題

您可以在AEM Site輸出的URL中使用檔案標題。 如果檔案名稱不存在或包含所有特殊字元，您可以設定系統在AEM Site輸出的URL中，以分隔符號取代特殊字元。 您也可以將其設定為使用第一個子主題名稱來取代。

若要設定頁面名稱，請執行下列步驟：

例如，如果 @navtitle 在 <topichead> 包含所有特殊字元，而您設定 aemsite.pagetitle 屬性設為true，則預設會使用分隔符號。 如果您設定 nodename.systemDefinedPageName 屬性設為true，會顯示第一個子系主題的名稱。

設定檔案名稱清理規則，以建立主題和發佈AEM網站輸出 id2164D0KD0XA

作為管理員，您可以定義檔案名稱中允許的有效特殊字元清單，這些字元最終會形成AEM Site輸出的URL。 在舊版中，使用者可定義包含特殊字元的檔案名稱，例如 @， $， >、等等。 這些特殊字元會在產生AEM網站頁面時產生編碼的URL。

自3.8發行版本開始，已新增設定以定義檔案名稱中允許的特殊字元清單。 依預設，有效的檔案名稱設定包含"a-z A-Z 0-9 - _「。 這表示在建立檔案時，檔案標題中可以有任何特殊字元，但在內部會以連字型大小取代(-)的檔案名稱。 例如，您可以將檔案的標題設為Introduction 1或Introduction@1，針對這兩種情況產生的對應檔案名稱都是Introduction-1。

定義有效字元清單時，請記得這些字元»*/:[\]|#%{}?&<>"/+」和 a space 將一律以連字型大小取代(-)。

使用中提供的指示 設定覆寫 以建立組態檔。 在設定檔案中，提供下列(property)詳細資訊，以便在檔案名稱和AEM Site輸出中設定有效的特殊字元：

您也可以設定其他屬性，例如檔案名稱中的使用小寫、處理無效字元的分隔符號，以及檔案名稱中允許的最大字元數。 若要設定這些屬性，請在設定檔案中新增下列機碼值組：

設定AEM網站節點結構的平面化

產生AEM Site輸出時，主題中每個元素的節點都會在內部建立。 對於包含數千個主題的DITA map，此節點結構可能會變得太深。 對於較大的網站，這種深度巢狀節點結構可能會出現效能問題。 下列快照會顯示AEM Site輸出的深度巢狀節點結構：

在上述快照中，請注意每個都會建立一個節點， p 元素及其後續子元素和類似結構會針對主題中使用的其他所有元素而建立。

AEM Guides可讓您設定AEM Site輸出的節點結構在內部建立的方式。 您可以在指定元素處平面化節點結構，這表示您可以定義元素，將其視為主要元素，其內的所有子元素將與主要元素合併。 例如，如果您決定將 p 元素，然後出現在 p 元素將會與主要 p 元素。 系統不會為中的任何子元素建立單獨的附註。 p 元素。 下列快照顯示展平於的節點結構 p 元素：

若要平面化AEM Site節點結構，請執行下列步驟：

現在，當您產生AEM Site輸出時， p 元素會平面化並儲存在 p 元素本身。 您可以找到新的平面化屬性 p CRXDE中的元素。

在AEM Site輸出的內容中搜尋字串

依預設，您只能在AEM Site輸出中搜尋標題中的字串。 您可以設定系統以搜尋字串，同時搜尋標題以及AEM Site輸出的內容或內文。

若要啟用搜尋，您應該設定AEM Site節點結構的平面化。

注意:

您最多可以搜尋1MB的平面化內容。 例如，在上一個熒幕擷圖中，您可以搜尋下方的內容 <p> 標籤小於= 1Mb。

防止AEM網站節點結構平面化

與在AEM Site輸出中指定要平面化的節點類似，您也可以指定要從此設定中排除的元素。 例如，如果您想將節點平面化於 body 元素，但您不想要任何 table 元素在內 body 若要平面化，您可以在 table 元素的定義。

若要排除 table 將元素平面化，將下列屬性新增至 table 元素的定義：

<preventancestorflattening>true|false</preventancestorflattening>

在AEM網站輸出中設定已刪除頁面的版本設定

當您使用產生AEM Site輸出時 刪除和 ​建立​ ​ ​為「現有輸出頁面」設定選取的選項，會為要刪除的頁面建立版本。 您可以設定系統在刪除前停止建立版本。

執行以下步驟，停止建立要刪除之頁面的版本：

使用Experience Manager指南設定自訂重寫程式 custom-rewriter

「Experience Manager指南」有自訂Sling 重寫程式 用於處理交叉地圖情況下產生的連結的模組（兩個不同地圖主題之間的連結）。 此重寫程式組態會安裝在下列路徑：
/apps/fmdita/config/rewriter/fmdita-crossmap-link-patcher。

如果您的程式碼基底中有另一個自訂Sling重寫程式，請使用 'order' 值大於50，因為Experience Manager指南sling重寫程式使用 'order' 50. 若要覆寫此值，您需要大於50的值。 如需詳細資訊，請檢視 輸出重寫管道.

透過DITA-OT在發佈輸出中使用中繼資料 id191LF0U0TY4

AEM Guides提供在使用DITA-OT發佈輸出時傳遞自訂中繼資料的方法。 作為管理員和發佈者，您需要執行以下任務以在發佈輸出中設定和使用自訂中繼資料：

若要在系統中新增必要的中繼資料，請執行下列步驟：

現在，所有DITA map的「屬性」頁面中都會顯示新引數。

接下來，您需要在DITA map主控台中提供自訂中繼資料。 執行下列步驟，讓自訂中繼資料可在DITA map虛線板上使用：

現在，自訂中繼資料會顯示在DITA map主控台的 屬性 下拉式清單。

最後，身為「發佈者」，您需要在發佈的輸出中包含自訂中繼資料。 若要在產生輸出時處理自訂中繼資料，請執行下列步驟：

選取的屬性/中繼資料會傳遞至發佈程式，並可在最終輸出中使用。

驗證傳遞至DITA-OT以進行處理的中繼資料

為了驗證傳遞至DITA-OT的中繼資料值，可以使用使用雲端就緒jar的本機環境。 由於我們無法在雲端上存取本機檔案系統，因此驗證中繼資料檔案的唯一方式是透過雲端就緒的jar。

使用AEM元件自訂DITA元素對應 id1679J600HEL

AEM Guides中的DITA元素會對應至其對應的AEM元件。 AEM Guides在工作流程（例如發佈和稽核）中使用此對應，將DITA元素轉換為對應的AEM元件。 該對應定義於 elementmapping.xml 檔案，可使用封裝管理員進行存取。

您可以使用預先定義的DITA元素對映，也可以將DITA元素對映至自訂AEM元件。 若要使用自訂AEM元件，您必須瞭解 elementmapping.xml 檔案。

elementmapping.xml結構

概略說明 elementmapping.xml 結構說明如下：

DITA元素結構描述

以下為中的DITA元素結構描述範例 elementmapping.xml 檔案：

<ditaelement>
    <name>element_name</name>
    <class>element_class</class>
    <componentpath>fmdita/components/dita/component_name</componentpath>
    <type>COMPOSITE|STANDALONE</type>
    <attributeprop>propname_a</attributeprop>
    <textprop>propname_t</textprop>
    <xmlprop>propname_x</xmlprop>
    <xpath>xpath expression string</xpath>
    <target>head|para</target>
    <wrapelement>div</wrapelement>
    <wrapclass>class_name</wrapclass>
    <attributemap>
        <attribute from="attrname"         to="propname"         ispath="true|false"         rel="source|target" />
    </attributemap>
    <skip>true|false</skip>
</ditaelement>

下表說明DITA元素結構描述中的元素：

其他附註

自訂DITA map主控台 id188HC08M0CZ

AEM Guides可讓您彈性擴充DITA map主控台的功能。 例如，如果您有一組與AEM Guides中可用的報表不同，您可以將這類報表新增至地圖主控台。 若要自訂對應主控台，您必須建立AEM使用者端程式庫\（或ClientLib\），其中包含執行所需功能的程式碼。

AEM指南提供 apps.fmdita.dashboard-extn 用於自訂地圖主控台的類別。 每當載入地圖主控台時，在 apps.fmdita.dashboard-extn 類別會執行並載入。

在產生輸出期間處理影像轉譯 id177BF0G0VY4

AEM隨附一組預設工作流程和媒體控制代碼以處理資產。 在AEM中，有預先定義的工作流程可處理最常見MIME型別的資產處理。 一般而言，AEM會針對您上傳的每個影像，以二進位格式建立相同的多個轉譯。 這些轉譯可能大小不同、解析度不同、加上浮水印或其他已變更的特性。 如需AEM如何處理資產的詳細資訊，請參閱 使用媒體處理常式和工作流程處理資產 在AEM檔案中。

AEM Guides可讓您設定在為檔案產生輸出時要使用的影像轉譯。 例如，您可以選擇其中一個預設影像轉譯，或建立並使用相同的影像轉譯來發佈檔案。 用於發佈檔案的影像轉譯對應會儲存在 /libs/fmdita/config/ **renditionmap.xml** 檔案。 片段 renditionmap.xml 檔案如下：

<renditionmap>
   <mapelement>
      <mimetype>image/png</mimetype>
      <rendition output="AEMSITE">cq5dam.web.1280.1280.jpeg</rendition>
      <rendition output="PDF">original</rendition>
      <rendition output="HTML5">cq5dam.web.1280.1280.jpeg</rendition>
      <rendition output="EPUB">cq5dam.web.1280.1280.jpeg</rendition>
      <rendition output="CUSTOM">cq5dam.web.1280.1280.jpeg</rendition>
   </mapelement>
...
</renditionmap>

此 mimetype 元素會指定檔案格式的MIME型別。 此 rendition output element指定輸出格式的型別和轉譯的名稱(例如， cq5dam.web.1280.1280.jpeg)來發佈指定的輸出。 您可以指定用於所有支援輸出格式的影像轉譯 — AEMSITE、PDF、HTML5、EPUB和CUSTOM。

如果指定的轉譯不存在，AEM Guides發佈程式會先尋找指定影像的網頁轉譯。 如果找不到網頁轉譯，則會使用影像的原始轉譯。

設定輸出記錄的自動永久刪除期間 id19AAI070V8Q

產生輸出時，會建立輸出與輸出記錄。 對於大型DITA map，這些記錄可能會佔用存放庫中的大量空間。 依預設，記錄檔會儲存在存放庫的下列位置：

/var/dxml/metadata/outputHistory

在一段時間內，所有記錄檔的集體大小可能會達到GB。 AEM Guides可讓您設定將這些記錄檔保留在存放庫中的時段。 在指定的時段後，記錄以及輸出產生歷史記錄會從存放庫中刪除。

設定歷史記錄清除功能會影響儲存庫中所有DITA map的輸出產生。 在DITA map的「輸出」標籤中，在指定的天數之後，以及在設定中指定的時間清除歷史記錄。

使用中提供的指示 設定覆寫 以建立組態檔。 在設定檔中，提供下列(property)詳細資訊，以設定清除輸出歷史記錄和記錄檔的日期和時間：

變更最近產生的輸出清單限制 id1679JH0H0O2

您可以變更DITA map在「輸出」標籤中顯示的已產生輸出最大數目。

使用中提供的指示 設定覆寫 以建立組態檔。 在設定檔案中，提供下列(property)詳細資訊，以變更要在清單中顯示的輸出數量：