alan-if / alan-docs

Alan IF Documentation Project

Home Page:https://git.io/alan-docs

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Remove URL Footnotes from Links

tajmone opened this issue · comments

  • Disable links URL-footnotes in upstream XSL template (alan-xsl-fopub).

In the PDF backend, whenever there's an inline link, the final PDF doc will also add a footnote with the full URL. Although this was originally intended for printed books, where links are not actively clickable, in the PDF document it looks hugly (especially in "useful links" sections) and it's useless, since inline links are clickable in the PDF doc.

For a discussion on this, and how to fix it, see:

where @seinecle offers the following solution:

Adding these two parameters in fo-pdf.xsl remove footnotes:

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

The first parameter disable footnotes, which triggers urls to re-appear inline.
The second parameter removes urls from the text. Links remain active and clickable.

Non-zero values toggle these parameters.

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

Differences Preview

Below you'll find a link to the PDF Alan Manual before and after the XSL template fix for the links footnotes:

And here are some page numbers for comparing the differences:

  • p.2 (laster par. Ch1 Intro) — before there were two footnotes with the URL https://www.alanif.se/.
  • p.169 (first page of App. A) — before, 4 URLs of external links were present as footnotes.