JezK
Edit File: _0040url-PDF-Output-Format.html
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <!-- Created by GNU Texinfo 6.8, https://www.gnu.org/software/texinfo/ --> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <!-- This manual is for GNU Texinfo (version 6.8, 8 June 2021), a documentation system that can produce both online information and a printed manual from a single source using semantic markup. Copyright (C) 1988, 1990-1993, 1995-1999, 2001-2021 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License". --> <title>@url PDF Output Format (GNU Texinfo 6.8)</title> <meta name="description" content="@url PDF Output Format (GNU Texinfo 6.8)"> <meta name="keywords" content="@url PDF Output Format (GNU Texinfo 6.8)"> <meta name="resource-type" content="document"> <meta name="distribution" content="global"> <meta name="Generator" content="texi2any"> <meta name="viewport" content="width=device-width,initial-scale=1"> <link href="index.html" rel="start" title="Top"> <link href="Command-and-Variable-Index.html" rel="index" title="Command and Variable Index"> <link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> <link href="_0040url.html" rel="up" title="@url"> <link href="PDF-Colors.html" rel="next" title="PDF Colors"> <link href="URL-Line-Breaking.html" rel="prev" title="URL Line Breaking"> <style type="text/css"> <!-- a.copiable-anchor {visibility: hidden; text-decoration: none; line-height: 0em} a.summary-letter {text-decoration: none} blockquote.indentedblock {margin-right: 0em} div.display {margin-left: 3.2em} div.example {margin-left: 3.2em} kbd {font-style: oblique} pre.display {font-family: inherit} pre.format {font-family: inherit} pre.menu-comment {font-family: serif} pre.menu-preformatted {font-family: serif} span.nolinebreak {white-space: nowrap} span.roman {font-family: initial; font-weight: normal} span.sansserif {font-family: sans-serif; font-weight: normal} span:hover a.copiable-anchor {visibility: visible} ul.no-bullet {list-style: none} --> </style> </head> <body lang="en"> <div class="subsection" id="g_t_0040url-PDF-Output-Format"> <div class="header"> <p> Next: <a href="PDF-Colors.html" accesskey="n" rel="next">PDF Colors</a>, Previous: <a href="URL-Line-Breaking.html" accesskey="p" rel="prev">URL Line Breaking</a>, Up: <a href="_0040url.html" accesskey="u" rel="up"><code>@url</code>, <code>@uref{<var>url</var>[, <var>text</var>][, <var>replacement</var>]}</code></a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Command-and-Variable-Index.html" title="Index" rel="index">Index</a>]</p> </div> <hr> <span id="g_t_0040url-PDF-Output-Format-1"></span><h4 class="subsection">5.10.3 <code>@url</code> PDF Output Format</h4> <span id="index-PDF-output-of-urls"></span> <span id="index-URLs_002c-PDF-output-of"></span> <p>If the ultimate purpose of a PDF is only to be viewed online, perhaps similar to HTML in some inchoate way, you may not want the urls to be included in the visible text (just as urls are not visible to readers of web pages). Texinfo provides a PDF-specific option for this, which must be used inside <code>@tex</code>: </p> <span id="index-_005curefurlonlylinktrue"></span> <div class="example"> <pre class="example">@tex \global\urefurlonlylinktrue @end tex </pre></div> <p>The result is that <code>@url{http://www.gnu.org, GNU}</code> has the visible output of just ‘GNU’, with a link target of <a href="http://www.gnu.org">http://www.gnu.org</a>. Ordinarily, the visible output would include both the label and the url: ‘GNU (<a href="http://www.gnu.org">http://www.gnu.org</a>)’. </p> <p>This option only has effect when the PDF output is produced with the pdfTeX program, not with other ways of getting from Texinfo to PDF (e.g., TeX to DVI to PDF). Consequently, it is ok to specify this option unconditionally within <code>@tex</code>, as shown above. It is ignored when DVI is being produced. </p> </div> </body> </html>