Antenna House Formatter 如何处理引用的脚注？

Posted 2023-02-16

【中文标题】Antenna House Formatter 如何处理引用的脚注？

【英文标题】：How can Antennahouse Formatter handle referenced footnotes?

【发布时间】：2017-05-04 04:35:51

【问题描述】：

我正在使用 xsl-fo（Saxon XSL 2.0，AHF V6.2）开发 pdf 印刷出版物。

我的目标是使用来自引用的静态文本元素的插入文本的自动编号脚注（不包括单个页面上的重复项）。

所以基本上内联脚注 (fn) 确实引用了一个静态脚注文本元素，创建一个内联编号并在页面底部打印相应的脚注文本。

<?xml version="1.0" encoding="UTF-8"?>
<document>
<chapter>
    <paragraph>some description...</paragraph>
    <paragraph>some description with a footnote <fn id="fn2"/></paragraph>
    <paragraph>some description with a footnote <fn id="fn2"/></paragraph>
    <paragraph>some description...</paragraph>
    <paragraph>some description with a footnote <fn id="fn1"/></paragraph>
</chapter>
<!-- this is a wrapper element that will not be displayed in the rendered pdf but only contains the needed information for different footnote texts -->
<chapter class="footnoteWrapper">
    <footnote id="fn1">
        This is the text body of footnote #1.
    </footnote>
    <footnote id="fn2">
        This is the text body of footnote #2.
    </footnote>
    <footnote id="fn3">
        This is the text body of footnote #3.
    </footnote>
</chapter>
</document>

章节中重复的内联脚注必须根据它们所指向的脚注显示相同的编号。

结果应该是这样的......

是否可以通过 AHF 脚注扩展和 fo:footnote 元素来实现这些目标？

如果我将 AntennaHouse Formatter 扩展用于 fn 计数，它们确实会产生奇怪的行为。他们确实会继续计数 (1, 2, 3)，而不是引用所引用脚注的正确和当前编号。

这是迄今为止的 XSL（只是相关的 sn-p）：

<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
    xmlns:xs="http://www.w3.org/2001/XMLSchema"
    exclude-result-prefixes="xs"
    version="2.0">

<xsl:template match="fn[@id = //footnote/@nodeid]"
    mode="content"
    priority="7">
    <!--+ fn link
        |
        | basic fn (inline) link template.
        |
        +-->
    <xsl:apply-templates select="//footnote[@id = current()/@id]"
        mode="content"/>
</xsl:template>

<xsl:template match="footnote"
    mode="content"
    priority="5">
    <!--+ footnote
        |
        | basic footnote template.
        |
        +-->
    <fo:footnote xsl:use-attribute-sets="fnt.footnote">
        <fo:inline baseline-shift="super">
            <axf:footnote-number id="fn_@id"/>
        </fo:inline>
        <fo:footnote-body space-after="1mm">
            <fo:list-block provisional-distance-between-starts="5mm"
                provisional-label-separation="2mm">
                <fo:list-item>
                    <fo:list-item-label end-indent="label-end()">
                        <fo:block>
                            <fo:inline baseline-shift="super">
                                <axf:footnote-number-citation ref-id="fn_@id"/>
                            </fo:inline>
                        </fo:block>
                    </fo:list-item-label>
                    <fo:list-item-body start-indent="body-start()">
                        <fo:block>
                            <xsl:apply-templates mode="content"/>
                        </fo:block>
                    </fo:list-item-body>
                </fo:list-item>
            </fo:list-block>
        </fo:footnote-body>
    </fo:footnote>
</xsl:template>
</xsl:stylesheet>

【问题讨论】：

您能向我们展示您目前拥有的相关 XSLT 吗？

【参考方案1】：

这些更改会在第一次使用脚注时生成脚注，并且只会为后续时间生成数字：

<xsl:key name="fn" match="fn[exists(key('footnote', @id))]" use="@id" />
<xsl:key name="fn-first" match="fn[. is key('fn', @id)[1]]" use="@id" />
<xsl:key name="footnote" match="footnote" use="@id" />

<xsl:template match="fn[exists(key('footnote', @id))][. is key('fn-first', @id)]"
    mode="content"
    priority="7">
    <xsl:apply-templates select="key('footnote', @id)"
        mode="content">
        <xsl:with-param name="number" select="count(preceding::fn[. is key('fn-first', @id)]) + 1"></xsl:with-param>
    </xsl:apply-templates>
</xsl:template>

<xsl:template match="fn[exists(key('footnote', @id))][not(. is key('fn-first', @id))]"
    mode="content"
    priority="7">
    <fo:inline baseline-shift="super">
        <xsl:value-of select="count(key('fn-first', @id)/preceding::fn[. is key('fn-first', @id)]) + 1"/>
    </fo:inline>
</xsl:template>

<xsl:template match="footnote" mode="content" priority="5">
    <xsl:param name="number" select="count(preceding-sibling::footnote) + 1" as="xs:integer" />
    <fo:footnote xsl:use-attribute-sets="fnt.footnote">
        <fo:inline baseline-shift="super">
            <xsl:value-of select="$number" />
        </fo:inline>
        <fo:footnote-body space-after="1mm">
            <fo:list-block provisional-distance-between-starts="5mm"
                provisional-label-separation="2mm">
                <fo:list-item>
                    <fo:list-item-label end-indent="label-end()">
                        <fo:block>
                            <fo:inline baseline-shift="super">
                                <xsl:value-of select="$number" />
                            </fo:inline>
                        </fo:block>
                    </fo:list-item-label>
                    <fo:list-item-body start-indent="body-start()">
                        <fo:block>
                            <xsl:apply-templates mode="content" />
                        </fo:block>
                    </fo:list-item-body>
                </fo:list-item>
            </fo:list-block>
        </fo:footnote-body>
    </fo:footnote>
</xsl:template>

您可以通过例如创建一个返回 count() 值的函数来对 fn 进行更多整理，但这应该可以让您继续前进。

请参阅我的其他答案，了解如何同时使用 axf:suppress-duplicate-footnote 和 axf:footnote-number，以便仅当重复项位于同一页面上时才会抑制重复项。

【参考方案2】：

重复的脚注也有重复的 ID。来自非唯一 ID 的错误妨碍了 axf:suppress-duplicate-footnote 处理。

如果您不创建指向脚注的链接，请根据引用它的 fn 为每个脚注生成一个唯一 ID：

<xsl:template match="fn[exists(key('footnote', @id))]" mode="content" priority="7">
    <!--+ fn link
    |
    | basic fn (inline) link template.
    |
    +-->
    <xsl:apply-templates select="key('footnote', @id)" mode="content">
        <xsl:with-param name="id" select="generate-id()" />
    </xsl:apply-templates>
</xsl:template>

<xsl:template match="footnote" mode="content" priority="5">
    <xsl:param name="id" />
    <!--+ footnote
    |
    | basic footnote template.
    |
    +-->
    <fo:footnote xsl:use-attribute-sets="fnt.footnote" axf:suppress-duplicate-footnote="true">
        <fo:inline baseline-shift="super">
            <axf:footnote-number id="$id" />
        </fo:inline>
        <fo:footnote-body space-after="1mm">
            <fo:list-block provisional-distance-between-starts="5mm"
                provisional-label-separation="2mm">
                <fo:list-item>
                    <fo:list-item-label end-indent="label-end()">
                        <fo:block>
                            <fo:inline baseline-shift="super">
                                <axf:footnote-number-citation ref-id="$id" />
                            </fo:inline>
                        </fo:block>
                    </fo:list-item-label>
                    <fo:list-item-body start-indent="body-start()">
                        <fo:block>
                            <xsl:apply-templates mode="content" />
                        </fo:block>
                    </fo:list-item-body>
                </fo:list-item>
            </fo:list-block>
        </fo:footnote-body>
    </fo:footnote>
</xsl:template>