設定輸出產生設定 id181AI0B0E30

開啟Adobe Experience Manager Web主控台設定頁面。

存取設定頁面的預設URL為：

http://<server name>:<port>/system/console/configMgr

搜尋並按一下​ com.adobe.fmdita.config.ConfigManager ​套件。

選取​ 隱藏基準線索引標籤 ​選項。

按一下​儲存。

登入AEM並開啟CRXDE Lite模式。

導覽至您網站的範本設定節點。 例如，AEM Guides會將預設範本設定儲存在下列節點中：

/libs/fmdita/config/templates/default

新增下列屬性：

登入AEM並開啟CRXDE Lite模式。

在您的網站節點中找到jcr:content。

新增與您在網站的範本設定中指定的名稱相同的topicContentNode和topicHeadNode節點。

登入AEM並開啟CRXDE Lite模式。

導覽至預設的設計範本節點。 預設設計範本節點的位置為：

/libs/fmdita/config/templates/

{width="300"}

按一下​ 範本 ​節點中的​ 預設 ​元件以存取其屬性。

下表說明AEM Guides的設計範本屬性。

開啟Adobe Experience Manager Web主控台設定頁面。

存取設定頁面的預設URL為：

http://<server name>:<port>/system/console/configMgr

搜尋並按一下​ com.adobe.fmdita.config.ConfigManager ​套件。

選取​ 使用AEM網站頁面名稱的標題 ​選項。

按一下​儲存。

開啟Adobe Experience Manager Web主控台設定頁面。

存取設定頁面的預設URL為：

http://<server name>:<port>/system/console/configMgr

搜尋並按一下​ com.adobe.fmdita.common.SanizeNodeNameImpl ​套件。

在​ 不允許發佈至AEM Sites ​屬性的字元集中，確定屬性已設為'<>`@$。 您可以在此清單中新增更多特殊字元，但是它必須包含這些必要的特殊字元。

按一下​儲存。

搜尋並按一下​ com.adobe.fmdita.config.ConfigManager ​套件。

在​ 有效字元的Regex ​屬性中，確定屬性已設為[-a-zA-Z0-9_]。 您可以新增更多字元至此清單，但清單必須包含這些基本字元，且清單必須以連字型大小(-)開頭。

按一下​儲存。

指定您要平面化節點結構的元素。

1. 覆蓋libs節點中的apps節點，並開啟elementmapping.xml檔案。

2. 在您要平面化節點結構的元素定義中新增<flatten>true</flatten>屬性。 例如，如果您想要平面化p元素的節點結構，請在p元素的定義中新增flatten屬性，如下所示：

   code language-xml
   <ditaelement> <name>p</name> <class>- topic/p</class> <componentpath>fmdita/components/dita/wrapper</componentpath> <type>COMPOSITE</type> <target>para</target> <flatten>true</flatten> <wrapelement>div</wrapelement> </ditaelement>

   note note
   NOTE
   根據預設，flatten node屬性已在p專案上設定。

在configMgr中啟用網站節點平面化設定。

1. 開啟Adobe Experience Manager Web主控台設定頁面。

   存取設定頁面的預設URL為：

   code language-http
   http://<server name>:<port>/system/console/configMgr

2. 搜尋並按一下​ com.adobe.dxml.flattening.FlatteningConfigurationService ​組合。

3. 選取​ 屬性flattening.enabled ​選項。

4. 按一下​儲存。

開啟Adobe Experience Manager Web主控台設定頁面。

存取設定頁面的預設URL為：

http://<server name>:<port>/system/console/configMgr

搜尋並按一下​ com.adobe.fmdita.config.ConfigManager ​套件。

選取​ 不要建立已刪除頁面的版本 ​選項。

按一下​儲存。

以管理員身分登入Adobe Experience Manager。

按一下頂端的Adobe Experience Manager連結，然後選擇​工具。

從工具清單中選取​Assets。

按一下​ 中繼資料結構 ​圖磚。

此時會顯示「中繼資料結構Forms」頁面。

從清單中選取​ 預設 ​表單。

按一下「編輯」。

新增您要在發佈的輸出中使用的自訂中繼資料。 例如，我們將使用下列步驟新增對象中繼資料：

1. 從​ 建置表單 ​元件清單中，將​ 單行文字 ​元件拖放至表單上。

2. 選取新欄位以開啟欄位的​設定。

3. 在​ 欄位標籤 ​中，輸入中繼資料名稱 — Audience。

4. 在​ 對應至屬性 ​設定中，指定。/jcr:content/metadata/<中繼資料的名稱>。 例如我們的範例，我們將其設為。/jcr:content/metadata/audience。

使用這些步驟，新增所有必要的中繼資料引數。

按一下​儲存。

登入AEM並開啟CRXDE Lite模式。

存取以下位置可用的metadataList檔案：

/libs/fmdita/config/metadataList

新增您在中繼資料結構Forms頁面中新增的自訂中繼資料。 例如，將對象引數新增至預設清單的結尾。

按一下​「儲存全部」。

在Assets UI中，導覽至您要發佈的DITA map。

選取DITA map檔案並開啟其屬性頁面。

在「屬性」頁面上，指定自訂中繼資料的值。 例如，我們為對象引數指定了External值。

{width="650"}

按一下「儲存並關閉」。

按一下DITA map檔案以開啟DITA map主控台。

在​ 輸出預設集 ​索引標籤中，選取您要用來產生輸出的輸出預設集。

按一下「編輯」。

從​ 屬性 ​下拉式清單中，選取您要傳遞給發佈程式的屬性。

{width="650"}

系統會根據元素名稱，先搜尋每個DITA元素以尋找對應的元件對應。 例如：

<ditaelement>
   <name>**substeps**</name>
   <class>- topic/ol task/substeps</class>
   <componentpath>dita/components/ditaolist</componentpath>
   <type>COMPOSITE</type>
   <target>para</target>
</ditaelement>

在上述範例中，所有substeps DITA元素都是使用dita/components/ditaolist元件轉譯。

如果DITA元素找不到以名稱為基礎的相符專案，則會完成以class為基礎的相符專案。 例如：

<ditaelement>
   <name>topic</name>
   <class>**- topic/topic**</class>
   <componentpath>fmdita/components/dita/topic</componentpath>
   <type>COMPOSITE</type>
   <target>para</target>
   <attributemap>
      <attribute from="id" to="id" />
   </attributemap>
</ditaelement>

在上述範例中，如果沒有為task元素定義對應，則task元素會對應至上述元件，因為task繼承自topic元件。

當元素具有對應的元件對應時，其子元素的進一步處理由type決定。 例如：

<ditaelement>
   <name>title</name>
   <class>- topic/title</class>
   <componentpath>foundation/components/title</componentpath>
   <type>**STANDALONE**</type>
   <target>para</target>
   <textprop>jcr:title</textprop>
</ditaelement>

type採用下列值：

• COMPOSITE：子元素​ 的元素與元件 ​的對映也會繼續。

• STANDALONE：目前專案的子專案是​未進一步對應。

在上述範例中，若<title>元素具有任何子元素，則不會對應至任何其他元件。 <title>元素的元件負責轉譯<title>元素內的所有子元素。

如果有多個元件對應至單一DITA元素，則會選取該元素的最佳相符專案。 若要選取最佳相符元件，會考慮DITA元素的領域和結構專門化。

如果有具有領域專門化的DITA元素，且元件對應到領域專門化，則該元件會獲得高優先順序。

同樣地，如果有具有結構專門化的DITA元素，且元件對應結構專門化，則該元件會獲得高優先順序。

您可以在元素對應中使用<attributemap>，將屬性值對應至對應的節點屬性。

textprop可用來將DITA元素的文字內容序列化為node屬性。 此外，它可以在元素標籤中多次使用，以將已發佈階層中多個位置的文字內容序列化。 您也可以自訂目標屬性的位置和名稱。 例如：

<ditaelement>
    <name>title</name>
    <class>- topic/title</class>
    <componentpath>foundation/components/title</componentpath>
    <type>STANDALONE</type>
    <target>para</target>
    <textprop>**jcr:title**</textprop>
</ditaelement>

以上元素對應指定<title>元素的文字內容將會儲存為輸出節點上名為jcr:title之屬性的值。

xmlprop可用來將指定專案的整個XML序列化為節點屬性。 元件將可讀取此節點屬性並執行自訂轉譯。 例如：

<ditaelement>
    <name>svg-container</name>
    <class>+ topic/foreign svg-d/svg-container</class>
    <componentpath>fmdita/components/dita/svg</componentpath>
    <type>STANDALONE</type>
    <target>para</target>
    <xmlprop>**data**</xmlprop>
</ditaelement>

以上專案對應指定專案<svg-container>的整個XML標籤將會儲存為輸出節點上名為data之屬性的值。

有一個特殊的屬性對應，可在輸出產生程式中處理路徑解析。 例如：

<attributemap>
    <attribute from="href" to="fileReference" ispath="true" rel="source" />
    <attribute from="height" to="height" />
    <attribute from="width" to="width" />
</attributemap>

對於上述attributemap，您DITA元素中的href屬性將對應至名為fileReference的節點屬性。 現在，由於ispath設定為true，輸出產生程式會解析此路徑，然後在fileReference節點屬性中設定它。

此解析如何根據屬性對應中rel屬性的值來決定。

• 如果rel=source，則會針對目前處理中的DITA來源檔案解析href的值。 href的值已解析並置於fileReference屬性的值中。

• 如果rel=target，則相對於根發佈位置解析href的值。 href的值已解析並置於fileReference屬性的值中。

如果您不想在路徑屬性上發生任何前置處理或解析，則不需要指定ispath屬性。 值會依原樣複製，元件可執行所需的解析度。

開啟Adobe Experience Manager Web主控台設定頁面。

存取設定頁面的預設URL為：

http://<server name>:<port>/system/console/configMgr

搜尋並按一下​ com.adobe.fmdita.config.ConfigManager ​套件。

在​ 輸出歷程記錄清除期間 ​屬性中，指定輸出歷程記錄以及輸出記錄清除的天數。 預設會設為5天。 如果您要停用此功能，則將此屬性設定為0。

在​ 輸出歷程記錄清除時間 ​屬性中，指定清除程式的起始時間。 預設為0:00 \（或12:00午夜\）。 每天這個時間，清除程式都會在​ 輸出歷程記錄清除期間 ​屬性中指定的天數之前產生的輸出上執行。

按一下​儲存。