diff options
Diffstat (limited to 'Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pdfpagelabels.html')
-rw-r--r-- | Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pdfpagelabels.html | 19 |
1 files changed, 11 insertions, 8 deletions
diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pdfpagelabels.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pdfpagelabels.html index 79570cdffa0..de28ce75cc0 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pdfpagelabels.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pdfpagelabels.html @@ -4,26 +4,29 @@ <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 +to lower-case roman. This is fine for human readers, but if +<i>hyperref</i> has been misconfigured, the existence of pages have +the same page number can cause problems. Fortunately, the configuration options to make <i>hyperref</i> “do the right -thing”. +thing” are (by default) set up to avoid problems. <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.) + (This is the default value for the option, which is a + <em>good thing</em>\dots) + If the option is set ‘<code>true</code>’ <i>hyperref</i> writes page + anchors as the arabic form of the page number, rather than the + formatted form that gets printed; this is not usually appropriate. <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. +‘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 |