DITA-OT 3.6下org.dita.pdf2生成的xref移除‘on page nn’文本的方法
DITA-OT 3.6 PDF发布移除xref冗余页码文本操作方案
冗余文本来源
org.dita.pdf2插件默认针对format="dita"的内部xref节点,内置了页码引用拼接逻辑,会在链接显示文本后自动追加on page nn的冗余内容,通过轻量自定义覆盖即可实现移除,无需修改核心插件源码。
具体操作步骤
- 在DITA-OT安装目录的
plugins文件夹下创建自定义覆盖插件
- 新建插件根目录:
plugins/com.custom.pdf.overrides/ - 在根目录下创建
plugin.xml,写入基础插件注册配置:<?xml version="1.0" encoding="UTF-8"?> <plugin id="com.custom.pdf.overrides"> <feature extension="dita.conductor.transtype.check" value="pdf"/> <feature extension="dita.xsl.xslfo" file="xsl/override.xsl"/> </plugin> - 在插件根目录下新建
xsl子文件夹,在里面创建override.xsl,写入模板覆盖规则:<?xml version="1.0" encoding="UTF-8"?> <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="2.0"> <!-- 覆盖默认xref渲染逻辑:仅输出链接本身,不追加自动生成的页码文本 --> <xsl:template match="*[contains(@class,' topic/xref ')][@format='dita']"> <fo:basic-link xmlns:fo="http://www.w3.org/1999/XSL/Format" internal-destination="{generate-id(.)}"> <xsl:apply-templates/> </fo:basic-link> </xsl:template> </xsl:stylesheet>
- 在DITA-OT安装目录的
- 激活自定义插件
进入DITA-OT安装目录,运行插件安装命令:bin/dita --install
- 激活自定义插件
- 验证发布效果
沿用原有pdf转换类型执行发布任务,生成的PDF中,对应format="dita"的xref将不再附带自动生成的on page nn文本,原有的跳转定位功能不受影响。
- 验证发布效果
注意事项
- 该方案通过外部自定义插件实现规则覆盖,不改动org.dita.pdf2插件的原始文件,后续升级DITA-OT版本时无需重新适配补丁,仅需保留自定义插件目录即可
- 若后续需要对部分特定xref保留页码提示,可在override.xsl的节点匹配规则中增加属性判断条件,例如补充
[@outputclass!='hide-page']的匹配限制,实现按元素属性的差异化控制
内容的提问来源于stack exchange,提问作者n3v3r8g81n
相关产品推荐
相关产品推荐

