编辑器中的工具栏

Last update: Wed Aug 20 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

用户

在编辑器中打开主题或映射进行编辑时，将显示工具栏。工具栏中可用的功能如下：

菜单下拉列表
内容插入选项
版本信息和另存为新版本按钮
锁定/解锁

NOTE

上面列出的功能仅适用于主题文件。处理映射文件时，工具栏中会根据当前映射编辑器视图显示不同的选项。了解映射编辑器功能文档中的映射编辑器工具栏选项。

菜单下拉列表

“菜单”下拉菜单提供对编辑操作、“查找和替换”、“版本历史记录”、“版本标签”、“合并”、“创建审核任务”和“显示”菜单（包括“跟踪更改”、“标记”和“不间断空间”）的访问权限。

编辑器工具栏的菜单下拉列表 {width="350"}

这些功能的详细说明如下：

正在编辑操作

在编辑器中编辑主题时，访问各种编辑操作，如剪切或 Ctrl+X、复制或 Ctrl+C、撤消或 Ctrl+Z、重做或 Ctrl+Y 和菜单下拉列表中存在删除。

查找和替换

查找和替换 功能在创作和Source视图模式下可用。启用后，“查找并替换”文本栏将显示在主题编辑区域的底部。您可以使用快捷键 CTRL+F 调用查找和替换栏。

使用设置图标( )，您可以切换 忽略大小写 和 仅限全字 搜索选项。要执行不区分大小写的搜索，请打开\（或选择\）忽略大小写 选项。否则，如果要执行区分大小写的搜索，请关闭\（或取消选择\）忽略大小写 选项。您还可以选择搜索整个词。

搜索是即时的，这意味着当您在查找字段中键入搜索短语或单词时，将立即在主题中搜索和选择搜索词。同样，要替换主题中的文本，请在相应的字段中输入搜索词及其替换词，然后选择替换或 全部替换 按钮。

在Source视图中，查找和替换 功能对于搜索特定元素或属性非常有用。例如，如果要替换@product属性的值，可以轻松地从Source视图中完成此操作。 “作者”视图不允许您根据属性或元素进行搜索。但是，在使用 全部替换 功能时必须小心，因为它可能会覆盖XML代码。

版本历史记录

编辑器中的 版本历史记录 功能允许您检查DITA文件的可用版本、比较这些版本以及从编辑器本身还原到任何版本。您可以将当前版本（也可以是工作副本）的内容和元数据与同一文件的任何先前版本进行比较。您还可以查看比较版本的标签和注释。

NOTE

仅当对主题或映射的第一个版本进行了更改时，才会显示版本历史记录选项。

访问版本历史记录的步骤

在编辑器中打开主题。
从菜单下拉列表中选择 版本历史记录。

出现 版本历史记录 对话框。

{width="550"}

预览不同版本主题中的更改。

在 比较对象 下拉列表中选择要比较或还原的主题版本。

note note
NOTE
如果某个版本应用了标签，则这些标签也会与版本号一起显示\（在括号中）。

启用 查看标签和注释 选项以查看应用于当前版本和比较版本的标签和注释。

您还可以在 版本历史记录 对话框中查看以下信息：

预览选项卡：新添加的内容为绿色字体，已删除的内容为红色字体。

元数据 选项卡：新添加的元数据为绿色字体，已删除的元数据为红色字体。

{width="550"}的元数据差异

在版本历史记录中比较不同版本的元数据。

note note
NOTE
系统管理员可以从设置中的“元数据”选项卡更改要显示的元数据。有关详细信息，请参阅选项卡栏的更多操作部分。

您还可以查看当前版本和比较版本的用户和时间详细信息。

从下拉列表中选择版本后，还原到所选版本 选项即可用。预览窗口显示当前版本与所选版本的主题之间的差异。

选择 还原到所选版本，将工作副本还原为主题的所选版本。

将显示“还原版本”对话框。

{width="550"}
\（可选\）提供还原为早期版本的原因。您也可以创建主题当前活动工作副本的新版本。
选择确认。

文件的工作副本将还原为所选版本。如果选择创建当前活动工作副本的新版本，则也会创建包含所有工作更改的新版本的文件。

在还原到早期版本时，将显示一个可视提示，指示您当前使用的版本不是最新版本。

版本标签

标签可帮助您确定特定主题在DDLC \（文档开发生命周期\）中的阶段。例如，在处理主题时，可以将标签设置为“已批准”。发布主题并提供给客户后，您可以为该主题分配“已发布”标签。

Experience Manager Guides允许您以自由格式文本格式指定标签或使用一组预定义标签。自定义标签将允许系统中的任何作者根据其选择指定标签。这提供了灵活性；但是，它会在系统中引入不一致的标签。要解决此问题，管理员可以配置一组预定义标签。有关配置预定义标签的详细信息，请在“安装和配置Adobe Experience Manager Guides as a Cloud Service”中查看 配置和自定义XML Web编辑器。

这些标签会以下拉列表形式显示给需要指定标签的作者。这可确保在系统中仅使用预定义、一致的标签。

您可以通过多种方法向主题应用标签 — Assets UI中的版本历史记录面板、基线 UI和编辑器。编辑器中的版本标签功能为作者提供了一种快速、轻松的方法为其主题分配标签。

从编辑器向主题添加标签的步骤

在编辑器中打开主题。
从“菜单”下拉列表中选择 版本标签。

此时将显示“版本标签管理”对话框。

{width="350"}

“版本标签管理”对话框分为两部分 — 左侧面板包含可用于主题的版本列表以及标签下拉列表\（或用于输入标签的文本框），右侧面板包含主题的预览。

选择要应用标签的版本。

从版本列表中选择其他版本的主题时，“预览”面板将显示当前版本与所选版本之间的更改

note note
NOTE
如果标签已应用于某个版本，则它将显示在下拉列表中的版本号旁边，以及“选择版本”列表的下方。您可以通过选择标签旁边的(x)图标来移除现有标签。

如果您的管理员定义了标签列表，则会显示一个标签下拉列表，您可以从中选择要应用的标签。您可以从下拉列表中选择多个标签。

否则，您会看到一个文本框，您可以在其中输入要添加到主题中的标签。

note note
NOTE
不能对主题的多个版本应用相同的标签。如果尝试关联现有标签，则可以选择将其从现有版本中删除，并将其应用到主题的所选版本。

选择 添加标签。
在“应用标签”确认消息中，选择 移动标签（如果用于其他版本） 选项，以将标签从现有版本移动到所选版本。如果不选择此选项，并且有标签被分配给主题的不同版本，则它们不会移动到所选主题的版本。在标签申请过程中会忽略此类标签。

合并

在多作者环境中工作时，很难跟踪其他作者在主题或地图中所做的更改。 “合并”功能不仅让您能够更好地控制变更的查看，而且还可以控制哪些变更保留在文档的最新版本中。

合并主题文件

要合并主题中的更改，请执行以下步骤：

在编辑器中打开主题。
选择合并。

此时将显示“合并”对话框。

{width="550"}
\（可选\） 您还可以浏览并从存储库中的其他位置选择新文件。
选择要与文件的当前版本进行比较的文件版本。
从“选项”中选择：
- 跟踪选定版本中的更改：此选项以跟踪的更改形式显示所有内容更新。然后，您可以选择一次接受或拒绝文档中的更改，或者一次接受或拒绝全部更改。
- 还原到所选版本：此选项将文档的当前版本还原到所选版本。此选项不会向您提供对接受或拒绝哪些内容的任何控制。
选择完成。
如果您选择了 跟踪来自所选版本 的更改选项，则来自所选版本的所有更改将显示在右侧面板的跟踪更改功能中。

您可以从“跟踪的更改”面板中选择接受或拒绝所有注释，或者接受或拒绝单个注释。

合并映射文件

要合并映射文件中的更改，请执行以下步骤：

在编辑器中打开映射。
选择合并。

将出现“合并”对话框。

{width="550"}
\（可选\） 您还可以浏览并从存储库中的其他位置选择新文件。
选择要与文件的当前版本进行比较的文件版本。
从“选项”中选择：
- 跟踪选定版本中的更改：此选项以跟踪更改的形式显示所有内容更新。然后，您可以选择一次接受或拒绝文档中的更改，或者一次接受或拒绝全部更改。
- 还原到所选版本：此选项将文档的当前版本还原到所选版本。此选项不会向您提供对接受或拒绝哪些内容的任何控制。
选择完成。
如果您选择了 跟踪选定版本 中的更改选项，则选定版本中的所有更改将显示在“跟踪的更改”面板\（位于右侧\）中。

您可以从“跟踪的更改”面板中选择接受或拒绝所有更改，或者接受或拒绝映射文件中的单个更改。

创建审核任务

您可以直接从编辑器创建当前主题的审阅任务或映射文件。打开要为其创建审阅任务的文件，然后从“菜单”下拉列表中选择 创建审阅任务 以启动审阅创建流程。

显示菜单

“显示”菜单包含以下功能：

跟踪更改： 您可以启用“跟踪更改”模式，以跟踪对文档所做的所有更新。启用跟踪更改后，文档将捕获所有插入和删除。使用删除线突出显示所有已删除的内容，并以绿色文本突出显示所有插入。此外，您还可以在主题页面的边缘获得更改条。再次重申，对于已删除的内容，将显示红色栏，对于添加的内容，将显示绿色栏。如果在同一行上进行了添加和删除，则会同时显示绿色栏和红色栏。
以下屏幕截图突出显示删除和插入的内容以及更改条：
{width="650"}

跟踪文档中的更改的典型用例可以是进行同行审阅。您可以启用跟踪更改并共享文档以供审阅，然后审阅者进行更改并启用跟踪更改。当您收到文档时，您应该具有查看建议更新的机制，以及一种接受或拒绝更改的便捷方式。

Experience Manager Guides提供了跟踪的更改功能，该功能包含在文档中进行的更新的相关信息。 “跟踪的更改”功能提供有关已进行哪些更新、谁进行了这些更新以及何时进行这些更新的信息。使用跟踪的更改功能，您还可以轻松地接受或拒绝文档中的建议更新。

要访问该功能，请选择右侧面板中的 跟踪更改 图标。

{width="300"}

选择跟踪的更改将选择文档中的已更改内容。您可以通过选择“接受更改”图标来接受更改，或通过选择“拒绝更改”来拒绝更改。

如果要通过单击接受或拒绝所有更改，请选择 接受所有更改 或 拒绝所有更改。

note note
NOTE
“预览”模式允许您查看文档，无论是否包含已更改内容的标记。有关详细信息，请查看预览模式。

标记： 编辑器中的标记功能是一个可控制DITA元素可见性的切换按钮。启用后，它会在内容中显示结构标记，使您能够更有效地查看和管理底层DITA元素。禁用后，编辑器将隐藏这些标记，从而提供更干净且更集中的创作环境。

以下屏幕截图显示了已启用“标记”视图的文档：

{width="650"}

下列操作可以在带有Tags的文档中执行：

选择元素：选择元素的开始或结束标记以选择其内容。
展开或折叠标记：选择标记中的+或 — 符号以展开或折叠标记。
使用上下文菜单：上下文菜单提供剪切、复制或粘贴选定元素的选项。您还可以在所选元素之前或之后插入元素。其他选项允许您生成ID或打开选定元素的“属性”面板。
拖放元素：选择元素的标记并将其轻松拖放到文档上。如果放置位置是允许元素的有效位置，则元素将放置在放置的位置。

note note

NOTE

如果用户从编辑器中启用“标记”视图，则即使跨会话，该视图也会保持启用状态。这意味着您无需再次启用“标记”视图即可稍后访问它。新用户会话的“标记”视图的默认值由tagsView文件中的ui\_config.json属性决定。有关更多详细信息，请参阅安装和配置Adobe Experience Manager Guides as a Cloud Service中的为标记视图配置默认值部分。

不间断空格： 启用此选项，以在编辑器中编辑不间断空格时显示指示符。它仅在DITA主题和DITA映射的作者视图中可见。

内容插入选项

元素 -

在当前或下一个有效位置插入有效元素。也可以使用键盘快捷键 Alt+Enter 打开“元素”对话框。例如，您正在编辑一个段落，然后在元素对话框中，将显示可插入段落中的元素列表。选择要插入的元素。您可以使用键盘滚动元素列表，然后按 Enter 插入所需的元素。

您可以查看两种类型的有效元素：

当前位置上的有效元素：此列表显示可在当前光标位置本身插入的元素。
当前位置之外的有效元素：列表显示可在元素层次结构中当前元素的任何父元素之后插入的元素。

例如，如果您在内联<b>元素中，则可以在当前位置插入诸如<u>、<xref>、<i>之类的元素。相反，您可以在当前位置之外插入诸如<table>和<topic>之类的元素。

您还可以在搜索框中键入字符或字符串，并搜索以它开头的元素。

插入元素 {width="300"}

输入't'以搜索所有以't'开头的有效元素。

如果您在块元素（如note）中工作，则使用插入元素图标在note元素之后插入新元素。在以下屏幕快照中，注释元素已插入p (paragraph)元素中：

在块元素中插入元素

如果在注释元素中按Enter键，则会在注释元素本身中创建一个新段落。要在注释外部插入新元素，请在元素痕迹导航中选择p元素\（在屏幕快照中高亮显示\），然后选择“元素”图标或按 Alt+Enter 以打开“插入元素”对话框。然后，选择所需的元素并按Enter键将所选元素插入到注释元素之后。

当出现闪烁的块光标时，您还可以在两个元素之间添加元素。

{width="300"}

例如，如果您正在处理DITA主题，并且块光标在简短描述和正文之间闪烁，则可以添加prolog元素，然后添加版权、作者和其他详细信息。

输入新元素的另一种方法是使用上下文菜单。在文档中的任意位置单击鼠标右键以调用上下文菜单。从该菜单中选择 插入元素 以显示 插入元素 对话框，然后选择要插入的元素。

{width="300"}

段落 -

在当前或下一个有效位置插入段落元素。

项目符号列表 -

在当前或下一个有效位置创建项目符号列表。如果您位于项目符号列表上并选择此图标，该项目将转换为普通段落。

编号列表 -

在当前或下一个有效位置创建编号列表。如果您在编号列表中并选择此图标，该项目将转换为普通段落。

NOTE

您还可以从列表项的上下文菜单中选择 拆分列表 选项以拆分当前列表并在同一级别开始一个新列表。

表 -

在当前或下一个有效位置插入表。选择“表”图标以打开“插入简单表”对话框。

{width="550"}

NOTE

您还可以从MS Word或Excel复制表并将其粘贴到Experience Manager Guides主题文件中。复制的表将粘贴为<simpletable>或<tgroup>，具体取决于XML编辑器配置中配置的设置。有关详细信息，请查看配置粘贴表的显示。

您可以指定表中所需的行数和列数。如果要将第一行保留为表标题，请选择 将第一行设置为标题 选项。要向表格添加标题，请在标题字段中输入该标题。

插入表后，可以使用上下文菜单修改表。

{width="550"}

使用该表的上下文菜单，您可以：

插入单元格、行或列
在右侧和向下合并单元格
水平或垂直拆分单元格
删除单元格、行或列
生成Id

定义表格中多个单元格、整行或列的属性

您还可以在表的多个单元格、整行或列上定义属性。例如，要对齐表格单元格，请拖动并选择所需的单元格。在右侧的“内容属性”面板中，属性 Type 更改为 entry。

在属性部分中，选择 +添加。
从@valign属性 下拉列表中选择 属性。
从值下拉列表中，选择要应用于选定表单元格的所需文本对齐方式。
选择 添加。

图像 -

在当前或下一个有效位置插入图像。选择“图像”图标以打开“插入图像”对话框，然后搜索并选择要插入的图像。

NOTE

您也可以通过将图像从本地系统拖放到文章上来添加图像。在本例中，使用 上传Assets 工作流添加图像文件。有关更多详细信息，请在 左侧面板 部分中查看上传Assets工作流。

{width="300"}

可以在“插入图像”对话框中为图像添加图像/图形标题和替换文本。

NOTE

插入图像并为该图像指定替换文本时，会按照最新的DITA标准将其添加到<alt>元素中。不建议将@alt属性用于替换文本，但在以前的DITA版本中仍支持此属性。

使用 选择文件 选项，您可以按文件名搜索所需的图像文件。您还可以按路径\（要在\）中搜索、收藏集、文件类型和标记筛选搜索结果。找到所需的图像文件后，选择该文件并选择选择将图像插入到文档中。您可以插入各种格式的图像文件，如.png、.svg、.gif、.jpg、.eps、.ai、.psd等。

插入图像后，您可以从“内容属性”面板中更改高度、宽度、版面和属性。选择图像文件，然后在右侧面板的“内容属性”面板中进行更改。

Source字段显示所插入图像文件的UUID。通过将鼠标指针悬停在Source字段上，可以找到所插入图像文件的完整路径。该路径将显示在工具提示中。

您可以通过提供图像文件的“高度”或“宽度”值来调整图像的大小。图像的纵横比会自动得到保持。如果需要，还可以选择不保持图像文件的长宽比，方法是选择(属于“保持长宽比”(Maintain Aspect Ratio)的)锁图标并提供“高度”(Height)和“宽度”(Width)值。

也可以将图像的“放置”设置指定为“内联”或“破断”。如果选择使用“断点”放置选项，则可以选择对齐图像的位置（“左”、“中”或“右”）。

您还可以通过在属性字段中选择所需的属性来为图像文件添加其他属性。

NOTE

您还可以在图像中定义可单击区域\（图像映射\）。有关更多详细信息，请在 左侧面板 部分中查看插入/编辑图像映射功能说明。

图像或媒体文件的 上下文菜单

也可以使用上下文菜单对图像和媒体文件执行一些常见操作。在图像上的任意位置单击鼠标右键以调用上下文菜单。

上下文菜单提供剪切、复制或粘贴图像或媒体的选项。可在所选元素之前或之后插入元素。您还可以选择重命名或取消元素包装。您可以在存储库中找到选定的图像或媒体，或在Assets UI中查看文件预览。

上下文菜单中的其他选项允许您复制路径、编辑图像映射、重命名元素、创建代码片段或为所选元素生成ID。

插入/编辑图像映射

在选定图像上插入图像映射。具有链接到主题或网页的可单击区域的图像称为图像映射。

在当前主题中选择图像，然后选择插入/编辑图像映射图标，以打开插入图像映射对话框。

{width="650"}

选择首选形状矩形、圆形或多边形以定义要用作链接的图像的区域。定义区域后，将出现“引用”对话框，您需要在其中指定指向内部或外部内容的链接：

{width="650"}

如果区域重叠，可以通过单击工具栏中相应的图标来将形状前移或后移。您也可以通过选择某个区域并单击删除图标来删除该区域。双击某个区域会打开“参照”对话框，您可以在其中更改目标链接。在图像上标记所需的区域后，选择完成以保存更改。

多媒体

插入不同类型的多媒体文件。选择“多媒体”下拉图标，然后选择要插入的文件类型。支持的多媒体格式包括：

音频文件
视频文件
YouTube
Vimeo

选择“音频或视频文件”选项时，将显示存储库视图，以浏览并选择所需的文件。如果选择YouTube或Vimeo，则会显示“插入多媒体”对话框。将视频文件的链接粘贴到Web链接字段中，然后选择插入以在文档中的当前或下一个有效位置添加视频。

NOTE

添加YouTube视频链接时，您需要在URL中将字符串watch?v=替换为embed。例如，要添加YouTube视频链接： https://www.youtube.com/**watch?v**=WlIKQOrmZcs，您需要将其添加为： https://www.youtube.com/**embed/**WlIKQOrmZcs。此更改可确保在AEM Site和PDF输出中嵌入视频。

也可以从“插入多媒体”对话框添加音频或视频文件。选择“音频/视频文件”选项，然后选择浏览图标以启动存储库视图。从存储库中选择音频或视频文件，然后选择选择以在“音频/视频文件”字段中添加该文件的链接。如果选择视频文件，则文件的预览也会显示在“预览”区域中。您可以播放视频文件以查看其预览。

{width="650"}

交叉引用

插入以下类型的引用：内容引用、内容键引用、键引用、文件引用、Web链接或电子邮件链接。

选择 选择文件 图标\（用于内容引用和文件引用\）或 选择根映射 图标\（用于内容键引用和键引用\），然后选择要链接到的所需文件或内容。

{width="650"}

所选引用的链接即添加到文档中。链接上的上下文菜单为您提供了以下选项：

插入元素：显示可在给定上下文中插入的有效元素列表。
复制UUID：复制插入引用的UUID。
复制路径：复制插入引用的完整路径。
生成ID：为插入的引用生成唯一ID。

您也可以使用要引用的文件的UUID进行搜索。对于“内容”和“键引用”链接，输入要链接到的文件的UUID，将自动搜索该文件并在“预览”部分中显示该文件。指定文件的UUID时，无需明确提及.xml文件的文件扩展名。 .xml扩展名会自动附加到UUID中。

{width="650"}

如果您的管理员在 XMLEditorConfig 中启用了UUID选项，则您将在 Link 属性中查看引用内容的UUID。

NOTE

如果未启用 启用UUID 选项，则会显示引用内容的相对路径。

IMPORTANT

即使引用内容的相对路径显示在 Link 属性中，链接仍使用引用内容的UUID在内部创建。

TIP

查看最佳实践指南中的引用部分，了解有关引用内容的最佳实践。

筛选搜索

您可以在AEM存储库选定路径上的文件中搜索某些文本。例如，“general”会在下面给定的屏幕快照中进行搜索。您还可以使用增强型筛选器缩小搜索范围。您可以查找选定路径中存在的所有DITA文件，如DITA主题和DITA映射。

您可以在所选路径中搜索非DITA文件，如图像文件、多媒体和文档。您还可以在DITA元素的属性中搜索特定值。您还可以查找由指定用户签出的文件。

{width="650"}

NOTE

系统管理员还可以配置文本过滤器，并显示或隐藏其他过滤器。有关更多详细信息，请参阅安装和配置Adobe Experience Manager Guides as a Cloud Service中的 配置文本过滤器 部分。

将显示包含搜索文本的已过滤文件的列表。例如，在上面的屏幕截图中，列出了包含文本“general”的文件。您还可以预览文件的内容。

可重复使用的内容 -

重复使用项目中任何其他文档中存在的内容。您可以插入内容，方法是直接链接到文件中的内容，或者使用键引用，查看解析键引用。当选择可重用内容图标时，您将看到重用内容对话框：

{width="650"}

在“重用内容”对话框中，为文件引用选择DITA文件，或选择包含键引用的DITA映射文件。选中后，该主题或关键引用将显示在对话框中。您可以选择要插入的主题的ID/键，然后选择完成以在主题中插入内容。

对于插入“内容引用”，您还可以输入文件的UUID，并且该文件中的可重用内容将在“预览”部分中列出。

根据插入链接的设置，您可以在“属性”面板或Source代码视图中查看插入内容的UUID或相对路径。链接始终使用引用内容的UUID创建。在“安装和配置Adobe Experience Manager Guides as a Cloud Service”中查看 配置基于UUID的链接。

NOTE

若要在引用的内容之前或之后添加内容，请使用 Alt+Left 箭头键或Alt+Right 箭头键将光标移动到所需位置。

您还可以将引用的内容嵌入主题中，方法是右键单击引用的内容，然后从上下文菜单中选择 将引用替换为内容。

符号 -

在主题中插入特殊字符。选择“符号”图标以打开“插入特殊字符”对话框。

NOTE

Experience Manager Guides提供了可移动和可调整大小的对话框。可以在右下角调整具有两条交叉线的对话框的大小。 “特殊字符”对话框中的交叉线如下所示。

{width="350"}

在“插入特殊字符”对话框中，可以使用特殊字符的名称搜索特殊字符。所有特殊字符都存储在各种类别下。使用选择类别下拉列表并选择类别。将显示所选类别中可用的特殊字符。您可以使用箭头键浏览特殊字符列表，或选择要插入的所需字符。所选特殊字符的“名称”和“十六进制代码”显示在列表下方。选择插入以在文档中插入选定的字符。

关键字 -