| <!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 Line Breaking (GNU Texinfo 6.8dev)</title> |
| |
| <meta name="description" content="URL Line Breaking (GNU Texinfo 6.8dev)"> |
| <meta name="keywords" content="URL Line Breaking (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="_0040url-PDF-Output-Format.html" rel="next" title="@url PDF Output Format"> |
| <link href="_0040url-Examples.html" rel="prev" title="@url Examples"> |
| <style type="text/css"> |
| <!-- |
| div.example {margin-left: 3.2em} |
| span.r {font-family: initial; font-weight: normal} |
| --> |
| </style> |
| |
| |
| </head> |
| |
| <body lang="en"> |
| <div class="subsection-level-extent" id="URL-Line-Breaking"> |
| <div class="nav-panel"> |
| <p> |
| Next: <a href="_0040url-PDF-Output-Format.html" accesskey="n" rel="next"><code class="code">@url</code> PDF Output Format</a>, Previous: <a href="_0040url-Examples.html" accesskey="p" rel="prev"><code class="code">@url</code> Examples</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="URL-Line-Breaking-1">5.10.2 URL Line Breaking</h4> |
| |
| <a class="index-entry-id" id="index-Line-breaks"></a> |
| <a class="index-entry-id" id="index-Breakpoints-within-urls"></a> |
| <p>TeX allows line breaking within urls at only a few characters |
| (which are special in urls): ‘<samp class="samp">&</samp>’, ‘<samp class="samp">.</samp>’, ‘<samp class="samp">#</samp>’, ‘<samp class="samp">?</samp>’, |
| and ‘<samp class="samp">/</samp>’ (but not between two ‘<samp class="samp">/</samp>’ characters). A tiny amount |
| of stretchable space is also inserted around these characters to help |
| with line breaking. |
| </p> |
| <p>For HTML output, modern browsers will also do line breaking within |
| displayed urls. If you need to allow breaks at other characters you |
| can insert <code class="code">@/</code> as needed (see <a class="pxref" href="Line-Breaks.html"><code class="code">@*</code> and <code class="code">@/</code>: Generate and Allow Line Breaks</a>). |
| </p> |
| <a class="index-entry-id" id="index-urefbreakstyle"></a> |
| <p>By default, in TeX any such breaks at special characters will occur |
| after the character. Some people prefer such breaks to happen before |
| the special character. This can be controlled with the |
| <code class="code">@urefbreakstyle</code> command (this command has effect only in |
| TeX): |
| </p> |
| <div class="example"> |
| <pre class="example-preformatted">@urefbreakstyle <var class="var">how</var> |
| </pre></div> |
| |
| <p>where the argument <var class="var">how</var> is one of these words: |
| </p> |
| <a class="index-entry-id" id="index-after_002c-value-for-_0040urefbreakstyle"></a> |
| <a class="index-entry-id" id="index-before_002c-value-for-_0040urefbreakstyle"></a> |
| <a class="index-entry-id" id="index-none_002c-value-for-_0040urefbreakstyle"></a> |
| <dl class="table"> |
| <dt>‘<samp class="samp">after</samp>’</dt> |
| <dd><p>(the default) Potentially break after the special characters. |
| </p></dd> |
| <dt>‘<samp class="samp">before</samp>’</dt> |
| <dd><p>Potentially break before the special characters. |
| </p></dd> |
| <dt>‘<samp class="samp">none</samp>’</dt> |
| <dd><p>Do not consider breaking at the special characters at all; any potential |
| breaks must be manually inserted. |
| </p></dd> |
| </dl> |
| |
| |
| </div> |
| |
| |
| |
| </body> |
| </html> |
