You need to enable JavaScript to run this app. DITA-OT 3.6下org.dita.pdf2生成的xref移除‘on page nn’文本的方法
优惠活动
大模型
产品
解决方案
定价
更多

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的冗余内容,通过轻量自定义覆盖即可实现移除,无需修改核心插件源码。

具体操作步骤

    1. 在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>
      
    1. 激活自定义插件
      进入DITA-OT安装目录,运行插件安装命令:bin/dita --install
    1. 验证发布效果
      沿用原有pdf转换类型执行发布任务,生成的PDF中,对应format="dita"的xref将不再附带自动生成的on page nn文本,原有的跳转定位功能不受影响。

注意事项

  • 该方案通过外部自定义插件实现规则覆盖,不改动org.dita.pdf2插件的原始文件,后续升级DITA-OT版本时无需重新适配补丁,仅需保留自定义插件目录即可
  • 若后续需要对部分特定xref保留页码提示,可在override.xsl的节点匹配规则中增加属性判断条件,例如补充[@outputclass!='hide-page']的匹配限制,实现按元素属性的差异化控制

内容的提问来源于stack exchange,提问作者n3v3r8g81n

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.30 03:45:07