修复了5.2.0版本（2026年5月）中的问题

最近更新： 2026年5月29日

创建对象：

User

本文介绍5.2.0版本的Adobe Experience Manager Guides中修复的各个方面的错误。

有关新增功能和增强功能的详细信息，请查看5.2.0版本中的新增功能。

了解5.2.0版本🔗的升级说明。

创作

如果将没有属性或值的空prop元素添加到DITAVAL文件中，则无法添加其他prop元素。（指南 — 33597）
将Experience Manager Guides升级到2025.08.0版本后，Workspace设置中不再显示启用或禁用自定义 Acrolinx 选项卡的选项。（指南 — 35261）
在浏览器刷新时，在主题或映射的文件夹级别配置文件中应用的自定义CSS将恢复到预览模式中的默认样式。（指南 — 31098）
撤消和重做操作在DITA文件编辑器的Source视图中无法按预期工作。（GUIDES-24914和GUIDES-25034）
使用Xref元素在主题中引用DITA映射时，将显示引用的映射的文件名而不是映射标题。（指南 — 21759）
通过编辑器界面的右侧面板添加多个Schematron文件进行验证时，即使添加的文件有效且没有错误，也会显示错误Schematron文件不存在或存在错误。（指南 — 33731）
大型或复杂的MathML公式无法在编辑器中显示。（指南 — 29095）
当打开多个DITA映射或主题并且其中一个主题关闭时，显示所有打开的选项卡的 >> 按钮与选项卡栏上其余打开的选项卡重叠。（指南 — 31421）
启用 审批工作流 后，如果左侧面板和内容属性面板均打开，则编辑器工具栏上不会显示 开始新版本 按钮。（指南 — 29093）
当代码片段名称超过代码片段面板的宽度时，它们会错误地封装到下一行中，从而导致与相邻的代码片段重叠并影响可读性。（指南 — 22685）
当您将同一引用多次添加到DITA映射时，映射视图仅显示最后一次出现的标题，而以前的视图显示引用的UUID。 (GUIDES-9699)
DITAVAL文件保持可编辑状态，即使它们被其他用户锁定，或者服务器启用了 禁用编辑，但不锁定文件 并以只读模式打开文件。（指南 — 27754）
正在从内部清理作业生成缺少节点的日志，这些作业不是必需的，并且被错误地标记为错误，从而导致日志文件混乱。（指南 — 31765）
在编辑架构(*.sch)文件并使用查找和替换功能时，“查找和替换”面板在底部部分显示在屏幕外，阻止访问其输入字段和控件。（指南 — 38412）
无法从 另存为新版本 对话框向主题添加多个版本标签。（指南 — 32716）
使用 选择文件 对话框在编辑器中选择图像时，只显示光栅格式（如JPG、PNG和GIF）。矢量文件(如.ai和.eps)不显示，也无法选择。（指南 — 45110）
在升级时，tagsView设置默认关闭，即使它在ui_config.json中的默认值设置为true。（指南 — 44651）
在编辑器中，文件引用显示为GUID，而不是文件路径，尽管配置了xmleditor.uuid。（指南 — 42438）
当在DITA主题中应用具有相似键值的主题方案时，它们以几乎相同的颜色突出显示，这使得难以区分它们并识别应用了哪个方案。（指南 — 38472）
在创作视图中编辑主题方案映射时，添加hasInstance元素会自动触发文件选择对话框，要求作者插入指向AEM资源的无需href。此外，无法为此类映射加载 内容属性 面板，这会阻止作者更新创作视图中的元素属性，并要求他们使用Source视图来更新属性。（指南 — 38164）
在编辑.ditaval文件时，当您切换到“创作”视图，然后返回到Source视图时，将删除在Source视图中添加的所有XML注释。（指南 — 33228）
使用上下文菜单中的编辑MathML选项更新内联MathML公式时，在刷新页面之前，更新后的值不会反映出来。（指南 — 38198）
当主题包含许多可重用元素（具有ID的元素）添加到可重用面板时，由于容器高度固定，某些元素可能无法访问。（指南 — 37220）
插入对文件的交叉引用时，映射和主题的图标相同。（指南 — 36662）
编辑地图时，navtitle中的特殊符号不会在“创作”视图中为topichead显示。（指南 — 35435）

资产管理

当您通过Experience Manager Guides UI重新上传编辑后的图像时，图像的原始演绎版会更新，但关联的DITA内容会继续显示图像的先前版本。（指南 — 33693）
当尝试将两个或更多文件夹从它们的源位置移动到不同的位置时（使用批量移动工具），如果文件夹名称以相同的字符串开头（例如Product和ProductImages），则操作失败。（指南 — 29096）
从Omnisearch Assets UI中删除搜索出的资源时，会绕过 强制删除 警告对话框并直接删除该资源，即使它在现有DITA内容中被引用也是如此。（指南 — 17232）
无法从Assets UI的 版本历史记录 面板中删除版本标签。（指南 — 38276）
在名称中包含空格的文件夹中创建主题时，会错误地创建一个重复的文件夹，其中空格被连字符替换，并且主题会保存在该文件夹中而不是原始文件夹中。（指南 — 41938）
在首次翻译大型地图时，会为目标语言创建空XML文件，导致服务器负载增加和性能降低。（指南 — 41613）
在Assets搜索中，子资源和元数据节点（如图像和PDF）错误地包含在结果中。此外，对于应用DITAVAL筛选器时的输出预设，搜索将返回从条件预设创建的内部生成的DITAVAL文件。（指南 — 35418）
上传文件名包含无效字符的资源时，资源上传失败并显示不正确的消息 文件被其他用户 锁定，尽管资源已解锁。（指南 — 32680）

发布

在AEM Sites上使用基线（使用旧版组件映射）发布DITA映射时，也会发布属性为processing-role = resource-only的映射元素。（指南 — 37649）
在某些情况下，发现AEM Sites输出页面（具有旧版组件映射）中缺少jcr:content/fmUuidOfSource属性，导致新创建的内容页面不可发现。（指南 — 34242）
通过DITAVal过滤器和条件预设进行内容过滤不适用于Salesforce发布。（指南 — 33515）
如果地图内容层次结构中存在同名文件夹，则无法为地图创建本机PDF预设。（指南 — 33012）
使用动态基线生成本机PDF输出时，术语 PDFProject 显示为PDF标题，而不是实际的映射标题。（指南 — 31102）
在主题引用中生成具有某些print属性值的本机PDF输出无法按预期工作。（指南 — 31101）
使用Assets UI或 批量移动 选项移动包含DITA映射的文件夹时，无法加载引用这些映射的现有映射集合和批量激活集合。（指南 — 28355）
移动包含带有条件预设的映射的文件夹时，移动后生成的输出中不应用条件。（指南 — 28352）
使用旧版组件映射生成AEM Sites输出时，使用copy-to属性的主题将通过copy-from主题的名称（而不是copy-to属性中设置的名称）发布。（指南 — 22155）
从 批量发布仪表板 激活一个或多个DITA映射会生成超大日志。（指南 — 20746）
在生成PDF时，如果任何属性名称包含句点，则会忽略DITAVAL文件中的过滤规则。（指南 — 33229）
即使包含topichead元素的DITA映射无法发布其中的主题，Salesforce发布也会在UI上显示成功状态。（指南 — 32143）
对于HTML5输出预设，搜索筛选器功能在AEM Assets中无法用于DITAVAL筛选，因为选择DITAVAL筛选器时，相应的文件未显示。（指南 — 28231）
为具有多个主题的DITA映射生成本机PDF时，如果任何主题在figgroup中包含fig元素以及title，则figgroup标题在目录中错误地呈现为章节标题。（指南 — 23223）
从UI复制PDF模板时，也会复制UUID，从而导致模板文件被删除并导致PDF输出不正确。（指南 — 30456）
在为DITA映射生成本机PDF时，example元素的标题将呈现为h1标题级别，从而导致视觉不一致和TOC结构不正确。（指南 — 19958）
当使用不同的条件预设在多个映射中重用同一主题时，将最新映射发布到Salesforce会覆盖主题内容，从而导致向以前发布映射的用户显示的数据不正确。（指南 — 37806）
为包含条件处理或某些嵌套映射的映射发布本机PDF时，映射中定义的dc:title无法显示在PDF封面中，从而导致缺少封面标题。（指南 — 37733）
为映射生成AEM站点输出（使用复合组件映射）失败，并在输出路径中存在map_title变量时导致错误。（指南 — 36968）
当在本机PDF输出预设中指定了带尾随斜杠的输出路径时，UI会自动附加额外的尾随斜杠，从而导致在某些情况下导致PDF上传失败的双斜杠路径。（指南 — 34932）
通过“快速发布”或“管理发布”发布从DITA内容生成的AEM Sites页面时，会无意中发布关联的DITA资产。（指南 — 27967）
在将映射发布到AEM Sites（使用旧版组件映射）时，交叉引用(xrefs)具有scope = peer且在其他映射中针对主题的子元素（例如段落）时，交叉引用不会解析为特定的元素ID，而是只解析为父级主题，从而导致页面在主题的开头加载，而不是滚动到预期部分。（指南 — 21802）
在AEM Sites上使用基线（使用旧版组件映射）发布DITA映射时，也会发布属性为processing-role = resource-only的映射元素。（指南 — 34298）
当对文件夹配置文件中输出预设的更改应用于现有映射时，为AEM Sites预设保存的 发布上下文 将被重置。（指南 — 38377）
当在地图或书签的标题中使用tm元素时，商标符号(®)不会呈现在本机PDF输出的封面中。（指南 — 28832）
使用本机PDF模板发布映射时，映射标题不包含映射title中使用的子元素中的内容，并且对应的内容筛选未应用于标题。(GUIDES-33730)
当AEM Sites输出中的交叉映射对等链接指向使用chunk="to-content"的topicref时，无法解析。（指南 — 37873）
在发布期间，与基于DITAVAL的标记相关的文件将移动到新的系统生成的文件夹中，而不是保留在输出中它们预期的相对位置。（指南 — 37564）
当使用具有冲突条件的多个DITAVAL文件时，原生PDF输出失败。（指南 — 37484）
创建或编辑包含引文的主题时，如果未在引文对话框中添加“创作”字段，则不会生成PDF。（指南 — 37934）
生成AEM Sites输出时，发布的输出中不包含包含关键字和主题标题以及<ph>元素的映射标题。（指南 — 36641）
CSS文件(rhdefault.css)被错误地应用于PDF模板，即使没有引用CSS，这会导致缺少CSS文件错误日志。(GUIDES-31752)
在发布预设期间下载带有基线的地图的临时文件时，metadata.xml文件错误地引用了versionPath而不是dampath。(GUIDES-29815)
对于本机PDF输出，将忽略图像的<alt>元素，从而阻止将替换文本应用于辅助功能。（指南 — 29087）
在本机PDF输出中，abbreviated-form元素显示glossterm，而不是指定的glossSurfaceForm或glossAcronym。（指南 — 26393）
执行批量激活时，包创建会为页面的fileReference属性下列出的所有路径添加过滤器，包括外部路径和对等路径。（指南 — 24887）
当使用包含指向PDF的链接的内容的自定义预设进行发布时，并且该范围未设置为外部时，流程将无法完成。（指南 — 21708）
当具有相同名称和URL的主题已存在时，Salesforce发布会失败，并出现应用程序错误。（指南 — 32390）
即使为输出预设启用了 使用自动连字 设置，本机PDF输出中也不会应用自动连字。（指南 — 19703）

翻译

在翻译UI屏幕中缩放时，发送以进行翻译按钮移动到省略号下方，并且变为启用状态，即使未选择任何资产也是如此。（指南 — 33720）
当在翻译UI中选择状态为 不同步 的文件，并且屏幕宽度由于左面板和右面板的打开而受到限制时，发送以进行翻译标签将被截断。（指南 — 33692）
当最初作为具有特定版本（例如，在/en/下）的特定于语言的资产管理的图像移动到具有更新版本的全局文件夹并执行基线导出时，新基线将继续引用该图像的已过时的语言特定版本，从而导致基线导出失败。（指南 — 39394）
处理在Experience Manager Guides外部创建的翻译项目时，会生成多个错误日志消息，以声明fmTarget属性未找到。（指南 — 37804）

基准线

创建动态基线时，编辑器有时会因多个并发API请求而变得无响应，从而导致所有其他操作停止。（指南 — 39054）
使用自定义DITA-OT时，映射中的主题引用错误地显示为间接引用，即使它们被直接引用。此问题已使用新的基线体验得到解决。（指南 — 19286）
具有scope="peer"的引用错误地包含在基线上下文中，从而导致发布时间比预期时间长。此问题已使用新的基线体验得到解决。（指南 — 41823）

审阅

将用户分配给审核任务时，下拉列表会列出所有用户，而非仅列出与所选项目关联的用户，从而导致用户选项无效。（指南 — 37781）
当审核者完成审核任务或发起者更新审核任务而未输入注释时，发送的通知电子邮件将显示最近的前一个注释。（指南 — 33590）

报告

打开地图的报表时，“筛选器”面板的加载存在延迟(GUIDES-39385)
划分列表报告错误地包含当前映射范围内正确解析的外部链接、有效的keyrefs和关键字。（指南 — 27774）

平台

通过Assets UI上传资源或从编辑器界面创建新文件时生成的错误日志，在日志消息中错误地使用术语predecessor而不是successor。（指南 — 35607）
在主题或映射中使用scope="external"引用DAM内容会导致资源的相对路径被替换为GUID。（指南 — 38783）
当主题包含从具有许多文件的文件夹链接的大量引用时，创作实例可能会变得缓慢或无响应，在某些情况下，需要重新启动实例。（指南 — 43547）
在尝试保存主题或映射时，操作可能会间歇性地失败，并出现 无法保存文件 错误，尤其是在后台运行密集型资源处理任务或翻译工作流期间。（指南 — 37837）

编辑器2.0中可用的已解决的问题

以下问题已修复，且在使用Editor 2.0（又称New Editor）时不再出现：

从表中删除两列或更多列时，表结构会变得不一致或损坏。（指南 — 35438）
从包含合并单元格的表中删除列时，会添加新的空白列。（指南 — 30147）
通过痕迹导航菜单在现有表中插入新行时，表结构会意外更改，导致缺少边框和额外的列。（指南 — 29194）
在“创作”视图中，复制和粘贴表格行会将内容放置在表格之外，而不是将其作为表格中的新行插入。（指南 — 24372）
在创作模式下使用鼠标拖动选择的节元素被复制并粘贴时，它将转换为段落(<p>)元素，而不是保留节结构。（指南 — 30023）
编辑元素内的高亮显示文本（如step或uicontrol）时，所选文本无法正确替换，而是进行追加或追加，从而导致验证错误。（指南 — 24371）
当使用相对值设置表列宽时，其余列不会按比例调整，从而导致表布局未对齐。（指南 — 26109）
在禁用标记的情况下粘贴复制的主题标题时，第一次粘贴应用错误的样式，并将内容属性中的类型指定为主题而不是标题。（指南 — 28838）
在编辑大部分内容时，意外的滚动移动会导致编辑器视图从活动内容中跳出。（指南 — 35436）
在元素上使用Backspace时，无论光标位置如何，编辑器都会滚动到主题的顶部。（指南 — 32520）
当使用向左或向右箭头键从内联标记中移出时，光标在第一次尝试时意外跳转。（指南 — 26363）
AEM Spellcheck仅适用于默认的en-US语言，不适用于其他区域设置。（指南 — 14731）
在编辑器中解锁大型DITA主题时，同一主题将在重复选项卡中重新打开。此外，还会触发标记限制警告，其中显示NaN而不是实际标记计数。（指南 — 34008）
对于只读或锁定的主题，Acrolinx建议在编辑器中未正确高亮显示。（指南 — 29614）
在创作视图中创建没有标题行的新reltable时，在第一个单元格中添加主题后，表布局会发生更改，导致下一列折叠并难以放置相关主题。（指南 — 19555）
在“创作”模式下将xref链接添加到小型表单元格时，该链接不会保留在单元格内，而是会跨同一行的相邻单元格显示。（指南–5489）
从创作视图切换到Source视图时，光标位置不会保留，并且编辑器会滚动回顶部。此外，在长主题中，在Author视图和Source视图之间切换时，光标位置会丢失并随机跳转到中间或顶部。（GUIDES-18114和GUIDES-21164）
在<li>元素内按 Enter 将创建新的<li>，但导航回前一个<li>并按 Enter 将错误地将当前项目的内容转换为<p>元素，从而破坏列表结构。（指南 — 27505）

已知问题

创作

在上传DITAVAL文件中标记的图片时，如果禁用Enable UUIDs设置，则浏览器刷新后图片会中断。（指南 — 45853）
在编辑器中，启用 审批工作流 后，.ditval和.md文件将变为不可编辑。（指南 — 42037）
在预览模式下选择主题时，如果该主题位于书签映射标记（frontmatter、chapter、part或batter）中或部分循环内容中，则不会在地图视图中高亮显示该主题。（指南 — 42416）
当文件在编辑器和搜索面板中打开时，从“资源管理器”面板中删除该文件会移除该文件并刷新“资源管理器”列表，但刷新页面会继续在“搜索”面板中显示该文件。（指南 — 41935）

资产管理

在Assets UI中，如果选择了超过2个文件或文件夹，则在第一次尝试时不会启用移动按钮。 (GUIDES-42721)
解决方法：选择两个以上的文件或文件夹后，等待几秒钟再选择目标文件夹。

审阅

更新活动审阅任务时，如果删除了已属于审阅内容的主题，然后在不单击“更新”的情况下重新添加了主题，则“审阅者”选项卡中的审阅者信息将丢失。（指南 — 38774）
从正在进行的审核任务中删除审核中的主题时，其文档状态继续保持为在审核中，即使该主题不再是任何审核任务的一部分。 (GUIDES-38709)
解决方法：从“属性”页面或“文件属性”面板，将主题的文档状态从 正在审阅 更改为适当的状态。

编辑器2.0

将同一主题中的内容复制粘贴到编辑器中的无效位置时，会插入一个意外的外来标记。（指南 — 45378）
在<keydef>或<topicref>内的<topicmeta>中复制并粘贴<keywords>会插入意外的外来标记。（指南 — 45800）
使用上下文菜单中的复制选项从映射或主题复制内容然后粘贴时，粘贴的内容中会插入意外的额外<data>标记。（指南 — 45703）
在Windows上，复制和粘贴表格行会将不需要的属性添加到表格中，从而导致标记错误并阻止文档被保存。（指南 — 45784）
在表格或简单表格周围拖动选定内容无法按预期工作。（指南 — 45406）
从外部源粘贴图像不会将其插入主题。（指南 — 45983）
通过conref引用的MathML内容无法正确呈现。（指南 — 46601）
MathML和SVG元素的属性呈现不完整，破坏了自定义CSS类和条件属性处理。（指南 — 46371）
包装在foreign和equation-block标记中的MathML公式会引入不需要的空格并中断编辑行为。（指南 — 46606）
拖放包含键引用的元素会将keyref转换为绝对路径。（指南 — 45701）
在映射编辑器中，断开的链接上的Ctrl+click会触发应用程序错误。（指南 — 45544）

recommendation-more-help

experience-manager-guides-help-product-guide