JezK
Edit File: _0040url.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 (GNU Texinfo 6.8)</title> <meta name="description" content="@url (GNU Texinfo 6.8)"> <meta name="keywords" content="@url (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="Cross-References.html" rel="up" title="Cross References"> <link href="_0040cite.html" rel="next" title="@cite"> <link href="_0040inforef.html" rel="prev" title="@inforef"> <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="section" id="g_t_0040url"> <div class="header"> <p> Next: <a href="_0040cite.html" accesskey="n" rel="next"><code>@cite</code>{<var>reference</var>}</a>, Previous: <a href="_0040inforef.html" accesskey="p" rel="prev"><code>@inforef</code>: Cross-references to Info-only Material</a>, Up: <a href="Cross-References.html" accesskey="u" rel="up">Cross-references</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_002c-_0040uref_007burl_005b_002c-text_005d_005b_002c-replacement_005d_007d"></span><h3 class="section">5.10 <code>@url</code>, <code>@uref{<var>url</var>[, <var>text</var>][, <var>replacement</var>]}</code></h3> <span id="uref"></span><span id="url"></span><span id="index-URL"></span> <span id="index-url"></span> <span id="index-href_002c-producing-HTML"></span> <p><code>@url</code> produces a reference to a uniform resource locator (url). It takes one mandatory argument, the url, and two optional arguments which control the text that is displayed. In HTML and PDF output, <code>@url</code> produces a link you can follow. (To merely indicate a url without creating a link people can follow, use <code>@indicateurl</code>, see <a href="_0040indicateurl.html"><code>@indicateurl</code>{<var>uniform-resource-locator</var>}</a>.) </p> <span id="index-uref"></span> <p><code>@uref</code> is a synonym for <code>@url</code>. (Originally, <code>@url</code> had the meaning of <code>@indicateurl</code> and <code>@uref</code> was required to produce a working link, but in practice <code>@url</code> was almost always misused. So we’ve changed the meaning.) </p> <p>The second argument, if specified, is the text to display (the default is the url itself); in Info, DVI, and PDF output, but not in HTML output, the url is output in addition to this text. </p> <span id="index-Man-page_002c-reference-to"></span> <p>The third argument, if specified, is the text to display, but in this case the url is not output in any format. This is useful when the text is already sufficiently referential, as in a man page. Also, if the third argument is given, the second argument is ignored. </p> <ul class="section-toc"> <li><a href="_0040url-Examples.html" accesskey="1"><code>@url</code> Examples</a></li> <li><a href="URL-Line-Breaking.html" accesskey="2">URL Line Breaking</a></li> <li><a href="_0040url-PDF-Output-Format.html" accesskey="3"><code>@url</code> PDF Output Format</a></li> <li><a href="PDF-Colors.html" accesskey="4">PDF Colors</a></li> </ul> </div> </body> </html>