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输出
粘性表格标题
表格标题现可设置为滚动时保持可见,便于查看信息时维持上下文关联。此行为可通过新增的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版本。