| <!DOCTYPE html> |
| <html> |
| <!-- Created by Texinfo 6.8dev+dev, http://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.8dev, 23 February 2022), |
| 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-2022 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 Examples (GNU Texinfo 6.8dev)</title> |
| |
| <meta name="description" content="@url Examples (GNU Texinfo 6.8dev)"> |
| <meta name="keywords" content="@url Examples (GNU Texinfo 6.8dev)"> |
| <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="URL-Line-Breaking.html" rel="next" title="URL Line Breaking"> |
| <style type="text/css"> |
| <!-- |
| div.display {margin-left: 3.2em} |
| div.example {margin-left: 3.2em} |
| pre.display-preformatted {font-family: inherit} |
| --> |
| </style> |
| |
| |
| </head> |
| |
| <body lang="en"> |
| <div class="subsection-level-extent" id="g_t_0040url-Examples"> |
| <div class="nav-panel"> |
| <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 class="code">@url</code>, <code class="code">@uref{<var class="var">url</var>[, <var class="var">text</var>][, <var class="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> |
| <h4 class="subsection" id="g_t_0040url-Examples-1">5.10.1 <code class="code">@url</code> Examples</h4> |
| |
| <a class="index-entry-id" id="index-_0040url_002c-examples-of-using"></a> |
| <a class="index-entry-id" id="index-URL-1"></a> |
| |
| <p>First, here is an example of the simplest form of <code class="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-preformatted">The official GNU ftp site is @url{http://ftp.gnu.org/gnu}. |
| </pre></div> |
| |
| <p>produces: |
| </p><div class="display"> |
| <pre class="display-preformatted">The official GNU ftp site is <a class="url" href="http://ftp.gnu.org/gnu">http://ftp.gnu.org/gnu</a>. |
| </pre></div> |
| |
| <h4 class="subsubheading" id="Two_002dargument-form-of-_0040url">Two-argument form of <code class="code">@url</code></h4> |
| |
| <p>Here is an example of the two-argument form: |
| </p><div class="example"> |
| <pre class="example-preformatted">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-preformatted">The official <a class="url" 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-preformatted">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-preformatted">The official <a href="http://ftp.gnu.org/gnu">GNU ftp site</a> |
| holds programs and texts. |
| </pre></div> |
| |
| <h4 class="subsubheading" id="Three_002dargument-form-of-_0040url">Three-argument form of <code class="code">@url</code></h4> |
| |
| <p>Finally, an example of the three-argument form: |
| </p><div class="example"> |
| <pre class="example-preformatted">The @url{/man.cgi/1/ls,,ls} program … |
| </pre></div> |
| |
| <p>which, except for HTML, produces: |
| </p><div class="display"> |
| <pre class="display-preformatted">The <a class="url" href="/man.cgi/1/ls">ls</a> program … |
| </pre></div> |
| |
| <p>but with HTML: |
| </p><div class="example"> |
| <pre class="example-preformatted">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-preformatted"><URL:http://<var class="var">host</var>/<var class="var">path</var>> |
| </pre></div> |
| |
| <p><a class="index-entry-id" id="index-_003cURL_002e_002e_002e_003e-convention_002c-not-used"></a> |
| You can use this form in the input file if you wish. We feel it’s not |
| necessary to include the ‘<samp class="samp"><URL:</samp>’ and ‘<samp class="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 class="samp"><URL:</samp>’. |
| </p> |
| |
| </div> |
| <hr> |
| <div class="nav-panel"> |
| <p> |
| Next: <a href="URL-Line-Breaking.html">URL Line Breaking</a>, Up: <a href="_0040url.html"><code class="code">@url</code>, <code class="code">@uref{<var class="var">url</var>[, <var class="var">text</var>][, <var class="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> |
| |
| |
| |
| </body> |
| </html> |
