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

Question

我有一个相当大的 asciidoc 文档，我将其动态转换为 PDF 以供我们的开发人员指南使用。由于文档通常引用我们的开发人员指南中记录的 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。链接保持事件状态且可点击。

非零值切换这些参数。

来源:
http://docbook.sourceforge.net/release/xsl/1.78.1/doc/fo/ulink.show.html