Oxygen Publishing Engine 28.0 新功能

Oxygen XML Publishing Engine 28 将全新的 Oxygen XML WebHelp 28 功能与 Oxygen PDF Chemistry 28 改进应用于自动化服务器端及 CI/CD 驱动的发布管道。

 

Oxygen XML WebHelp 28 提供现代化的阅读体验、灵活的显示模式以及全新的无障碍功能。其核心在于优化内容阅读与导航体验：支持粘性表格标题、浅色/深色/自动主题切换、全屏/全宽视图、持久化目录状态，并实施一系列细微而重要的无障碍改进。出版商还可通过有序列表起始索引、始终可见的图像地图区域，以及可选的AI友好模式（为大型语言模型生成简化文本/Markdown视图）获得更强的结构控制与下游复用能力。

 

Oxygen PDF Chemistry 28 赋予您更强的 PDF 生成与交付控制权：可压缩输出文件便于共享，在生成内容前后合并其他 PDF，并能直接从 CSS 生成独立 PDF（例如按章节或部分划分）。

 

更新内容涵盖：

• WebHelp输出
• PDF输出
• 组件更新

 

WebHelp输出

粘性表格标题

表格标题现可设置为滚动时保持可见，便于查看信息时维持上下文关联。此行为可通过新增的webhelp.enable.sticky.table.headers转换参数控制。

 

在浅色与深色主题间切换

现在可通过启用 webhelp.enable.dark.mode 参数，让用户在 WebHelp 输出中自由切换浅色与深色主题。启用后，页眉将显示“切换主题”按钮，用户可选择自动、浅色或深色模式。自动模式将界面适配浏览器主题，深色主题则在弱光环境下提供更舒适的阅读体验。

 

所有嵌入式 Oxygen Feedback 组件（如评论、页面评分、块级评论、AI 助手及 AI 增强搜索摘要）均会自动匹配当前主题，无需额外配置。

 

全屏模式

现可通过工具栏按钮“进入全屏/退出全屏”查看 WebHelp Responsive 输出内容。此功能对宽屏设备尤为实用。此行为亦可通过 webhelp.full.page.width 参数进行控制。

 

输出内容全宽扩展

WebHelp Responsive 输出现支持全宽扩展以适配大屏幕。输出区域出现的“最大化至全宽/恢复标准宽度”按钮可实现全宽与标准宽度的切换。

 

目录展开/折叠状态持久化

在WebHelp Responsive输出中浏览主题时，发布内容目录和主题目录的展开/折叠状态将保持持久化，提升内容导航效率。

 

用户可访问性改进

WebHelp输出进一步扩展了用户可访问性。具体改进包括：可通过Tab键选择永久链接并用Enter或空格键打开；屏幕阅读器现可读取搜索结果中页面的评分（5星制中的星级）；索引术语页面的字母内容现可被读取；修复了若干导航相关的可访问性问题。

 

表格单元格显示工具提示

现可启用表格单元格悬停工具提示功能，在WebHelp输出中悬停时显示对应行/列信息，提升表格可读性。通过将webhelp.display.table.cell.tooltip参数设为“yes”即可启用该功能。

 

指定有序列表起始索引

现可通过@outputclass=“start-X”属性结构设置有序列表起始索引（X为目标起始编号），为有序列表操作提供更灵活的控制。

 

始终显示图像地图高亮区域

您可通过新参数 webhelp.show.image.map.areas 设置，使图像地图中的高亮区域始终可见。此功能可简化 WebHelp Responsive输出中复杂图像地图的操作。

 

生成的文本字符串采用全新DITA-OT统一格式

构建过程中生成的文本字符串（例如元素内容前的注释标签）现采用全新DITA-OT统一格式（以为根元素），便于自定义并确保跨插件一致性。

 

AI友好型WebHelp输出

启用webhelp.enable.ai.friendly转换参数后，WebHelp Responsive输出将更便于AI和大型语言模型（LLM）访问。该参数会生成llms.txt文件及配套Markdown文件，为LLM提供简化的站点内容视图和精选资源索引。

 

PDF输出

压缩PDF输出

新增的pdf.compress参数可缩减PDF输出文件体积，便于存储与共享。

 

合并多个PDF文件

现支持合并多个PDF文件。根据需要插入的位置，可使用新增的chemistry.merge.before或chemistry.merge.after参数，提供以分号分隔的PDF网址列表，将其与当前生成的PDF合并。

 

创建演示文稿PDF

通过新增的演示文稿发布模板，现可将DITA内容生成类似MS PowerPoint的演示幻灯片风格PDF文件。每个主题独立成页，图片表格居中排版，便于以演示格式分享内容。您还可通过Oxygen样式库自定义外观。

 

指定起始索引创建序列列表

现可通过 @outputclass=“start-X” 属性结构设置序列列表起始索引（X 为目标起始编号），为序列列表操作提供更高灵活性。

 

生成的文本字符串采用全新 DITA-OT 统一格式

构建过程中生成的文本字符串（例如元素内容前的注释标签）现采用新版DITA-OT统一格式（以为根元素），既简化了自定义流程，又确保跨插件的一致性。

 

组件更新

支持DITA-OT 4.3.5

发布引擎已升级至集成DITA-OT 4.3.5版本。