基于页码二次处理XSL-FO添加脚注：Apache Fop技术问询

问题1：Apache Fop是否支持此类基于页码添加脚注的二次处理？ #

Apache FOP本身不支持直接对已生成的XSL-FO文件做基于页码的二次脚注插入操作。FOP的核心是把完整的XSL-FO文档一次性渲染成PDF，没有内置后处理机制去识别页码并对应插入脚注。你需要先通过XSLT把XSL-FO里的^1这类标记替换成FOP支持的<fo:footnote>标准结构，再交给FOP渲染。

问题2：如何编写二次处理的XSLT，确保原PDF样式不变仅添加脚注？ #

核心思路是完整保留原XSL-FO的结构和样式，只针对带^数字标记的文本节点做替换，将标记转换为FOP兼容的脚注元素。具体实现参考以下代码：

首先是身份转换模板，用于原样复制所有未匹配的节点和属性：

<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:fo="http://www.w3.org/1999/XSL/Format">
  <!-- 身份转换：原样复制所有节点 -->
  <xsl:template match="@*|node()">
    <xsl:copy>
      <xsl:apply-templates select="@*|node()"/>
    </xsl:copy>
  </xsl:template>

  <!-- 处理包含^数字标记的文本节点 -->
  <xsl:template match="text()[contains(., '^')]">
    <xsl:analyze-string select="." regex="^(\d+)">
      <!-- 匹配到^1这类标记时的处理 -->
      <xsl:matching-substring>
        <xsl:variable name="noteNum" select="substring(., 2)"/>
        <!-- 从脚注数据中获取对应内容（假设脚注节点在当前文档的/footnotes路径下） -->
        <xsl:variable name="noteContent" select="/footnotes/footnote[@num=$noteNum]/text()"/>
        
        <!-- 生成FOP标准脚注结构 -->
        <fo:footnote>
          <fo:inline font-size="80%" vertical-align="super">
            <xsl:value-of select="$noteNum"/>
          </fo:inline>
          <fo:footnote-body>
            <fo:block font-size="80%" margin-left="1em" text-indent="-1em">
              <xsl:value-of select="$noteNum"/>. <xsl:value-of select="$noteContent"/>
            </fo:block>
          </fo:footnote-body>
        </fo:footnote>
      </xsl:matching-substring>
      <!-- 未匹配到标记的文本原样输出 -->
      <xsl:non-matching-substring>
        <xsl:value-of select="."/>
      </xsl:non-matching-substring>
    </xsl:analyze-string>
  </xsl:template>
</xsl:stylesheet>

这个XSLT只会修改带标记的文本部分，原有的FO样式（字体、行距、布局等）都会完整保留，渲染后的脚注会自动出现在标记所在页面的底部，符合PDF脚注规范。

问题3：二次转换时，如何传入包含脚注数据的XML？ #

有三种常用实现方式：

• 合并文档：把包含<footnotes>节点的脚注XML直接插入到原XSL-FO文档的根节点下，XSLT可直接从同一输入文档读取脚注数据。
• 加载外部文件：在XSLT中用document()函数加载独立的脚注XML文件，示例：

  <xsl:variable name="footnoteData" select="document('path/to/your/footnotes.xml')"/>
  <!-- 后续获取内容用：$footnoteData/footnotes/footnote[@num=$noteNum]/text() -->
  

  注意确保XSLT处理器能访问该文件，路径可用绝对或相对路径。
• 参数传递：如果通过代码（如Java）调用XSLT，可将脚注XML作为参数传入。Java代码片段示例：

  TransformerFactory factory = TransformerFactory.newInstance();
  Transformer transformer = factory.newTransformer(new StreamSource("your-transform.xsl"));
  Document footnoteDoc = ...; // 解析脚注XML得到的DOM对象
  transformer.setParameter("footnotes", footnoteDoc);
  

  然后在XSLT中定义参数接收：

  <xsl:param name="footnotes"/>
  <!-- 使用时：$footnotes/footnotes/footnote[@num=$noteNum]/text() -->
  

内容的提问来源于stack exchange，提问作者stackMan10