配置输出生成设置 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 for Valid Characters ​属性中，确保将该属性设置为[-a-zA-Z0-9_]。 您可以向此列表添加更多字符，但是，它必须包含这些基本字符，并且列表必须以连字符(-)开头。

单击​ 保存。

指定要展平节点结构的元素。

1. 覆盖apps节点中的libs节点，并打开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
   默认情况下，已在p元素上配置了flatten节点属性。

在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页面。

从列表中选择​ default ​表单。

单击​ 编辑。

添加要在发布的输出中使用的自定义元数据。 例如，我们将使用以下步骤添加受众元数据：

1. 从​ 构建表单 ​组件列表中，将​ 单行文本 ​组件拖放到表单上。

2. 选择新字段以打开该字段的​ 设置。

3. 在​ 字段标签 ​中，输入元数据名称 — Audience。

4. 在​ 映射到属性 ​设置中，指定。/jcr：content/metadata/<元数据的名称>。 例如，我们将其设置为。/jcr：content/metadata/audience.

使用这些步骤，添加所有必需的元数据参数。

单击​ 保存。

登录AEM并打开CRXDE Lite模式。

访问位于以下位置的metadataList文件：

/libs/fmdita/config/metadataList

添加您在元数据架构Forms页面中添加的自定义元数据。 例如，将受众参数添加到默认列表的末尾。

单击​ 全部保存。

在Assets UI中，导航到要发布的DITA映射。

选择DITA映射文件并打开其属性页。

在属性页面上，指定自定义元数据的值。 在本例中，我们为受众参数指定了External值。

{width="650"}

单击“保存并关闭”。

单击DITA映射文件以打开DITA映射控制台。

在​ 输出预设 ​选项卡中，选择要用于生成输出的输出预设。

单击​ 编辑。

从​ 属性 ​下拉列表中，选择要传递给发布进程的属性。

{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采用以下值：

• 组合：子元素​ 的元素到组件 ​的映射也继续。

• 独立：当前元素的子元素是​ 未进一步映射。

在上述示例中，如果<title>元素具有任何子元素，则这些子元素将不会映射到任何其他组件。 <title>元素的组件负责呈现<title>元素中的所有子元素。

如果有多个组件映射到单个DITA元素，则会选择该元素的最佳匹配项。 要选择最佳匹配元件，需要考虑DITA元素的域和结构专业化。

如果存在具有域专门化的DITA元素并且为域专门化映射了组件，则该组件被赋予高优先级。

同样，如果存在具有结构专门化的DITA元素并且为结构专门化映射了某个组件，则该组件将获得高优先级。

您可以在元素映射中使用<attributemap>将属性值映射到相应的节点属性。

textprop可用于将DITA元素的文本内容序列化为节点属性。 此外，可以在元素标记中多次使用它来序列化已发布层次结构中多个位置的文本内容。 您还可以自定义目标属性的位置和名称。 例如：

<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午夜\）。 每天在此时间，清除进程都在​ 输出历史记录清除周期 ​属性中指定的天数之前生成的输出上执行。

单击​ 保存。