File: generate.consistent.ids.html

package info (click to toggle)
docbook-xsl-doc 1.78.1-1.1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 6,848 kB
  • sloc: makefile: 10; sh: 5
file content (46 lines) | stat: -rw-r--r-- 3,389 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>generate.consistent.ids</title><link rel="stylesheet" type="text/css" href="../reference.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="../index.html" title="DocBook XSL Stylesheets: ReferenceDocumentation"><link rel="up" href="misc.html" title="Miscellaneous"><link rel="prev" href="bookmarks.collapse.html" title="bookmarks.collapse"><link rel="next" href="base.dir.html" title="base.dir"><link rel="copyright" href="copyright.html" title="License"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">generate.consistent.ids</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="bookmarks.collapse.html">Prev</a></td><th width="60%" align="center">Miscellaneous</th><td width="20%" align="right"><a accesskey="n" href="base.dir.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="generate.consistent.ids"></a><div class="titlepage"></div>

<div class="refnamediv"><h2><span class="refentrytitle">generate.consistent.ids</span></h2><p>
generate.consistent.ids
 &#8212; Generate consistent id values if document is unchanged
</p></div>

<div class="refsynopsisdiv"><h2>Synopsis</h2>
<a name="generate.consistent.ids.frag"></a><pre class="programlisting">
&lt;xsl:param name="generate.consistent.ids" select="0"&gt;&lt;/xsl:param&gt;
</pre>
</div>

<div class="refsection"><a name="idp5410288"></a><h2>Description</h2>

<p>When the stylesheet assigns an id value to an output element,
the generate-id() function may be used.  That function may not
produce consistent values between runs.  Version control
systems may misidentify the changing id values as changes
to the document.</p>

<p>If you set this parameter's value to 1, then the
template named <code class="literal">object.id</code> will replace
the use of the function generate-id() with
<code class="literal">&lt;xsl:number level="multiple" count="*"/&gt;</code>.
This counts preceding elements to generate a unique number for
the id value.</p>

<div class="caution" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Caution</h3>
<p>This param does not associate permanent unique id values
with particular elements.
The id values are consistent only as long as the document
structure does not change.
If the document structure changes, then the counting
of elements changes, and all id values after
the first such change may be different, even when there is
no change to the element itself or its output.
</p>
</div>

<p>The default value of this parameter is zero, so generate-id() is used
by default.</p>

</div>
</div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="bookmarks.collapse.html">Prev</a></td><td width="20%" align="center"><a accesskey="u" href="misc.html">Up</a></td><td width="40%" align="right"><a accesskey="n" href="base.dir.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">bookmarks.collapse</td><td width="20%" align="center"><a accesskey="h" href="../index.html">Home</a></td><td width="40%" align="right" valign="top">base.dir</td></tr></table></div></body></html>