<!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". -->
<!-- Created by GNU Texinfo 6.7, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>@url Examples (GNU Texinfo 6.7)</title>
<meta name="description" content="@url Examples (GNU Texinfo 6.7)">
<meta name="keywords" content="@url Examples (GNU Texinfo 6.7)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="texi2any">
<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="URL-Line-Breaking.html" rel="next" title="URL Line Breaking">
<link href="_0040url.html" rel="prev" title="@url">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {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}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en">
<span id="g_t_0040url-Examples"></span><div class="header">
<p>
Next: <a href="URL-Line-Breaking.html" accesskey="n" rel="next">URL Line Breaking</a>, Up: <a href="_0040url.html" accesskey="u" rel="up"><code>@url</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-Examples-1"></span><h4 class="subsection">6.10.1 <code>@url</code> Examples</h4>
<span id="index-_0040url_002c-examples-of-using"></span>
<span id="index-URL_002c-examples-of-displaying"></span>
<p>First, here is an example of the simplest form of <code>@url</code>, with
just one argument. The given url is both the target and the visible
text of the link:
</p>
<div class="example">
<pre class="example">The official GNU ftp site is @url{http://ftp.gnu.org/gnu}.
</pre></div>
<p>produces:
</p><div class="display">
<pre class="display">The official GNU ftp site is <a href="http://ftp.gnu.org/gnu">http://ftp.gnu.org/gnu</a>.
</pre></div>
<span id="Two_002dargument-form-of-_0040url"></span><h4 class="subsubheading">Two-argument form of <code>@url</code></h4>
<p>Here is an example of the two-argument form:
</p><div class="example">
<pre class="example">The official @url{http://ftp.gnu.org/gnu, GNU ftp site}
holds programs and texts.
</pre></div>
<p>which produces:
</p><div class="display">
<pre class="display">The official <a href="http://ftp.gnu.org/gnu">GNU ftp site</a>
holds programs and texts.
</pre></div>
<p>that is, the Info (and TeX, etc.) output is this:
</p><div class="example">
<pre class="example">The official GNU ftp site (http://ftp.gnu.org/gnu)
holds programs and texts.
</pre></div>
<p>while the HTML output is this:
</p><div class="example">
<pre class="example">The official <a href="http://ftp.gnu.org/gnu">GNU ftp site</a>
holds programs and texts.
</pre></div>
<span id="Three_002dargument-form-of-_0040url"></span><h4 class="subsubheading">Three-argument form of <code>@url</code></h4>
<p>Finally, an example of the three-argument form:
</p><div class="example">
<pre class="example">The @url{/man.cgi/1/ls,,ls} program …
</pre></div>
<p>which, except for HTML, produces:
</p><div class="display">
<pre class="display">The <a href="/man.cgi/1/ls">ls</a> program …
</pre></div>
<p>but with HTML:
</p><div class="example">
<pre class="example">The <a href="/man.cgi/1/ls">ls</a> program …
</pre></div>
<p>By the way, some people prefer to display urls in the unambiguous
format:
</p>
<div class="display">
<pre class="display"><URL:http://<var>host</var>/<var>path</var>>
</pre></div>
<p><span id="index-_003cURL_002e_002e_002e_003e-convention_002c-not-used"></span>
You can use this form in the input file if you wish. We feel it’s not
necessary to include the ‘<samp><URL:</samp>’ and ‘<samp>></samp>’ in the output,
since to be useful any software that tries to detect urls in text
already has to detect them without the ‘<samp><URL:</samp>’.
</p>
</body>
</html>