]> git.stg.codes - stg.git/blob - doc/xslt/params/insert.link.page.number.xml
Help book chapter 3 complete
[stg.git] / doc / xslt / params / insert.link.page.number.xml
1 <refentry xmlns="http://docbook.org/ns/docbook"
2           xmlns:xlink="http://www.w3.org/1999/xlink"
3           xmlns:xi="http://www.w3.org/2001/XInclude"
4           xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
5           xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
6           version="5.0" xml:id="insert.link.page.number">
7 <refmeta>
8 <refentrytitle>insert.link.page.number</refentrytitle>
9 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> 
10 <refmiscinfo class="other" otherclass="value">no</refmiscinfo>
11 <refmiscinfo class="other" otherclass="value">yes</refmiscinfo>
12 <refmiscinfo class="other" otherclass="value">maybe</refmiscinfo>
13 </refmeta>
14 <refnamediv>
15 <refname>insert.link.page.number</refname>
16 <refpurpose>Turns page numbers in link elements on and off</refpurpose>
17 </refnamediv>
18
19 <refsynopsisdiv>
20 <src:fragment xml:id="insert.link.page.number.frag">
21 <xsl:param name="insert.link.page.number">no</xsl:param>
22 </src:fragment>
23 </refsynopsisdiv>
24
25 <refsection><info><title>Description</title></info>
26
27 <para>The value of this parameter determines if
28 cross references using the <tag>link</tag> element in
29 printed output will
30 include standard page number citations.
31 It has three possible values.
32 </para>
33 <variablelist>
34 <varlistentry>
35 <term>no</term>
36 <listitem><para>No page number references will be generated.
37 </para></listitem>
38 </varlistentry>
39 <varlistentry>
40 <term>yes</term>
41 <listitem><para>Page number references will be generated
42 for all <tag>link</tag> elements.
43 The style of page reference may be changed
44 if an <tag class="attribute">xrefstyle</tag>
45 attribute is used.
46 </para></listitem>
47 </varlistentry>
48 <varlistentry>
49 <term>maybe</term>
50 <listitem><para>Page number references will not be generated
51 for a <tag>link</tag> element unless 
52 it has an
53 <tag class="attribute">xrefstyle</tag>
54 attribute whose value specifies a page reference.
55 </para></listitem>
56 </varlistentry>
57 </variablelist>
58
59 <para>Although the <tag>xrefstyle</tag> attribute
60 can be used to turn the page reference on or off, it cannot be
61 used to control the formatting of the page number as it
62 can in <tag>xref</tag>.
63 In <tag>link</tag> it will always format with
64 the style established by the
65 gentext template with <literal>name="page.citation"</literal>
66 in the <literal>l:context name="xref"</literal>.
67 </para>
68 </refsection>
69 </refentry>