1 <refentry xmlns="http://docbook.org/ns/docbook"
\r
2 xmlns:xlink="http://www.w3.org/1999/xlink"
\r
3 xmlns:xi="http://www.w3.org/2001/XInclude"
\r
4 xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
\r
5 xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
\r
6 version="5.0" xml:id="insert.link.page.number">
\r
8 <refentrytitle>insert.link.page.number</refentrytitle>
\r
9 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>
\r
10 <refmiscinfo class="other" otherclass="value">no</refmiscinfo>
\r
11 <refmiscinfo class="other" otherclass="value">yes</refmiscinfo>
\r
12 <refmiscinfo class="other" otherclass="value">maybe</refmiscinfo>
\r
15 <refname>insert.link.page.number</refname>
\r
16 <refpurpose>Turns page numbers in link elements on and off</refpurpose>
\r
20 <src:fragment xml:id="insert.link.page.number.frag">
\r
21 <xsl:param name="insert.link.page.number">no</xsl:param>
\r
25 <refsection><info><title>Description</title></info>
\r
27 <para>The value of this parameter determines if
\r
28 cross references using the <tag>link</tag> element in
\r
30 include standard page number citations.
\r
31 It has three possible values.
\r
36 <listitem><para>No page number references will be generated.
\r
41 <listitem><para>Page number references will be generated
\r
42 for all <tag>link</tag> elements.
\r
43 The style of page reference may be changed
\r
44 if an <tag class="attribute">xrefstyle</tag>
\r
50 <listitem><para>Page number references will not be generated
\r
51 for a <tag>link</tag> element unless
\r
53 <tag class="attribute">xrefstyle</tag>
\r
54 attribute whose value specifies a page reference.
\r
59 <para>Although the <tag>xrefstyle</tag> attribute
\r
60 can be used to turn the page reference on or off, it cannot be
\r
61 used to control the formatting of the page number as it
\r
62 can in <tag>xref</tag>.
\r
63 In <tag>link</tag> it will always format with
\r
64 the style established by the
\r
65 gentext template with <literal>name="page.citation"</literal>
\r
66 in the <literal>l:context name="xref"</literal>.
\r