File Manager

Editing File: /usr/share/doc/texinfo/html/_0040url-PDF-Output-Format.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for GNU Texinfo (version 6.7, 23 September 2019),
a documentation system that can produce both online information and a
printed manual from a single source using semantic markup.

Copyright (C) 1988, 1990, 1991, 1992, 1993, 1995, 1996, 1997,
1998, 1999, 2001, 2001, 2003, 2004, 2005, 2006, 2007, 2008, 2009,
2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019 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". -->

<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>@url PDF Output Format (GNU Texinfo 6.7)</title>

</head>

<body lang="en">
<span id="g_t_0040url-PDF-Output-Format"></span><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></a> &nbsp; [<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">6.10.3 <code>@url</code> PDF Output Format</h4>

<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 &lsquo;GNU&rsquo;, 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: &lsquo;GNU (<a href="http://www.gnu.org">http://www.gnu.org</a>)&rsquo;.
</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>

</body>
</html>

Back to Directory File Manager