It seems Sphinx lets us insert two distinct kinds of links: `link`_ puts the link inline, while [link]_ points you to a footnote for the link (reST calls this a citation), and we&#39;re using something of a mixture of the two. In principle, reST should format `link`_ according to the output, so when we generate a PDF, it should appear as a footnote (the &#39;call-out form&#39;). It seems Sphinx doesn&#39;t take advantage of this and leaves `link`_ inline for the PDF output.<br>

<br>I suggest that we use `link`_ formatting consistently, and enable the sphinx options <tt class="descname">latex_show_urls </tt>and<tt class="descname"> </tt><tt class="descname">latex_show_pagerefs</tt>. This will mean links are a single click in our HTML output, and internal &amp; external links can be read in the printed PDF output (The URL or page reference appears in brackets after the link).<br>

<br>Thomas<br>