编辑器中的其他功能 id2056B0B0YPF
编辑器中还有一些其他有用的功能可供您使用:
文件选项卡上的上下文菜单功能
在编辑器中打开文件时,可以从上下文菜单执行各种操作。 根据您是打开介质文件、单个DITA文件还是多个文件,可能会查看不同的选项。
媒体文件
在打开的媒体文件选项卡的上下文菜单中,可以获取以下功能:
单个DITA文件
在打开的文件选项卡的上下文菜单中,可以获取以下函数:
多个文件
打开多个文件时,上下文菜单中会提供更多选项:
上下文菜单中的各种选项说明如下:
保存:您可以选择以下选项:
-
保存:要保存文件而不创建新版本,请选择保存。 无论何时创建新主题,都会在DAM中创建该主题的无版本工作副本。 保存文档将更新DAM中文档的工作副本。 在此版本上执行简单保存不会创建主题的新版本。 如果您的主题正在审阅,则保存主题不会向审阅人授予对已更改主题内容的访问权限。
-
全部保存:如果在编辑器中打开了多个文档,则您还将获得一个 全部保存 已打开文档的选项。
另存为新版本
若要创建文件的新版本,请选择另存为新版本。 有关 保存 和 另存为新版本 的更多详细信息,请在编辑器中查看工具栏。
复制:您可以选择以下选项:
- 复制UUID:要将当前活动文件的UUID复制到剪贴板,请选择复制>复制UUID。
- 复制路径:若要将当前活动文件的完整路径复制到剪贴板,请选择复制>复制路径。
在中查找:您可以从以下选项中进行选择:
-
映射:如果您打开了一个大的DITA映射,并且希望在该映射中找到文件的确切位置,请选择在>映射中定位。 选择在映射中查找选项时,文件\(调用该选项的位置\)将位于映射层次结构中并突出显示。 要能够使用此功能,必须在编辑器中打开映射文件。 如果映射视图处于隐藏状态,则调用此功能将显示映射视图,并且该文件会在映射层次结构中突出显示。
-
资源管理器:与“在地图中定位”类似,在>资源管理器中定位显示文件在资源管理器\(或DAM\)中的位置。 打开“资源管理器”视图,并在“资源管理器”中突出显示选定的文件。 如果文件位于文件夹中,则该文件夹将展开以显示所选文件在资源管理器中的位置。
note note NOTE 从2025.11.0版本开始,存储库重命名为资源管理器。 对于内部部署设置,在Experience Manager Guides 5.1版发布之前,它将继续作为存储库提供。
添加到:您可以从以下选项中进行选择:
属性
要查看所选文件的AEM属性页,请选择属性。
拆分:您可以选择以下选项:
向上、向下、向左或向右
默认情况下,编辑器允许您一次查看一个主题。 可能存在您想要同时查看两个或更多主题的实例。 拆分编辑器的屏幕允许您同时查看多个主题。 例如,如果您在编辑器中打开了两个主题 — A和B。 右键单击主题B并选择 拆分>向上 将编辑器窗口分为两部分。 主题B显示在上半部分,主题A显示在下半部分。 同样,您还可以通过选择 拆分>左侧 或 拆分>右侧 来水平拆分屏幕。 您可以通过将“文件”选项卡拖放到要放置文档的屏幕上,将文档从一个屏幕移动到另一个屏幕。 同样,您也可以根据自己的喜好通过拖动和移动文件选项卡来重新排序它们。
关闭:您可以选择以下选项:
关闭、关闭其他或全部关闭
如果要关闭从中调用上下文菜单的文件,请选择关闭>关闭。 使用 关闭>关闭其他 以关闭除当前活动文件之外的所有其他打开的文件。 要关闭所有打开的文件,请从上下文菜单中选择 关闭>全部关闭 选项,或者也可以选择关闭编辑器。 如果会话中有任何未保存的文件,则会提示您保存这些文件。
文件关闭并保存方案
当您尝试使用文件选项卡上的 关闭 按钮或“选项”菜单中的 关闭 选项关闭在编辑器中打开的文件时,Experience Manager Guides会提示您保存编辑内容并解锁锁定的文件。
提示基于管理员选择的以下配置:
- 关闭时要求解锁:关闭编辑器时,您可以选择解锁文件\(您已锁定\)。
- 关闭时询问新版本:关闭编辑器时,您可以选择将文件\(您已编辑过\)另存为新版本。
您的文件保存体验将取决于以下三种场景,其中您具有:
- 未对内容进行任何更改。
- 编辑了内容并保存了更改。
- 已编辑内容,但未保存更改。
您可以查看以下选项,具体取决于文件是否已锁定/解锁,以及是否已保存或未保存的更改:
-
解锁并关闭:文件锁定已解除,文件已关闭。
-
另存为新版本:这将保存您在内容中所做的更改,并创建文件的新版本。 您还可以为新保存的版本添加标签和注释。 有关保存新版本的更多信息,请查看另存为新版本。
-
解锁文件:如果选择解锁文件,文件将解除锁定,更改将保存在文件的当前版本中。
note note NOTE 如果取消选择用于解锁文件的选项,则还可以选择关闭文件而不保存更改的选项。 例如,以下屏幕快照中显示了以下提示之一:
{width="400"}
损坏引用的视觉提示
如果主题包含损坏的交叉引用或内容引用,则它们将以红色文本显示。
智能复制粘贴
您可以轻松地在主题内和主题间复制粘贴内容。 源元素结构将在目标处进行维护。 此外,如果复制的内容包含内容引用,那么即使这些引用也被复制。
记住上次浏览的位置
编辑器提供了一个智能文件浏览对话框。 插入引用或内容时,编辑器会记住上次使用的位置。 第一次调用文件浏览对话框\(通过“插入引用”或“插入重用内容”\)时,将转到保存当前文档的位置。 在同一会话中,如果尝试插入另一个参照,则文件浏览对话框会自动导航到插入最后一个参照的位置。
支持基于文章的发布
从编辑器中,可以为一个或多个主题或整个DITA映射生成输出。 您需要为DITA映射创建输出预设,然后可以轻松生成一个或多个主题的输出。 如果更新了映射中的几个主题,则也可以仅从编辑器中生成这些主题的输出。 有关详细信息,请查看基于文章的发布。
支持Markdown文档
该编辑器允许您将Markdown文档(.md)与DITA文档一起使用。 您可以在编辑器中轻松创作和预览Markdown文档,还可以通过DITA映射编辑器将其添加到映射文件中。 有关更多详细信息,请通过编辑器查看创作Markdown文档。
支持DITA术语主题
编辑器支持可通过添加term或abbreviated-form元素插入的DITA术语表。
使用MathML公式
插入MathML公式
Experience Manager Guides为您提供开箱即用的支持,以便通过与MathType Web应用程序集成来插入MathML公式。 要插入MathML公式,请选择 元素 图标并键入mathml。 从列表中选择mathml元素时,将显示 插入MathML 对话框:
使用MathML方程式工具,创建方程式并选择 插入 以将其添加到文档。 该公式使用浅灰色背景插入。
您可以随时更新公式,方法是右键单击现有公式并从上下文菜单中选择编辑MathML。
在MathML编辑器中验证公式
当您保存包含公式的主题时,Experience Manager Guides会验证MathML公式。
使用MathML编辑器插入公式时,如果存在任何语法问题,Experience Manager Guides会以红色突出显示公式。 您可以在插入之前更正它。 如果您未进行任何更改,但选择插入,则会显示警告。
如果插入包含语法错误的MathML公式,则在尝试保存主题时会发生验证错误。
插入脚注
使用fn元素在内容中插入脚注。 在创作模式下,脚注值与内容内联显示。 但是,当您切换“预览”模式或发布文档时,脚注会出现在主题末尾。
重命名或替换元素
编辑器在主题的左下角显示元素的痕迹导航。 如果要使用其他元素交换或替换元素,则可以从痕迹导航的上下文菜单执行此操作。 例如,您可以将p元素与上下文中的note或任何其他有效元素交换。
在痕迹导航上,右键单击要替换的元素名称,然后从上下文菜单中选择重命名元素。 “重命名元素”对话框显示当前位置允许的所有有效元素。 在重命名元素对话框中,选择要使用的元素。 原始元素被替换为新元素。
除了痕迹导航的上下文菜单之外,还可以从其他位置访问“重命名元素”对话框:
-
在痕迹导航上选择元素名称以选择元素的内容,并右键单击选定内容以调出上下文菜单。
-
启用“标记”视图,选择任何元素的开始标记,然后右键单击选定的内容以调出上下文菜单。
-
可通过调用“轮廓”面板中元素的“选项”菜单来访问“重命名元素”对话框。
包装和展开元素
将元素换行
-
使用元素换行,可以向所选文本添加元素标记。 您可以按照DITA标准将文本换行到任何子元素。 例如,如果在
note元素下有文本,则可以将文本换行到p元素。 -
在主题痕迹导航的上下文菜单中,环绕元素选项可用。 要环绕元素,请右键单击该元素并打开上下文菜单。 从 Wrap Element 对话框中选择元素。 该文本将显示在新元素中。
-
您还可以选择内容中的文本或元素,然后从上下文菜单中选择 环绕元素 选项。
取消包裹元素
通过展开元素,可以从所选文本中删除元素标记并将其与其父元素合并。 例如,如果在p元素中有一个note元素,则可以取消换行p元素以直接在note元素中合并文本。 在主题痕迹导航的上下文菜单中,取消环绕元素选项可用。 若要取消环绕某个元素,请右键单击该元素以打开上下文菜单,最后选择 取消环绕元素 以删除该元素并将该元素的文本与其父元素合并。
DITA元素的空格处理
在XML中,空格包括空格、制表符、回车符和空行。 Experience Manager Guides将多个后续空格转换为一个空格。 这有助于保留编辑器的WYSIWYG视图。
<pre>和<codeblock>个元素。保留换行符和缩进
根据在“创作”、“Source”或“预览”模式中的定义以及最终发布的输出中的定义,支持并呈现包含换行符和空格的DITA元素。 以下屏幕截图显示了msgblock元素中的内容,其中换行符和空格(indentation)已被保留:
在编辑器中处理不间断空格
-
您可以使用Symobol
图标或Alt + 空格快捷键在文档中插入不间断空格。 在编辑器中编辑主题时,这些不间断的空格会显示为指示符。 在 用户首选项 的 外观 选项卡中,可以使用在创作模式下显示不间断空格指示符选项关闭不间断空格的显示。 -
如果将任何外部源中具有不间断空格的内容复制并粘贴到 创作 视图中,则不间断空格的内容将转换为空格。
但是,如果您从 创作 视图中复制并粘贴带有不间断空格的内容,则该内容会保留。
自动生成元素ID
您可以为DITA主题中的元素自动生成ID。 这些ID在DITA主题中是唯一的。 例如,如果为段落元素生成ID,则ID将为p_1、p2、p_3等。 您可以选择多个元素,并为每个选定的元素生成ID。
执行以下操作可自动生成一个或多个元素的ID:
- 在编辑器中打开主题。
- 选择要为其分配ID的内容。
- 右键单击并从上下文菜单中选择生成ID。
或者,您可以右键单击痕迹导航并选择生成ID。
为映射中的元素或创作视图中的主题标识重复ID
如果给定主题或映射包含具有重复ID的元素,则 重复ID 按钮将显示在编辑器视图旁边的内容编辑区域的右下角。
选择 重复ID 将打开一个弹出窗口,其中列出了所有重复ID。 您可以从弹出框中选择显示的ID,以导航到相应的元素,并使用唯一ID对其进行更新。
在编辑器中处理大文件
提出了改善大文件处理能力的关键功能:
-
为了提高性能,某些功能(如撤消、重做、大纲面板和脏标记)将被禁用。 建议将主题分成较小的主题以获得最佳体验。
-
对于大型文件,顶部会显示一条警告消息,如下面的代码片段所示。 此警报会根据uiconfig.json文件的 largeFileTagCount 参数中指定的值突出显示元素的数量。 默认情况下,largeFileTagCount设置为2500。
- 此外,标签计数会显示在界面的底部栏中。 当您将鼠标悬停在此标记计数值上时,将会显示工具提示。 选择 了解更多 选项卡提供了有关处理大型文件的详细信息。
- 警报消息仅适用于DITA文件,并且在所有视图(创作、Source和布局)中都可见。
父主题:编辑器简介