summaryrefslogtreecommitdiff
path: root/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-pdfpagelabels.html
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-doc/doc/english/FAQ-en/html/FAQ-pdfpagelabels.html')
-rw-r--r--Master/texmf-doc/doc/english/FAQ-en/html/FAQ-pdfpagelabels.html37
1 files changed, 37 insertions, 0 deletions
diff --git a/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-pdfpagelabels.html b/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-pdfpagelabels.html
new file mode 100644
index 00000000000..1302d60ec7c
--- /dev/null
+++ b/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-pdfpagelabels.html
@@ -0,0 +1,37 @@
+<head>
+<title>UK TeX FAQ -- question label pdfpagelabels</title>
+</head><body>
+<h3><i>Hyperref</i> and repeated page numbers</h3>
+<p>The <i>book</i> class (and its friends and relations) automatically
+changes the display of page numbers in the frontmatter of the document
+to lower-case roman. This is fine for human readers, but it confuses
+<i>hyperref</i> since there are pages which seem (to
+<i>hyperref</i>) to have the same page number. Fortunately, there are
+configuration options to make <i>hyperref</i> "do the right
+thing".
+<p>The two options in question are:
+<dl>
+<dt><code>plainpages=false</code><dd> Make page anchors using the
+ formatted form of the page number. With this option,
+ <i>hyperref</i> writes different anchors for pages 'ii' and '2'.
+ (If the option is set '<code>true</code>' - the default -
+ <i>hyperref</i> writes page anchors as the arabic form of the
+ absolute page number, rather than the formatted form.)
+<dt><code>pdfpagelabels</code><dd> Set PDF page labels; i.e.,
+ write the value of <code>\</code><code>thepage</code> to the PDF file so that
+ <i>Acrobat Reader</i> can display the page number as (say) 'ii (4
+ of 40)' rather than simply '4 of 40'.
+</dl>
+The two should be used whenever page numbering is not just
+'1<code>..</code>n'; they may be used independently, but usually are not.
+<p>The recipe isn't perfect: it relies on <code>\</code><code>thepage</code> being different
+for every page in the document. A common problem arises when there is
+an unnumbered title page, after which page numbers are reset: the
+PDFTeX warning of "<a href="FAQ-hyperdupdest.html">duplicate destinations</a>"
+will happen in this case, regardless of the options.
+<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>)
+</dl>
+<p>
+<p><p><p><p>This question on the Web: <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=pdfpagelabels">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=pdfpagelabels</a>
+</body>