Guide to LaTeX (4th Edition) (Tools and Techniques

216 Chapter 9. Document Management
the example above when \label on same page,
the example on the previous page on following page,
the example on page 24 when two of more pages away,
while the \vpageref[above example][example]{f1} outputs one of:
the above example when \label on same page,
the example on the next page on the following page,
the example on page 24 when two of more pages away.
A range of numbers and pages can be produced with the command
\vrefrange, which takes two mandatory arguments, both label keys. It
prints text like ‘5 to 7 on pages 212–214’, or ‘5 to 7 on the next page’, and
so on. It takes one optional argument, the text to print when both labels
are on the current page.
The page part of \vrefrange only is printed with \vpagerefrange,
which also takes two mandatory (label key) arguments and one optional
(text) one. If both labels are on the same page, it behaves like \vpageref;
the optional argument is printed if both are on the current page.
Since English text is automatically printed by the above commands,
they would not be very useful for documents, say, in Italian. The varioref
package therefore accepts all the language options recognized by the
babel system (Chapter 11) to reprogram the texts. With the option
italian, one will get texts like in questa pagina for ‘on this page’ and
nella pagina precedente for ‘on the preceding page’, and so on.
All the texts are stored in special commands which can be redefined
by the user:
\reftextbefore previous but non-facing page
\reftextfacebefore previous but facing page
\reftextafter next but non-facing page
\reftextfaceafter next but facing page
\reftextfaraway{key} more than one page away
\reftextpagerange{key1}{key2} page range of 2 labels
\reftextlabelrange{key1}{key2} range of 2 different labels.
The last three must be redefined with 1 or 2 arguments, as
\renewcommand{\reftextfaraway}[1]{on page \pageref{#1}}
\renewcommand{\reftextpagerange}[2]{on pages \pageref{#1}%
--\pageref{#2}}
\renewcommand{\reftextlabelrange}[2]{\ref{#1} to \ref{#2}}
There is also \vreftextvario{text1}{text2} to provide altering texts
for the above commands, so that the same text is not printed every time.
9.3 Bibliographies
Academic publications normally include a list of references, or bibliography,
containing the names of other works that are cited within the text