如何在asciidoc fop中合并甚至禁用脚注链接

Question

我有一个相当大的asciidoc文档,我为我们的开发人员指南动态翻译为PDF.由于doc通常引用我们的开发人员指南中记录的Java类,因此我们将它们直接转换为文档中的链接,例如:

In this block we create a new 
https://www.codenameone.com/javadoc/com/codename1/ui/Form.html[Form] 
named `hi`.

这在大多数情况下工作得相当好,并且在HTML中看起来很棒,因为对类的每个引用都直接导致其JavaDoc使得引用/引导过程更加简单.

但是,当我们生成PDF时,我们最终会在某些页面上显示这样的内容:

通常情况下,我不会介意前一页中的大量脚注甚至重复.但是,在这种情况下,Container的链接出现3次.

我可以删除一些链接,但我不愿意,因为它们在网络版本上有很多意义.因为我也不知道分页会落在哪里,所以我宁愿不自己做.

这看起来像某个地方的错误,如果链接相同,链接的脚注应该只生成一次.

我可以删除文档中的所有链接脚注,如果这是要支付的价格,虽然我宁愿能够根据具体情况这样做,所以一些链接仍然可以打印

Answer 1

在 fo-pdf.xsl 中添加这两个参数删除脚注：

<xsl:param name="ulink.footnotes" select="0"></xsl:param>
<xsl:param name="ulink.show" select="0"></xsl:param>

第一个参数禁用脚注，这会触发 url 重新内联显示。
第二个参数从文本中删除 url。链接保持活动状态且可点击。

非零值切换这些参数。