設定輸出產生設定 id181AI0B0E30
AEM Guides隨附許多設定選項,供您自訂輸出產生程式。 本主題涵蓋可協助您設定輸出產生程式的所有設定和自訂。
在DITA map圖示板上設定基準線標籤 id223MD0D0YRM
您可以設定和隱藏地圖圖示板上可用的「基準線」標籤。
此 隱藏基準線頁簽 選項預設為未啟用,您必須從configMgr啟用此專案。 執行以下步驟,在Web編輯器中啟用預設選項:
-
開啟Adobe Experience Manager Web主控台設定頁面。
存取設定頁面的預設URL為:
code language-http http://<server name>:<port>/system/console/configMgr
-
搜尋並按一下 com.adobe.fmdita.config.ConfigManager 套件組合。
-
選取 隱藏基準線頁簽 選項。
-
按一下「儲存」。
note note NOTE 此設定預設為停用,且可在地圖控制面板上使用「基準」標籤。
設定FrameMaker Publishing Server id1678G0Z0TN6
您可以使用FrameMaker Publishing Server(FMPS)產生DITA內容的輸出。 設定FMPS可讓您以FMPS支援的多種格式產生輸出。
若要設定AEM Guides使用FMPS,請更新 com.adobe.fmdita.config.ConfigManager
Web控制檯中的套件組合。
- FMPS 2019和舊版:IP位址或網域名稱
- FMPS 2020:
http://<fmps_ip>:<port>
(http://192.168.1.101:7000)- FMPS 2019和舊版:
http://<fmps_ip>:<port>/fmserver/v1/
- FMPS 2020:2020
- FMPS 2019和舊版:2019或2017
預設值: 300秒\(5分鐘\)
http://<server-name>:<port>/
。在現有AEM網站中設定混合發佈 id1691I0V0MGR
如果您的AEM網站包含DITA內容,您可以設定AEM網站輸出,將DITA內容發佈至網站內預先定義的位置。 例如,在以下AEM Site頁面的熒幕擷圖中, ditacontent
節點已保留以儲存DITA內容:
{width="300"}
頁面中的其餘節點會直接從AEM網站編輯器撰寫。 將發佈設定設為將DITA內容發佈至預先定義的位置,可確保不會由AEM Guides發佈程式修改任何現有的非DITA內容。
您需要在現有網站上執行下列設定,以允許將DITA內容發佈到預先定義的節點:
-
設定網站的範本屬性
-
在您的網站中新增節點以發佈DITA內容
執行以下步驟來設定您現有網站的範本屬性:
-
登入AEM並開啟CRXDE Lite模式。
-
導覽至您網站的範本設定節點。 例如,AEM Guides會將預設範本設定儲存在下列節點中:
/libs/fmdita/config/templates/default
note note NOTE 請勿讓預設組態檔案中的任何自訂功能可用於 libs
節點。 您必須建立libs
中的節點apps
節點並更新中apps
僅限節點。 -
新增下列屬性:
table 0-row-3 1-row-3 2-row-3 屬性名稱 類型 值 topicContentNode
字串 指定要發佈DITA內容的節點名稱。 例如,AEM Guides發佈DITA內容的預設節點為: jcr:content/contentnode
topicHeadNode
字串 指定要儲存DITA內容的中繼資料資訊的節點名稱。 例如,AEM Guides儲存中繼資料資訊的預設節點為: jcr:content/headnode
下列熒幕擷圖顯示新增到AEM Guides預設範本節點中的屬性:
{width="800"}
下次當您使用網站的範本設定發佈任何DITA內容時,該內容會發佈到 topicContentNode
和 topicHeadNode
屬性。
不過,您必須針對現有網站手動新增 topicContentNode
和 topicHeadNode
節點。
執行以下步驟,將所需節點新增至現有站台:
-
登入AEM並開啟CRXDE Lite模式。
-
尋找
jcr:content
在您網站節點內。 -
新增
topicContentNode
和topicHeadNode
與您在網站的範本設定中指定的名稱相同的節點。
自訂AEM網站輸出 id166TG0B30WR
AEM Guides支援以下列格式建立輸出:
-
AEM網站
-
PDF
-
HTML5
-
ePub
-
透過DITA-OT自訂輸出
對於AEM Site輸出,您可以為不同的輸出任務指派不同的設計範本。 這些設計範本可以不同的版面配置呈現DITA內容。 例如,您可以為內部和外部對象指定不同的設計範本。
您也可以搭配AEM Guides使用自訂的DITA Open Toolkit (DITA-OT)增效模組。 您可以上傳這些自訂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輸出產生:
-
登入AEM並開啟CRXDE Lite模式。
-
導覽至預設的設計範本節點。 預設設計範本節點的位置為:
/libs/fmdita/config/templates/
{width="300"}
note note NOTE 複製預設設計範本,從 libs
資料夾至apps
資料夾,並在apps
資料夾。 您也必須變更從預設範本節點參考的範本。 參照的範本放在/libs/fmdita/templates/default/cqtemplates
節點。 複製中參照的範本apps
資料夾。 -
按一下 預設 中的元件 範本 節點以存取其屬性。
下表說明AEM Guides的設計範本屬性。
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 屬性 說明 landingPageTemplate
,searchPageTemplate
,topicPageTemplate
,shadowPageTemplate
指定 cq:Template
這些對應頁面的節點\(登陸、搜尋和主題\)。 根據預設cq:Template
這些頁面的節點可在以下位置找到:/libs/fmdita/templates/default/cqtemplates
節點。 此節點會定義登陸、搜尋和主題頁面的結構和屬性。
此shadowPageTemplate
用於最佳化區塊內容。 您必須將此屬性的值設為:fmdita/templates/default/cqtemplates/shadowpage
注意 您必須指定topicPageTemplate
. 此landingPageTemplate
和searchPageTemplate
是選用屬性。 如果您不想產生搜尋和登入頁面,請勿指定這些屬性。title
設計範本的描述性名稱。 topicContentNode
將在主題頁面中包含DITA內容的節點位置。 路徑是相對於主題頁面的路徑。 topicHeadNode
節點的位置,此節點將包含衍生自DITA內容的head值\(或metadata\)。 路徑是相對於主題頁面的路徑。 tocNode
包含目錄的節點位置。 路徑是相對於登陸頁面或目的地路徑的。 basePathProp
用來儲存已發佈網站根目錄路徑的屬性名稱。 indexPathProp
用於儲存已發佈網站之登陸/索引頁面路徑的屬性名稱。 pdfPathProp
儲存主題PDF路徑的屬性名稱(如果已啟用主題PDF產生)。 pdfTypeProp
用於儲存PDF產生型別的屬性名稱。 目前此屬性一律包含「主題」。 searchPathProp
儲存搜尋頁面路徑的屬性名稱(如果範本包含搜尋頁面)。 siteTitleProp
用來儲存發佈之網站標題的屬性名稱。 此標題通常與正在發佈的地圖的標題相同。 sourcePathProp
用來儲存目前頁面之來源DITA主題之路徑的屬性名稱。 tocPathProp
用於儲存已發佈站台TOC根目錄路徑的屬性名稱。
如需詳細資訊,請參閱 建立您的第一個Adobe Experience Manager 6.3網站 和 基本資訊 在AEM上開發您自己的網站。
使用檔案標題來產生AEM網站輸出
產生AEM Site輸出時,產生URL的方式在內容的可發現性方面扮演重要角色。 如果您使用UUID型檔案名稱,根據檔案的UUID產生URL將不利於搜尋。 身為管理員或發佈者,您可以控制要如何產生AEM Site輸出的URL。 AEM Guides提供設定,您可選擇使用檔案標題而非UUID型檔案名稱來產生AEM Site輸出的URL。 對於以UUID為基礎的檔案系統,此選項預設為開啟。 這表示當您產生UUID型檔案系統的AEM Site輸出時,會使用檔案的標題來產生URL,而非檔案的UUID。
產生AEM Site輸出時,產生URL的方式在內容的可發現性方面扮演重要角色。 如果檔案系統不是UUID,AEM Site輸出會使用檔案名稱(而非檔案標題)產生。 身為管理員或發佈者,您可以控制要如何產生AEM Site輸出的URL。 AEM Guides提供設定,您可選擇使用檔案標題(而非檔案名稱)產生AEM Site輸出的URL。 依預設,此選項是關閉的。 這表示當您產生AEM Site輸出時,會使用檔案名稱來產生URL,而非檔案標題。 您可以啟用此選項,選擇根據檔案標題產生URL。
若要在AEM Site輸出中設定URL的產生,請執行下列步驟:
-
開啟Adobe Experience Manager Web主控台設定頁面。
存取設定頁面的預設URL為:
code language-http http://<server name>:<port>/system/console/configMgr
-
搜尋並按一下 com.adobe.fmdita.config.ConfigManager 套件組合。
-
選取 使用AEM網站頁面名稱的標題 選項。
note note NOTE 如果您要使用檔案名稱產生輸出,請取消選取此選項。 -
按一下「儲存」。
設定檔案名稱清理規則,以建立主題和發佈AEM網站輸出 id2164D0KD0XA
作為管理員,您可以定義檔案名稱中允許的有效特殊字元清單,這些字元最終會形成AEM Site輸出的URL。 在舊版中,使用者可定義包含特殊字元的檔案名稱,例如 @
, $
, >
、等等。 這些特殊字元會在產生AEM網站頁面時產生編碼的URL。
自3.8發行版本開始,已新增設定以定義檔案名稱中允許的特殊字元清單。 依預設,有效的檔案名稱設定包含"a-z A-Z 0-9 - _
「。 這表示在建立檔案時,檔案標題中可以有任何特殊字元,但在內部會以連字型大小取代(-
)的檔案名稱。 例如,您可以將檔案的標題設為Introduction 1或Introduction@1,針對這兩種情況產生的對應檔案名稱都是Introduction-1。
定義有效字元清單時,請記得這些字元»*/:[\]|#%{}?&<>"/+
」和 a space
將一律以連字型大小取代(-
)。
若要在檔案名稱和AEM Site輸出中設定有效的特殊字元,請執行下列步驟:
-
開啟Adobe Experience Manager Web主控台設定頁面。
存取設定頁面的預設URL為:
code language-http http://<server name>:<port>/system/console/configMgr
-
搜尋並按一下 com.adobe.fmdita.common.SanitizeNodeNameImpl 套件組合。
-
在 發佈至AEM Sites時不允許使用的字元集 屬性,確認屬性已設為
'<>`@$
. 您可以在此清單中新增更多特殊字元,但是它必須包含這些必要的特殊字元。note note NOTE 您也可以設定其他屬性,例如 使用小寫 在檔案名稱中, 分隔符號 以處理無效字元,以及 字元數量上限 檔案名稱中允許。 -
按一下「儲存」。
-
搜尋並按一下 com.adobe.fmdita.config.ConfigManager 套件組合。
-
在 有效字元的Regex 屬性,確認屬性已設為
[-a-zA-Z0-9_]
. 您可以新增更多字元至此清單,但清單必須包含這些基本字元,且清單的開頭必須為連字型大小(-
)。note note NOTE 此屬性會定義用來建立新檔案的有效字元清單。 -
按一下「儲存」。
設定AEM網站節點結構的平面化
產生AEM Site輸出時,主題中每個元素的節點都會在內部建立。 對於包含數千個主題的DITA map,此節點結構可能會變得太深。 對於較大的網站,這種深度巢狀節點結構可能會出現效能問題。 下列快照會顯示AEM Site輸出的深度巢狀節點結構:
{width="300"}
在上述快照中,請注意每個都會建立一個節點, p
元素及其後續子元素和類似結構會針對主題中使用的其他所有元素而建立。
AEM Guides可讓您設定AEM Site輸出的節點結構在內部建立的方式。 您可以在指定元素處平面化節點結構,這表示您可以定義元素,將其視為主要元素,其內的所有子元素將與主要元素合併。 例如,如果您決定將 p
元素,然後出現在 p
元素將會與主要 p
元素。 系統不會為中的任何子元素建立單獨的附註。 p
元素。 下列快照顯示展平於的節點結構 p
元素:
{width="300"}
若要平面化AEM Site節點結構,請執行下列步驟:
-
指定您要平面化節點結構的元素。
-
覆蓋
libs
中的節點apps
節點並開啟elementmapping.xml檔案。 -
新增
<flatten>true</flatten>
屬性(在您要平面化節點結構的元素定義中)。 例如,如果您想將節點結構平面化於p
元素,然後將flatten屬性新增至的定義中p
元素如下所示: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中啟用網站節點平面化設定。
-
開啟Adobe Experience Manager Web主控台設定頁面。
存取設定頁面的預設URL為:
code language-http http://<server name>:<port>/system/console/configMgr
-
搜尋並按一下 com.adobe.dxml.flattening.FlatteningConfigurationService 套件組合。
-
選取 屬性平面化.enabled 選項。
-
按一下「儲存」。
-
現在,當您產生AEM Site輸出時, p
元素會平面化並儲存在 p
元素本身。 您可以找到新的平面化屬性 p
CRXDE中的元素。
{width="650"}
防止AEM網站附註結構平面化
與在AEM Site輸出中指定要平面化的節點類似,您也可以指定要從此設定中排除的元素。 例如,如果您想將節點平面化於 body
元素,但您不想要任何 table
元素在內 body
若要平面化,您可以在 table
元素的定義。
若要排除 table
將元素平面化,將下列屬性新增至 table
元素的定義:
<preventancestorflattening>true|false</preventancestorflattening>
在AEM網站輸出中設定已刪除頁面的版本設定
當您使用產生AEM Site輸出時 刪除和 建立 為「現有輸出頁面」設定選取的選項,會為要刪除的頁面建立版本。 您可以設定系統在刪除前停止建立版本。
執行以下步驟,停止建立要刪除之頁面的版本:
-
開啟Adobe Experience Manager Web主控台設定頁面。
存取設定頁面的預設URL為:
code language-http http://<server name>:<port>/system/console/configMgr
-
搜尋並按一下 com.adobe.fmdita.config.ConfigManager 套件組合。
-
選取 不要建立已刪除頁面的版本 選項。
note note NOTE 選取此選項後,使用者可直接刪除任何頁面,而不需為其建立任何版本。 如果未選取選項,則會在刪除頁面之前建立版本。 -
按一下「儲存」。
透過DITA-OT在發佈輸出中使用中繼資料 id191LF0U0TY4
AEM Guides提供在使用DITA-OT發佈輸出時傳遞自訂中繼資料的方法。 作為管理員和發佈者,您需要執行以下任務以在發佈輸出中設定和使用自訂中繼資料:
-
以管理員身分,在系統中新增必要的中繼資料,使其可在DITA map的「屬性」頁面上使用。
-
作為管理員,在中繼資料清單中新增自訂中繼資料,使其顯示在DITA map主控台中。
-
作為發行者,使用DITA map設定並新增自訂中繼資料,並產生所需的輸出。
若要在系統中新增必要的中繼資料,請執行下列步驟:
-
以管理員身分登入Adobe Experience Manager。
-
按一下頂端的Adobe Experience Manager連結,然後選擇 工具.
-
選取 資產 工具清單中。
-
按一下 中繼資料結構 圖磚。
此時會顯示「中繼資料結構Forms」頁面。
-
選取 預設 從清單中移除。
note note NOTE DITA map的「屬性」頁面上顯示的屬性取自此表單。 -
按一下 編輯.
-
新增您要在發佈的輸出中使用的自訂中繼資料。 例如,我們將使用下列步驟新增對象中繼資料:
-
從 建置表單 元件清單,拖放 單行文字 元件至表單。
-
選取新欄位以開啟 設定 欄位的。
-
在 欄位標籤,輸入中繼資料名稱 — Audience。
-
在 對應至屬性 設定,指定。/jcr:content/metadata/<name of="" the="" metadata="">. 例如我們的範例,我們將其設為。/jcr:content/metadata/audience。
使用這些步驟,新增所有必要的中繼資料引數。
-
-
按一下「儲存」。
現在,所有DITA map的「屬性」頁面中都會顯示新引數。
{width="650"}
接下來,您需要在DITA map主控台中提供自訂中繼資料。 執行下列步驟,讓自訂中繼資料可在DITA map虛線板上使用:
-
登入AEM並開啟CRXDE Lite模式。
-
存取以下位置可用的metadataList檔案:
/libs/fmdita/config/metadataList
note note NOTE metadataList檔案包含顯示在 屬性 地圖儀表板中DITA map的下拉式清單。 依預設,此檔案中列出四個屬性:docstate、dc:language、dc:description和dc:title。 -
新增您在中繼資料結構Forms頁面中新增的自訂中繼資料。 例如,將對象引數新增至預設清單的結尾。
-
按一下 「儲存全部」。
現在,自訂中繼資料會顯示在DITA map主控台的 屬性 下拉式清單。
最後,身為「發佈者」,您需要在發佈的輸出中包含自訂中繼資料。 若要在產生輸出時處理自訂中繼資料,請執行下列步驟:
-
在Assets UI中,導覽至您要發佈的DITA map。
-
選取DITA map檔案並開啟其屬性頁面。
-
在「屬性」頁面上,指定自訂中繼資料的值。 例如,我們為對象引數指定了External值。
{width="650"}
-
按一下 「儲存並關閉」。
-
按一下DITA map檔案以開啟DITA map主控台。
-
在 輸出預設集 索引標籤上,選取您要用來產生輸出的輸出預設集。
-
按一下 編輯.
-
從 屬性 從下拉式清單中,選取您要傳遞給發佈程式的屬性。
{width="650"}
選取的屬性/中繼資料會傳遞至發佈程式,並可在最終輸出中使用。
使用AEM元件自訂DITA元素對應 id1679J600HEL
AEM Guides中的DITA元素會對應至其對應的AEM元件。 AEM Guides在工作流程(例如發佈和稽核)中使用此對應,將DITA元素轉換為對應的AEM元件。 該對應定義於 elementmapping.xml
檔案,可從CRXDE Lite模式存取。 在CRXDE Lite模式中存取下列URL:
/libs/fmdita/config/elementmapping.xml
libs
節點。 您必須建立 libs
中的節點 apps
節點並更新中 apps
僅限節點。您可以使用預先定義的DITA元素對映,也可以將DITA元素對映至自訂AEM元件。 若要使用自訂AEM元件,您必須瞭解 elementmapping.xml
檔案。
elementmapping.xml結構
概略說明 elementmapping.xml
結構說明如下:
-
系統會根據元素名稱,先搜尋每個DITA元素以尋找對應的元件對應。 例如:
code language-xml <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
已完成。 例如:code language-xml <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
. 例如:code language-xml <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屬性。 此外,它可以在元素標籤中多次使用,以將已發佈階層中多個位置的文字內容序列化。 您也可以自訂目標屬性的位置和名稱。 例如:code language-xml <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序列化為node屬性。 元件將可讀取此節點屬性並執行自訂轉譯。 例如:code language-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>
上述元素對應會指定元素的整個XML標籤
<svg-container>
將儲存為下列屬性的值:data
在輸出節點上。 -
有一個特殊的屬性對應,可在輸出產生程式中處理路徑解析。 例如:
code language-xml <attributemap> <attribute from="href" to="fileReference" ispath="true" rel="source" /> <attribute from="height" to="height" /> <attribute from="width" to="width" /> </attributemap>
對於上述專案
attributemap
,則href
DITA元素中的屬性將對映至名為的節點屬性fileReference
. 現在開始於ispath
設為true
,輸出產生程式會解析此路徑,然後將其設定在fileReference
節點屬性。此解析度的發生方式是根據
rel
屬性對應中的屬性。-
如果
rel=source
,然後值href
相對於目前處理中的DITA來源檔案來解析。 的值href
解析並放置在的值中fileReference
屬性。 -
如果
rel=target
,然後值href
已相對於根發佈位置來解析。 的值href
解析並放置在的值中fileReference
屬性。
如果您不希望路徑屬性上發生任何預先處理或解析,則不需要指定
ispath
屬性。 值會依原樣複製,元件可執行所需的解析度。 -
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元素結構描述中的元素:
<ditaelement>
<class>
例如,DITA主題的class屬性為:
topic/topic
<componentpath>
<type>
- 複合:也會處理子元素
- 獨立:略過子元素的處理
<attributeprop>
<note type="Caution">
元素且針對此元素對應的元件具有 <attributeprop>attr_t</ attributeprop>
,則節點的屬性和值會序列化為 attr_t
對應AEM節點的屬性( attr_t->type="caution"
)。<textprop>propname_t</textprop>
getTextContent()
輸出至由定義的屬性 propname_t.
注意: 這是最佳化的屬性。<xmlprop>propname_x </xmlprop>
propname_x.
注意: 這是最佳化的屬性。<xpath>
<target>
可能的值:
- head:在head節點下
- 文字:在段落節點下
<wrapelement>
<wrapclass>
wrapclass.
<attributemap>
<attribute>
節點。其他附註
-
如果您計畫覆寫預設要素對應,建議您不要在預設值中進行變更
elementmapping.xml
檔案。 您應該建立新的對應XML檔案,並將檔案放置於其他位置,最好是放在您建立的自訂應用程式資料夾內。 -
在
elementmapping.xml
檔案中,有許多對應專案會參照fmdita/components/dita/wrapper元件。 包裝函式是一種泛型元件,會使用其網站節點上的屬性來產生相關HTML,以呈現相對簡單的DITA建構。 它會使用wrapelement
屬性以產生封閉標籤,並將子轉譯委派給對應的元件。 當您只想要容器元件時,這個用法就相當實用。 不要建立可轉譯特定容器標籤的新元件,例如div
或p
,您可以將包裝函式元件搭配wrapelement
和wrapclass
屬性以獲得相同的效果。 -
不建議在字串JCR屬性中儲存大量文字。 輸出產生中最佳化的屬性型別計算可確保大型文字內容不會儲存為字串型別。 反之,當需要儲存大於某個臨界值的內容時,屬性的型別會變更為二進位。 預設會將此臨界值設定為512位元組,但可在Configuration Manager (com.adobe.fmdita.config.ConfigManager)透過變更 另存為二進位臨界值 設定。
-
如果您計畫覆寫部分\(而非全部\)元素對應,則不需要復寫整個
elementmapping.xml
檔案。 您需要建立新的XML對應檔案,並只定義要覆寫的元素。 -
在自訂位置中建立XML檔案之後,請更新
Override Element Mapping
在中設定com.adobe.fmdita.config.ConfigManager
套件組合。
自訂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.xml
中的檔案 apps
所有自訂的資料夾。<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的「輸出」標籤中,在指定的天數之後,以及在設定中指定的時間清除歷史記錄。
執行以下步驟,設定清除輸出歷史記錄和日誌的日期和時間:
-
開啟Adobe Experience Manager Web主控台設定頁面。
存取設定頁面的預設URL為:
code language-http http://<server name>:<port>/system/console/configMgr
-
搜尋並按一下 com.adobe.fmdita.config.ConfigManager 套件組合。
-
在 輸出歷史記錄永久刪除期間 屬性,指定清除輸出歷史記錄及輸出記錄後的天數。 預設會設為5天。 如果您要停用此功能,則將此屬性設定為0。
-
在 輸出歷史記錄清除時間 屬性,指定開始整個清除程式的時間。 預設會設為0:00 \(或12:00午夜\)。 每天這個時候,清除程式都會在指定的天數之前產生的輸出上執行。 輸出歷史記錄永久刪除期間 屬性。
note note NOTE 依預設,清除功能會在每午夜的5天前輸出上執行。 -
按一下「儲存」。
變更最近產生的輸出清單限制 id1679JH0H0O2
您可以變更DITA map在「輸出」標籤中顯示的已產生輸出最大數目。 依預設,會顯示最後25個產生的輸出清單。 若要變更清單中顯示的輸出數量,請更新 輸出清單限制 在中設定 com.adobe.fmdita.config.ConfigManager
套件組合。
輸出產生效能最佳化 id176LB050VUI
AEM Guides可讓您設定輸出產生程式集區大小,以控制同時執行的輸出產生程式數目。 依照預設,處理集區大小會設定為您的系統中可用的處理核心數目加上一個。 如果您想要循序發佈,可將此值變更為1。 在這種情況下,會執行第一個發佈任務,並將下一個發佈任務儲存在發佈佇列中。
若要變更輸出產生處理集區大小,請更新 產生集區大小 在中設定 com.adobe.fmdita.publish.manager.PublishThreadManagerImpl
套件組合。