diff options
Diffstat (limited to 'Master/texmf-doc/doc/english/FAQ-en/html/FAQ-nameref.html')
-rw-r--r-- | Master/texmf-doc/doc/english/FAQ-en/html/FAQ-nameref.html | 41 |
1 files changed, 29 insertions, 12 deletions
diff --git a/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-nameref.html b/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-nameref.html index 29a8976f320..cc1f61d9071 100644 --- a/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-nameref.html +++ b/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-nameref.html @@ -2,27 +2,27 @@ <title>UK TeX FAQ -- question label nameref</title> </head><body> <h3>Referring to things by their name</h3> -<p>LaTeX’s labelling mechanism is designed for the impersonal world of +<p/>LaTeX’s labelling mechanism is designed for the impersonal world of the academic publication, in which everything has a number: an extension is necessary if we are to record the <em>name</em> of things we’ve labelled. The two packages available extend the LaTeX sectioning commands to provide reference by the name of the section. -<p>The <i>titleref</i> package is a simple extension which provides +<p/>The <i>titleref</i> package is a simple extension which provides the command <code>\</code><code>titleref</code>; it is a stand-alone package — don’t use it in a document in which you also need to use <i>hyperref</i>. -<p>The <i>byname</i> package is part of the <i>smartref</i> bundle +<p/>The <i>byname</i> package is part of the <i>smartref</i> bundle and works well with <i>smartref</i>, and works (to an extent) with <i>hyperref</i>, but the links it defines are not hyperlinks. -<p>The <i>memoir</i> class incorporates the functionality of +<p/>The <i>memoir</i> class incorporates the functionality of <i>titleref</i>, but doesn’t work with <i>byname</i> (though a search of <i>comp.text.tex</i> on <a href="groups.google.com">groups.google.com</a> will find a patch to <i>byname</i> to remedy the problem). -<p>The <i>hyperref</i> bundle includes a package <i>nameref</i>, +<p/>The <i>hyperref</i> bundle includes a package <i>nameref</i>, which will work standing alone (i.e., without <i>hyperref</i>: of course, in this mode its references are not hyperlinked). If you load <i>hyperref</i> itself, <i>nameref</i> is automatically loaded. <i>Memoir</i> requires the <i>memhfixc</i> when running with -<i>hyperref</i>; however, following the sequence +<i>hyperref</i>; following the sequence: <blockquote> <pre> \documentclass[...]{memoir} @@ -32,11 +32,27 @@ course, in this mode its references are not hyperlinked). If you load </pre> </blockquote><p> <i>nameref</i> commands may be used in a <i>memoir</i> document. -<p>Each of the name-reference packages defines a reference command -with the same name as the package: <code>\</code><code>titleref</code>, <code>\</code><code>byname</code> and -<code>\</code><code>nameref</code>. The <i>nameref</i> package also defines a command -<code>\</code><code>byshortnameref</code>, which uses the optional ‘short’ title argument -to the chapter and section commands. +<p/><i>Zref</i> defines a proposed replacement for all of the LaTeX +reference mechanisms, and among other things provides +name-referencing mechanisms: +<blockquote> +<pre> +\usepackage[user,titleref]{zref} +... +\section{hello}\zlabel{sec:one} +The section name is: \ztitleref{sec:one}. +</pre> +</blockquote><p> +(One might hope that something of this sort would be the “way of the +future”, but things move slowly in the LaTeX world: don’t hold +your breath.) +<p/>Each of <i>titleref</i>, <i>byname</i> and <i>nameref</i> +defines a reference command with the same name as the package: +<code>\</code><code>titleref</code>, <code>\</code><code>byname</code> and <code>\</code><code>nameref</code>. The <i>nameref</i> +package also defines a command <code>\</code><code>byshortnameref</code>, which uses the +optional ‘short’ title argument to the chapter and section commands. +(Although it comes from the same author, <i>zref</i> <em>doesn’t</em> +define a short-name variant.) <dl> <dt><tt><i>byname.sty</i></tt><dd>Distributed with <a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/smartref.zip">macros/latex/contrib/smartref</a> (<a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/smartref.tar.gz">gzipped tar</a>, <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/smartref/">browse</a>) <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>) @@ -44,6 +60,7 @@ to the chapter and section commands. <dt><tt><i>nameref.sty</i></tt><dd>Distributed with <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>smartref.sty</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/smartref.zip">macros/latex/contrib/smartref</a> (<a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/smartref.tar.gz">gzipped tar</a>, <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/smartref/">browse</a>) <dt><tt><i>titleref.sty</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/misc/titleref.sty">macros/latex/contrib/misc/titleref.sty</a> +<dt><tt><i>zref.sty</i></tt><dd>Distributed as part of <a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/oberdiek.zip">macros/latex/contrib/oberdiek</a> (<a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/oberdiek.tar.gz">gzipped tar</a>, <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/oberdiek/">browse</a>) </dl> -<p><p>This question on the Web: <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=nameref">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=nameref</a> +<p/><p>This question on the Web: <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=nameref">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=nameref</a> </body> |