diff options
Diffstat (limited to 'Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-setURL.html')
-rw-r--r-- | Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-setURL.html | 79 |
1 files changed, 0 insertions, 79 deletions
diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-setURL.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-setURL.html deleted file mode 100644 index e7a26b6939a..00000000000 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-setURL.html +++ /dev/null @@ -1,79 +0,0 @@ -<head> -<title>UK TeX FAQ -- question label setURL</title> -</head><body> -<h3>Typesetting URLs</h3> -<p/>URLs tend to be very long, and contain characters that would -naturally prevent them being hyphenated even if they weren’t typically -set in <code>\</code><code>ttfamily</code>, verbatim. Therefore, without special treatment, -they often produce wildly overfull <code>\</code><code>hbox</code>es, and their typeset -representation is awful. -<p/>There are three packages that help solve this problem: -<ul> -<li> The <i>path</i> package, which defines a <code>\</code><code>path</code> command. - The command defines each potential break character as a - <code>\</code><code>discretionary</code>, and offers the user the opportunity of - specifying a personal list of potential break characters. Its chief - disadvantage is fragility in LaTeX moving arguments. The - - <a href="FAQ-eplain.html">Eplain macros</a> — define a similar <code>\</code><code>path</code> command. -<p/> <i>Path</i>, though it works in simple situations, makes no - attempt to work with LaTeX (it is irremediably fragile). Despite - its long and honourable history, it is no longer recommended for - LaTeX use. -<li> The <i>url</i> package, which defines an <code>\</code><code>url</code> command - (among others, including its own <code>\</code><code>path</code> command). The command - gives each potential break character a maths-mode ‘personality’, and - then sets the URL itself (in the user’s choice of font) in - maths mode. It can produce (LaTeX-style) ‘robust’ commands - - (see <a href="FAQ-protect.html">use of <code>\</code><code>protect</code></a>) for use - within moving arguments. -<p/> The package ordinarily ignores spaces in the URL, but - unfortunately URLs that contain spaces do exist; to typeset - them, call the package with the <code>obeyspaces</code> option. Two - other useful options allow line breaks in the URL in places - where they are ordinarily suppressed to avoid confusion: - <code>spaces</code> to allow breaks at spaces (note, this requires - <code>obeyspaces</code> as well, and <code>hyphens</code> to allow - breaks after hyphens. (Note that the package <em>never</em> does - “ordinary” hyphenation of names inside an URL.) -<p/> It is possible to use the <i>url</i> package in Plain TeX, - with the assistance of the <i>miniltx</i> package (which was - originally developed for using the LaTeX graphics package in - Plain TeX). A small patch is also necessary: the required - sequence is therefore: - -<pre> -\input miniltx -\expandafter\def\expandafter\+\expandafter{\+} -\input url.sty -</pre> -<li> The <i>hyperref</i> package, which uses the typesetting code - of <i>url</i>, in a context where the typeset text forms the - anchor of a link. -</ul> -<p/>The author of this answer prefers the (rather newer) <i>url</i> -package (directly or indirectly); both <i>path</i> and -<i>url</i> work well with Plain TeX (though of course, the fancy -LaTeX facilities of <i>url</i> don’t have much place there). -(<i>hyperref</i> isn’t available in a version for use with Plain TeX.) -<p/>Note that neither <code>\</code><code>path</code> (from package <i>path</i>) nor <code>\</code><code>url</code> (from -package <i>url</i>) is robust (in the LaTeX sense). If you need -a URL to go in a moving argument, you need the command -<code>\</code><code>urldef</code> from the <i>url</i> package. So one might write: -<blockquote> -<pre> -\urldef\faqhome\url{http://www.tex.ac.uk/faq} -</pre> -</blockquote><p> -after which, <code>\</code><code>faqhome</code> is robust. -<p/>Documentation of both package <i>path</i> and package <i>url</i> -is in the package files. -<dl> -<dt><tt><i>hyperref.sty</i></tt><dd><a href="http://mirror.ctan.org/macros/latex/contrib/hyperref.zip">macros/latex/contrib/hyperref</a> (or <a href="http://mirror.ctan.org/macros/latex/contrib/hyperref/">browse the directory</a>); <a href="http://mirror.ctan.org/help/Catalogue/entries/hyperref.html">catalogue entry</a> -<dt><tt><i>miniltx.tex</i></tt><dd>Distributed as part of <a href="http://mirror.ctan.org/macros/plain/graphics.zip">macros/plain/graphics</a> (or <a href="http://mirror.ctan.org/macros/plain/graphics/">browse the directory</a>); <a href="http://mirror.ctan.org/help/Catalogue/entries/miniltx.html">catalogue entry</a> -<dt><tt><i>path.sty</i></tt><dd><a href="http://mirror.ctan.org/macros/generic/path.zip">macros/generic/path</a> (or <a href="http://mirror.ctan.org/macros/generic/path/">browse the directory</a>); <a href="http://mirror.ctan.org/help/Catalogue/entries/path.html">catalogue entry</a> -<dt><tt><i>url.sty</i></tt><dd><a href="http://mirror.ctan.org/macros/latex/contrib/url.zip">macros/latex/contrib/url</a> (or <a href="http://mirror.ctan.org/macros/latex/contrib/url/">browse the directory</a>); <a href="http://mirror.ctan.org/help/Catalogue/entries/url.html">catalogue entry</a> -</dl> -<p/><p>This question on the Web: <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=setURL">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=setURL</a> -</body> |