文档AEM GuidesAEM Guides 文档

使用本机PDF引擎v2

最近更新： 2026年6月17日

创建对象：

  • {"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"}

新发布引擎​ 原生PDF引擎v2 ​基于升级的PDF生成框架，并包括对字体处理、CSS处理和渲染行为的更改。

因此，使用新发布引擎生成的PDF输出可能与使用现有PDF引擎生成的输出不同（原生PDF引擎v1）。 在文本布局、间距、样式、图像渲染和脚注格式等区域中，差异可能可见。

例如，本机PDF引擎v2支持OpenType字体，而本机PDF引擎v1主要依赖于TrueType字体。 类似的渲染增强功能可能会影响生成的PDF的整体外观。

有关如何在您的环境中启用本机PDF引擎v2的详细信息，请查看为本机PDF配置新发布引擎。

建议新发布引擎使用的CSS更新

如果要在使用本机PDF引擎v2时恢复本机PDF引擎v1生成的PDF输出的外观，您可能需要更新自定义CSS。 下面介绍的建议CSS更改有助于在启用新设置后维护输出一致性。

描述
建议的CSS更新
缩放的图像可能会因图像渲染行为的更改而显示不同。
要恢复图像渲染行为，请添加：

image-rendering: pixelated
目录引线(TOC)对齐方式可能会因引线渲染行为的更改而略有不同。
要恢复目录引线对齐，请调整自定义样式表中目录引线元素的样式。 所需的CSS更改可能会因您的目录布局和格式而异。
由于字体渲染和字形布局处理中的更改，文本间距和换行可能会有所不同。
如果您的样式表使用sans-serif字体系列或显示间距差异的字体，请添加：

-ro-glyph-layout-mode: quality;
由于默认脚注样式发生了更改，脚注引用可能不再显示为上标标记。
要恢复上标样式的脚注标记，请添加：

.fn::footnote-marker
{ content: counter(footnote) " ";
vertical-align: super;
font-size: 65%;}
由于下划线位置的更改，文本与下划线之间的间距可能会增加，因此下划线文本可能会出现。
要恢复下划线位置，请使用text-underline-offset属性并根据需要调整偏移值。 例如：

text-decoration: underline;
text-underline-offset: -0.1em;
列表标记和列表项文本之间的间距可能会因列表渲染行为的更改而有所不同。
要恢复间距，请增加列表项的左边距。 例如：

.step {
margin-top: 0.3rem;
margin-bottom: 0.5rem;
padding-left: calc(1.5rem + 1ch);}
由于边距折叠行为的变化，标题前的间距可能会有所不同。
要恢复间距，请检查相邻元素的边距，并根据需要减少或移除重叠的顶边距和底边距。 例如：

h1.chapter {
margin-top: 0;
}
chaptoc-body { margin-bottom: 0;
}
通过CSS生成的复选标记可能以不同的大小或样式显示，因为它们使用不同的回退字体渲染。
要以一致的方式呈现标记，请使用包含两个字形的字体系列。 例如：

::marker {
font-family: -ro-symbols !important;}
由于标记的位置行为发生更改，CSS生成的圆形列表标记可能会出现部分剪切或截断。
要恢复圆形列表标记的外观，请避免使用标记的绝对定位。 如果需要绝对定位，请明确指定适当的top值以正确定位标记。
当列表项使用position: relative等定位样式时，PDF/UA输出中列表项的读取顺序可能会有所不同。
若要使阅读顺序更遵循源文档结构，请将以下CSS属性应用于列表项：

li {
-ro-paint-reordering: avoid;}

已知问题的解决方法

使用本机PDF引擎v2时，以下解决方法可以帮助解决生成的PDF输出中的已知问题。

  • 应用于表内容的text-decoration css属性未在PDF输出中渲染。

    解决方法：将文本修饰属性应用于表内容中的span元素，而不是将其直接应用于表元素。

  • -ro-colorbar-top-left和-ro-colorbar-top-right CSS属性不会影响PDF输出中的颜色栏。

    解决方法：从mergedHTML.json中的用户样式表中删除相应的值，或者将!important添加到文档CSS中的属性值，以便这些值不会被用户样式表覆盖。

  • 当页面宽度受限时，色条可能会显示为合并，因为色条不会随PDF输出中的页面大小而缩小。

    解决方法：在页面的不同侧面显示灰色和彩色条，或者调整颜色条设置，以使它们在较小的页面宽度上不重叠。

修复了新发布引擎的问题

使用​ 本机PDF引擎v1 ​生成的PDF输出中的以下问题已在​ 本机PDF引擎v2 ​中修复：

  • 在为某些内容生成本机PDF输出时，尽管中间HTML包含多个页面中的完整内容，但PDF中仅呈现第一页。 （指南 — 28270）
  • 启用了辅助功能设置的本机PDF输出中的内容读取顺序不正确。 页脚中的页码在主内容之前而不是结尾处读取。 （指南 — 27790）
  • 当自定义页面大小时，原生PDF输出中的颜色条不会拉伸整个页面宽度，并且会重叠，从而导致隐藏某些颜色框。 （指南 — 15505）
  • 本机PDF输出中不允许CSS:is()pseudo-class选择器，从而导致样式与浏览器呈现样式不同。 （指南 — 11328）
recommendation-more-help
experience-manager-guides-help-product-guide