summaryrefslogtreecommitdiff
path: root/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-setURL.html
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-doc/doc/english/FAQ-en/html/FAQ-setURL.html')
-rw-r--r--Master/texmf-doc/doc/english/FAQ-en/html/FAQ-setURL.html63
1 files changed, 63 insertions, 0 deletions
diff --git a/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-setURL.html b/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-setURL.html
new file mode 100644
index 00000000000..2afdad9e733
--- /dev/null
+++ b/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-setURL.html
@@ -0,0 +1,63 @@
+<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. Note that, because the operation is
+ conducted in maths mode, spaces within the URL argument are
+ ignored unless special steps are taken.
+<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>Documentation of both <i>path</i> and <i>url</i> is in the
+package files.
+<dl>
+<dt><tt><i>hyperref.sty</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/hyperref.zip">macros/latex/contrib/hyperref</a> (<a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/hyperref.tar.gz">gzipped tar</a>, <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/hyperref/">browse</a>)
+<dt><tt><i>miniltx.tex</i></tt><dd>Distributed as part of <a href="ftp://cam.ctan.org/tex-archive/macros/plain/graphics.zip">macros/plain/graphics</a> (<a href="ftp://cam.ctan.org/tex-archive/macros/plain/graphics.tar.gz">gzipped tar</a>, <a href="http://www.tex.ac.uk/tex-archive/macros/plain/graphics/">browse</a>)
+<dt><tt><i>path.sty</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/misc/path.sty">macros/latex/contrib/misc/path.sty</a>
+<dt><tt><i>url.sty</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/misc/url.sty">macros/latex/contrib/misc/url.sty</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>