映射编辑器功能

最近更新： 2025年3月26日

创建对象：

  • 用户

映射编辑器中的工具栏与主题编辑器类似。 切换左侧面板、保存映射、创建新版本的映射、撤消/重做上一个操作以及删除所选元素等基本操作在两个编辑器中都是通用的。 有关这些操作如何工作的详细信息，请查看了解编辑器功能部分。

您在编辑器工具栏中查看的选项基于映射编辑器视图。 地图编辑器中提供了四个视图：

以下部分介绍了地图编辑器的不同视图中可用的工具栏选项：

布局视图

打开映射进行编辑时，将打开映射编辑器的“布局”视图。 “布局”视图以树视图显示映射层次结构，并允许您在映射中组织主题。

NOTE
“布局”视图仅显示地图中存在的引用。 如果任何参照被断开，则参照左侧会显示一个小十字符号

“布局”视图的工具栏上提供了以下选项：

主题引用 -

显示主题搜索对话框。 导航到要插入的主题/映射文件，然后选择​ 选择 ​以将其添加到映射中。

主题组 -

插入topicgroup元素。 有关分组主题的更多信息，请查看OASIS DITA语言规范中的主题组文档。

键定义 -

显示“插入Keydef”对话框。 使用此对话框可定义要在映射中使用的任何键定义。

此项前插入/此项后插入 - /

显示插入元素对话框。 选择要插入到映射中的元素。 根据操作，新元素会插入到映射中当前元素之前或之后。

插入前置内容 -

打开书签进行编辑时，将显示此图标。 您可以在书籍的开头插入组件，如目录、索引和表列表。

插入后置内容 -

打开书签进行编辑时，将显示此图标。 您可以在书籍的结尾处插入的组件，如索引、术语表和数字列表。

将选定项左/右移动 - /

选择向左箭头将主题移动到层级中的左侧。 这实际上是将相应主题在层次结构中提升一级。 例如，在选择子主题时选择向左箭头，使其成为其上主题的同级。 同样，如果您选择向右箭头，则会将主题推到右侧，使其成为上面主题的子项。

将选定项上移/下移 - /

选择向上或向下箭头图标，在层次结构中向上或向下移动主题。

NOTE
您还可以拖放引用以在地图中移动它们。

锁定/解锁

获取对映射文件的锁定并释放该锁定。 如果映射文件中有未保存的更改，则在释放锁定时，系统会提示您保存映射文件。 更改将保存在映射文件的当前版本中。

合并 -

有关从同一或不同文件的不同版本合并内容的更多详细信息，请在编辑器中查看合并。

版本历史记录 -

检查活动主题上的可用版本和标签，并从编辑器本身还原到任何版本。

版本标签 -

显示版本标签管理对话框。 从下拉列表中选择一个版本。 选择要应用于所选版本的标签，然后选择​ 添加标签 ​以添加该标签。

显示文件名

显示主题标题的文件名。

NOTE
将指针悬停在主题标题上时，会显示文件路径。

显示行号

显示或隐藏每个主题的行号。 行号的显示取决于层次结构中的级别。

显示复选框

显示或隐藏每个主题的复选框。 您可以使用该复选框选择主题，并使用“选项”菜单执行各种任务。

布局视图中的​ 选项菜单

除了在映射文件中组织主题外，您还可以使用选项菜单执行以下操作，该菜单出现在将鼠标悬停在文件上或在布局视图的编辑器中右键单击时：

  • 添加：您可以从映射编辑器中选择添加新主题或空引用：

    • 空引用：此选项允许您在DITA映射中添加空引用。 您可以稍后双击插入的空引用并添加主题详细信息。
    • 新主题：当您选择从菜单创建新主题时，您会获得​ 新主题 ​对话框。 在​ 新建主题 ​对话框中，提供所需的详细信息，然后选择​ 创建。

  • 移动：您可以选择在层次结构中上下左右移动主题。 您还可以将主题或地图从存储库面板拖放到在地图编辑器中打开的图中。

  • 撤消：撤消布局视图中的上一个操作。

  • 重做：重做布局视图中的上一个操作。

  • 复制：从映射文件中复制所选引用。

    NOTE
    可显示，然后选中复选框以复制多个引用。

  • 粘贴：将复制的引用粘贴到层次结构中的当前位置。

  • 删除：从映射文件中删除选定的引用。

    NOTE
    可显示，然后选中复选框以删除多个引用。

查看基于条件筛选器的主题

如果您已对主题应用了任何条件，则会在主题的右侧显示一个过滤器图标。 将指针悬停在过滤器图标上时，将显示应用的条件及其属性值。

作者视图

作者 ​视图允许您在编辑器中编辑DITA映射。 这会显示映射编辑器的WYSIWYG视图，并且在“创作”视图中显示的某些图标与在“布局”视图中显示的图标相同。

此外，您还可以从“作者”视图中查看以下图标并执行相关任务：

此项前插入/此项后插入 - /

显示​ 在之前插入元素或 ​在之后插入元素对话框。 选择要插入到映射中的元素。 根据操作，新元素会插入到映射中当前元素之前或之后。

元素 -

显示​ 插入元素 ​对话框。 选择要插入的元素。 可以使用键盘滚动元素列表，然后按Enter插入所需的元素。 或者，可以选择元素以将其插入到映射中。

可重复使用的内容 -

显示​ 重用内容 ​对话框。 使用此对话框可插入要在映射中重复使用的内容。

刷新导航标题属性 -

将映射中引用文件的title元素与其@navtitle属性中指定的值同步。 可以在映射中添加不同类型的引用文件，例如主题、引用、任务、(sub)映射等。 这些文件中的大多数都支持@navtitle属性。 如果文件包含@navtitle属性，则映射中相同文件的@navtitle属性将更新。 如果@navtitle属性不存在，则@navtitle属性将添加到该引用文件，并且其title也会更新为显示@navtitle。

NOTE
您的管理员可以配置自动向添加到映射的每个引用文件添加@navtitle属性。 有关配置自动添加@navtitle属性的更多详细信息，请在“安装和配置Adobe Experience Manager Guides as a Cloud Service”中查看​ 默认情况下包含@navtitle属性。

选择“刷新导航标题属性”图标以同步title元素和@navtitle属性的值。

标记

显示或隐藏XML标记。 标记用作指示元素边界的可视提示。 在此模式下，如果要插入主题/映射引用，请将所需文件拖放到标记之前或之后。 在“标记视图”模式下不会显示水平条。

跟踪更改 -

通过启用“跟踪更改”模式，您可以跟踪在映射文件中进行的所有更新。 启用跟踪更改后，文档将捕获所有插入和删除。 有关详细信息，请在编辑器中查看跟踪更改。

创建审核任务 -

可直接从编辑器创建当前主题的审阅任务或映射文件。 打开要为其创建审阅任务的文件，然后选择​ 创建审阅任务 ​以启动审阅创建流程。 请按照简介中的说明查看，以了解更多详细信息。

Source视图

通过此视图，可编辑原始格式的内容，从而完全控制结构和格式。

在此视图中，工具栏提供了​ 菜单 ​下拉菜单下可用的基本内容编辑和插入选项，包括“剪切”、“复制”、“撤消”、“重做”、“删除”、“查找和替换”、“版本标签”、“合并”、“另存为新版本”、“锁定”和“解锁”。

预览

预览模式将呈现将在最终输出中显示的内容，这使您可以在发布内容之前查看布局和格式。

除了能够查看地图中每个主题文件的位置之外，还希望在一个连续流中查看地图内容。 预览映射功能允许您通过单击查看映射文件的整个内容。 您不必生成映射文件的输出即可查看整个映射在发布后的外观。 您只需访问映射的预览即可，所有主题和子映射将以书籍的形式呈现。

NOTE
在“预览”模式下，工具栏中没有可用的内容编辑或插入选项。 您无法编辑此视图中的内容。 但是，您可以使用​ 另存为新版本 ​和​ 锁定 ​或​ 解锁 ​功能。

您可以在预览模式下执行以下附加任务：

  • 右键单击主题，然后选择​ 编辑 ​以打开该主题并在新选项卡中进行编辑。

    NOTE
    如果您没有编辑权限，则该主题将以只读模式打开。

  • 通过选择映射树中的主题标题\（在左侧面板中），跳转到所需主题。

  • 地图预览中的当前主题也会在地图树中突出显示。

预览地图文件的其他方式

您可以从以下位置访问地图的预览：

  • Assets UI：在Assets UI中，导航到映射位置，选择映射文件，然后在工具栏中选择​ 预览映射。 映射的预览将显示在新选项卡中。 您可以在预览模式下查看所有主题的内容。 在此视图中，不能编辑任何主题。

    NOTE
    如果​ 预览图 ​选项在主工具栏中不可见，则它可能已移动到​ 更多 ​工具栏菜单下。

  • 映射编辑器：在映射编辑器中，从“选项”菜单中选择“预览”​ ​以查看当前映射的预览。

    地图的预览显示在弹出框中。

映射属性

显示“映射属性”对话框，在其中可以设置映射的属性和元数据信息。