DITAVAL编辑器 ditaval-editor
DITAVAL文件用于生成条件输出。 在单个主题中，您可以使用元素属性添加条件以条件化内容。 然后，创建一个DITAVAL文件，在该文件中指定应选取以生成内容的条件，以及应从最终输出中排除哪些条件。
Adobe Experience Manager Guides允许您使用DITAVAL编辑器轻松创建和编辑DITAVAL文件。 DITAVAL编辑器将检索系统中定义的属性（可用作条件），您可以使用这些属性来创建或编辑DITAVAL文件。 有关在Adobe Experience Manager中创建和管理条件的更多详细信息，请查看Adobe Experience Manager文档中的管理标记部分。
以下各节介绍了Experience Manager Guides中可用于DITAVAL文件的选项。
创建DITAVAL文件
执行以下步骤以创建DITAVAL文件：
-
在“存储库”面板中，选择 新建文件 图标，然后从下拉菜单中选择主题。
您还可以从Experience Manager Guides主页以及存储库视图中文件夹的选项菜单访问此选项。
-
显示 新建主题 对话框。
-
在 新建主题 对话框中，提供以下详细信息：
- 主题的标题。
- \（可选\）*主题的文件名。 根据主题“标题”自动建议文件名。 如果管理员启用了基于UUID设置的自动文件名，则您将不会查看名称字段。
- 主题所基于的模板。 对于DITAVAL文件，请从下拉列表中选择Ditaval。
- 要保存主题文件的路径。 默认情况下，存储库中当前选定文件夹的路径将显示在路径字段中。
-
选择创建。
该主题在指定的路径中创建。 此外，该主题将在编辑器中打开以进行编辑。
编辑DITAVAL文件
创建DITAVAL主题时，将在编辑器中打开该主题以进行编辑。 要编辑现有的DITAVAL主题，请导航到DITAVAL主题所在的文件夹或映射，然后从 选项 菜单中选择编辑。
DITAVAL编辑器允许您使用“编辑器”工具栏中的选项执行以下列出的多个任务。
编辑器工具栏选项
菜单下拉列表
菜单下拉菜单提供对编辑操作、查找和替换、版本历史记录、版本标签、合并、创建审核任务、跟踪更改和标记功能的访问权限。
有关更多详细信息，请查看菜单下拉选项
添加属性
在DITAVAL文件中添加单个属性。
第一个下拉列表列出了可以在DITAVAL文件中使用的允许DITA属性。
第二个下拉列表显示为所选属性配置的值。 然后，下一个下拉列表显示了您可以对选定属性配置的操作。 操作下拉列表中允许的值是 — include、exclude、passthrough和flag。 有关这些值的详细信息，请查看OASIS DITA文档中prop元素的定义。 有关在属性中添加的属性的操作的详细信息，请查看属性的操作。
添加收入属性
要向XML格式的标记中添加特定修订版本号，您可以使用“添加修订版本prop”选项。 这会将rev属性添加到标记中，该属性具有在“值”字段中定义的值以及该属性的选定操作。 此修订属性以后可用于在生成输出时根据指定的修订版本号筛选相关的XML内容。
添加所有Prop
如果要通过单击添加系统中定义的所有条件属性或属性，请使用“添加所有Prop”功能。 操作下拉列表中允许的值是 — include、exclude、passthrough和flag。 有关这些操作的详情见下文。
针对属性的操作
对于给定属性，主要有四个可用操作，如下所示：
包括：在输出中包括内容。 除非另有设置，否则这是默认行为。
排除：从输出中排除内容（如果排除特定属性中的所有值）。
通过：在输出中包含内容，并将属性值保留为输出流的一部分，以供运行时引擎进一步处理，例如根据单个用户设置进行运行时筛选。
添加标志：若要在输出中标记内容，可以将标志设置为文件中所需属性的操作。 您还可以使用 标记样式 下拉列表应用不同的标记样式，如下面的代码片段所示。
-
背景颜色：从背景颜色中选择色相、饱和度和对比度。 相应的十六进制值将根据您的选择自动更新。 您还可以使用下拉菜单在十六进制、RGB和HSB之间切换色彩空间格式。
-
文本颜色：从文本颜色中选择色相、饱和度和对比度。 相应的十六进制值将根据您的选择自动更新。 您还可以使用下拉菜单在十六进制、RGB和HSB之间切换色彩空间格式。
-
样式选项：您可以添加一些样式选项，如粗体、斜体、下划线、上划线、双下划线。
-
开始和结束标志：您可以使用 添加标志 按钮将图像插入为开始和结束标志。 若要选择图像，请使用 浏览Assets 以从Guides存储库中选择，或者使用 添加文件 以从本地系统上传。 此外，还可以为图像指定替换文本。
-
样式冲突：它解决了单个元素包含多个具有不同标志样式的属性时出现的冲突。 在这种情况下，会选择样式冲突属性中定义的值，从而有效地充当背景和文本颜色的默认值选取器。
版本信息并另存为新版本
版本信息和另存为新版本功能将版本跟踪和内容保存合并到单个功能中。
有关详细信息，请查看另存为新版本
锁定/解锁
锁定或解锁当前文件。 锁定文件可为您提供对文件的独占写入权限。
有关详细信息，请查看锁定文件
保存内容
编辑完DITAVAL文件后，在选项卡栏上选择保存。
DITAVAL编辑器视图
Adobe Experience Manager Guides的DITAVAL编辑器支持以两种不同的模式或视图查看DITAVAL文件：
作者： 这是DITAVAL编辑器的典型“所见即所得”视图。 您可以使用简单的用户界面添加或删除属性，该界面在下拉列表中显示属性、属性值和操作。 在“创作”视图中，您可以选择通过一次单击插入单个属性和所有属性。
通过将指针悬停在文件名上，还可以找到当前正在处理的DITAVAL文件的版本。
Source： Source视图显示构成DITAVAL文件的基础XML。 除了在此视图中编辑常规文本外，作者还可以使用智能目录添加或编辑属性。
要调用智能目录，请将光标放在任何属性定义的末尾并输入“<”。 该编辑器将显示可以在该位置插入的所有有效XML元素的列表。
在Assets UI中使用DITAVAL文件
您还可以从Assets UI创建DITAVAL文件。 创建新DITAVAL主题的步骤如下：
-
在Assets UI中，导航到要创建DITAVAL文件的位置。
-
选择创建 > DITA主题。
-
在Blueprint页面上，选择DITAVAL文件模板并选择下一步。
-
在“属性”页面上，为DITAVAL文件指定 标题 和名称。
note note NOTE 根据文件的标题自动建议名称。 如果要手动指定文件名，请确保“名称”不包含任何空格、撇号或大括号，且以.ditaval结尾。 -
选择创建。
此时将显示“创建的主题”消息。
您可以选择打开DITAVAL文件以便在DITAVAL编辑器中编辑，或者将主题文件保存到Adobe Experience Manager存储库中。
执行以下步骤来编辑现有DITAVAL文件：
-
在Assets UI中，导航到要编辑的DITAVAL文件。
-
若要获得对文件的独占锁定，请选择该文件并选择签出。
-
选择该文件并选择 编辑 以在Adobe Experience Manager Guides DITAVAL编辑器中打开该文件。