]> git.evergreen-ils.org Git - working/Evergreen.git/blob - stylesheets/evergreen_docbook_files/docbook-xsl-1.75.2/fo/param.xml
Add stylesheets for our evergreen docbook site.
[working/Evergreen.git] / stylesheets / evergreen_docbook_files / docbook-xsl-1.75.2 / fo / param.xml
1 <?xml version="1.0" encoding="ASCII"?>\r
2 <book version="5.0">\r
3 <info>\r
4 <title>FO Parameter Reference</title>\r
5 <releaseinfo role="meta">\r
6 $Id: param.xweb 8392 2009-04-01 08:47:55Z bobstayton $\r
7 </releaseinfo>\r
8 <author>\r
9   <personname>\r
10     <surname>Walsh</surname>\r
11     <firstname>Norman</firstname>\r
12   </personname>\r
13 </author>\r
14 <copyright>\r
15   <year>1999</year>\r
16   <year>2000</year>\r
17   <year>2001</year>\r
18   <year>2002</year>\r
19   <year>2003</year>\r
20   <year>2004</year>\r
21   <year>2005</year>\r
22   <year>2006</year>\r
23   <year>2007</year>\r
24   <holder>Norman Walsh</holder>\r
25 </copyright>\r
26 <abstract>\r
27   <para>This is reference documentation for all user-configurable\r
28   parameters in the DocBook XSL FO stylesheets (for generating\r
29   XSL-FO output destined for final print/PDF output).</para>\r
30 </abstract>\r
31 </info>\r
32 <reference xml:id="admons"><title>Admonitions</title>\r
33 <refentry version="5.0" xml:id="admon.graphics">\r
34 <refmeta>\r
35 <refentrytitle>admon.graphics</refentrytitle>\r
36 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
37 </refmeta>\r
38 <refnamediv>\r
39 <refname>admon.graphics</refname>\r
40 <refpurpose>Use graphics in admonitions?</refpurpose>\r
41 </refnamediv>\r
42 \r
43 <refsynopsisdiv>\r
44 <programlisting xml:id="admon.graphics.frag">\r
45 &lt;xsl:param name="admon.graphics" select="0"&gt;&lt;/xsl:param&gt;\r
46 </programlisting>\r
47 </refsynopsisdiv>\r
48 \r
49 <refsection><info><title>Description</title></info>\r
50 \r
51 <para>If true (non-zero), admonitions are presented in an alternate style that uses\r
52 a graphic.  Default graphics are provided in the distribution.\r
53 </para>\r
54 \r
55 </refsection>\r
56 </refentry>\r
57 \r
58 <refentry version="5.0" xml:id="admon.graphics.extension">\r
59 <refmeta>\r
60 <refentrytitle>admon.graphics.extension</refentrytitle>\r
61 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
62 </refmeta>\r
63 <refnamediv>\r
64 <refname>admon.graphics.extension</refname>\r
65 <refpurpose>Filename extension for admonition graphics</refpurpose>\r
66 </refnamediv>\r
67 \r
68 <refsynopsisdiv>\r
69 <programlisting xml:id="admon.graphics.extension.frag">\r
70 &lt;xsl:param name="admon.graphics.extension"&gt;.png&lt;/xsl:param&gt;\r
71 </programlisting>\r
72 </refsynopsisdiv>\r
73 \r
74 <refsection><info><title>Description</title></info>\r
75 \r
76 <para>Sets the filename extension to use on admonition graphics.</para>\r
77 \r
78 </refsection>\r
79 </refentry>\r
80 \r
81 <refentry version="5.0" xml:id="admon.graphics.path">\r
82 <refmeta>\r
83 <refentrytitle>admon.graphics.path</refentrytitle>\r
84 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
85 </refmeta>\r
86 <refnamediv>\r
87 <refname>admon.graphics.path</refname>\r
88 <refpurpose>Path to admonition graphics</refpurpose>\r
89 </refnamediv>\r
90 \r
91 <refsynopsisdiv>\r
92 <programlisting xml:id="admon.graphics.path.frag">&lt;xsl:param name="admon.graphics.path"&gt;images/&lt;/xsl:param&gt;</programlisting>\r
93 </refsynopsisdiv>\r
94 \r
95 <refsection><info><title>Description</title></info>\r
96 \r
97 <para>Sets the path to the directory containing the admonition graphics\r
98 (caution.png, important.png etc). This location is normally relative\r
99 to the output html directory. See <parameter>base.dir</parameter></para>\r
100 \r
101 </refsection>\r
102 </refentry>\r
103 \r
104 <refentry version="5.0" xml:id="admon.textlabel">\r
105 <refmeta>\r
106 <refentrytitle>admon.textlabel</refentrytitle>\r
107 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
108 </refmeta>\r
109 <refnamediv>\r
110 <refname>admon.textlabel</refname>\r
111 <refpurpose>Use text label in admonitions?</refpurpose>\r
112 </refnamediv>\r
113 \r
114 <refsynopsisdiv>\r
115 <programlisting xml:id="admon.textlabel.frag">\r
116 &lt;xsl:param name="admon.textlabel" select="1"&gt;&lt;/xsl:param&gt;\r
117 </programlisting>\r
118 </refsynopsisdiv>\r
119 \r
120 <refsection><info><title>Description</title></info>\r
121 \r
122 <para>If true (non-zero), admonitions are presented with a generated\r
123 text label such as Note or Warning in the appropriate language.\r
124 If zero, such labels are turned off, but any title child\r
125 of the admonition element are still output.\r
126 The default value is 1.\r
127 </para>\r
128 \r
129 </refsection>\r
130 </refentry>\r
131 \r
132 <refentry version="5.0" xml:id="admonition.title.properties">\r
133 \r
134 <refmeta>\r
135   <refentrytitle>admonition.title.properties</refentrytitle>\r
136   <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
137 </refmeta>\r
138 <refnamediv>\r
139 <refname>admonition.title.properties</refname>\r
140 <refpurpose>To set the style for admonitions titles.</refpurpose>\r
141 </refnamediv>\r
142 \r
143 <refsynopsisdiv>\r
144 <programlisting xml:id="admonition.title.properties.frag">\r
145 &lt;xsl:attribute-set name="admonition.title.properties"&gt;\r
146   &lt;xsl:attribute name="font-size"&gt;14pt&lt;/xsl:attribute&gt;\r
147   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;\r
148   &lt;xsl:attribute name="hyphenate"&gt;false&lt;/xsl:attribute&gt;\r
149   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;\r
150 &lt;/xsl:attribute-set&gt;\r
151 </programlisting>\r
152 </refsynopsisdiv>\r
153 <refsection><info><title>Description</title></info>\r
154 <para>How do you want admonitions titles styled? </para>\r
155 <para>Set the font-size, weight etc to the style required.</para>\r
156 \r
157 </refsection>\r
158 </refentry>\r
159 \r
160 <refentry version="5.0" xml:id="admonition.properties">\r
161 <refmeta>\r
162   <refentrytitle>admonition.properties</refentrytitle>\r
163   <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
164 </refmeta>  \r
165 <refnamediv>\r
166 <refname>admonition.properties</refname>\r
167 <refpurpose>To set the style for admonitions.</refpurpose>\r
168 </refnamediv>\r
169 \r
170 <refsynopsisdiv>\r
171 <programlisting xml:id="admonition.properties.frag">&lt;xsl:attribute-set name="admonition.properties"&gt;&lt;/xsl:attribute-set&gt;\r
172 </programlisting>\r
173 </refsynopsisdiv>\r
174 <refsection><info><title>Description</title></info>\r
175 <para>How do you want admonitions styled? </para>\r
176 <para>Set the font-size, weight, etc. to the style required</para>\r
177 \r
178 </refsection>\r
179 </refentry>\r
180 \r
181 <refentry version="5.0" xml:id="graphical.admonition.properties">\r
182 <refmeta>\r
183 <refentrytitle>graphical.admonition.properties</refentrytitle>\r
184 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
185 </refmeta>\r
186 <refnamediv>\r
187 <refname>graphical.admonition.properties</refname>\r
188 <refpurpose>To add properties to the outer block of a graphical admonition.</refpurpose>\r
189 </refnamediv>\r
190 \r
191 <refsynopsisdiv>\r
192 <programlisting xml:id="graphical.admonition.properties.frag">&lt;xsl:attribute-set name="graphical.admonition.properties"&gt;\r
193   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;\r
194   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;\r
195   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;\r
196   &lt;xsl:attribute name="space-after.optimum"&gt;1em&lt;/xsl:attribute&gt;\r
197   &lt;xsl:attribute name="space-after.minimum"&gt;0.8em&lt;/xsl:attribute&gt;\r
198   &lt;xsl:attribute name="space-after.maximum"&gt;1.2em&lt;/xsl:attribute&gt;\r
199 &lt;/xsl:attribute-set&gt;\r
200 </programlisting>\r
201 </refsynopsisdiv>\r
202 <refsection><info><title>Description</title></info>\r
203 <para>These properties are added to the outer block containing the\r
204 entire graphical admonition, including its title.\r
205 It is used when the parameter\r
206 <parameter>admon.graphics</parameter> is set to nonzero.\r
207 Use this attribute-set to set the space above and below,\r
208 and any indent for the whole admonition.</para>\r
209 \r
210 <para>In addition to these properties, a graphical admonition\r
211 also applies the <parameter>admonition.title.properties</parameter>\r
212 attribute-set to the title, and applies the\r
213 <parameter>admonition.properties</parameter> attribute-set\r
214 to the rest of the content.</para>\r
215 \r
216 </refsection>\r
217 </refentry>\r
218 \r
219 <refentry version="5.0" xml:id="nongraphical.admonition.properties">\r
220 <refmeta>\r
221 <refentrytitle>nongraphical.admonition.properties</refentrytitle>\r
222 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
223 </refmeta>\r
224 <refnamediv>\r
225 <refname>nongraphical.admonition.properties</refname>\r
226 <refpurpose>To add properties to the outer block of a nongraphical admonition.</refpurpose>\r
227 </refnamediv>\r
228 \r
229 <refsynopsisdiv>\r
230 <programlisting xml:id="nongraphical.admonition.properties.frag">&lt;xsl:attribute-set name="nongraphical.admonition.properties"&gt;\r
231   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;\r
232   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;\r
233   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;\r
234   &lt;xsl:attribute name="margin-{$direction.align.start}"&gt;0.25in&lt;/xsl:attribute&gt;\r
235   &lt;xsl:attribute name="margin-{$direction.align.end}"&gt;0.25in&lt;/xsl:attribute&gt;\r
236 &lt;/xsl:attribute-set&gt;\r
237 </programlisting>\r
238 </refsynopsisdiv>\r
239 <refsection><info><title>Description</title></info>\r
240 <para>These properties are added to the outer block containing the\r
241 entire nongraphical admonition, including its title.\r
242 It is used when the parameter\r
243 <parameter>admon.graphics</parameter> is set to zero.\r
244 Use this attribute-set to set the space above and below,\r
245 and any indent for the whole admonition.</para>\r
246 \r
247 <para>In addition to these properties, a nongraphical admonition\r
248 also applies the <parameter>admonition.title.properties</parameter>\r
249 attribute-set to the title, and the\r
250 <parameter>admonition.properties</parameter> attribute-set\r
251 to the rest of the content.</para>\r
252 \r
253 </refsection>\r
254 </refentry>\r
255 \r
256 </reference>\r
257 <reference xml:id="callouts"><title>Callouts</title>\r
258 <refentry version="5.0" xml:id="callout.defaultcolumn">\r
259 <refmeta>\r
260 <refentrytitle>callout.defaultcolumn</refentrytitle>\r
261 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>\r
262 </refmeta>\r
263 <refnamediv>\r
264 <refname>callout.defaultcolumn</refname>\r
265 <refpurpose>Indicates what column callouts appear in by default</refpurpose>\r
266 </refnamediv>\r
267 \r
268 <refsynopsisdiv>\r
269 <programlisting xml:id="callout.defaultcolumn.frag">\r
270 &lt;xsl:param name="callout.defaultcolumn"&gt;60&lt;/xsl:param&gt;\r
271 </programlisting>\r
272 </refsynopsisdiv>\r
273 \r
274 <refsection><info><title>Description</title></info>\r
275 \r
276 <para>If a callout does not identify a column (for example, if it uses\r
277 the <literal>linerange</literal> <tag class="attribute">unit</tag>),\r
278 it will appear in the default column.\r
279 </para>\r
280 \r
281 </refsection>\r
282 </refentry>\r
283 \r
284 <refentry version="5.0" xml:id="callout.graphics">\r
285 <refmeta>\r
286 <refentrytitle>callout.graphics</refentrytitle>\r
287 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
288 </refmeta>\r
289 <refnamediv>\r
290 <refname>callout.graphics</refname>\r
291 <refpurpose>Use graphics for callouts?</refpurpose>\r
292 </refnamediv>\r
293 \r
294 <refsynopsisdiv>\r
295 <programlisting xml:id="callout.graphics.frag">\r
296 &lt;xsl:param name="callout.graphics" select="1"&gt;&lt;/xsl:param&gt;\r
297 </programlisting>\r
298 </refsynopsisdiv>\r
299 \r
300 <refsection><info><title>Description</title></info>\r
301 \r
302 <para>If non-zero, callouts are presented with graphics (e.g., reverse-video\r
303 circled numbers instead of "(1)", "(2)", etc.).\r
304 Default graphics are provided in the distribution.\r
305 </para>\r
306 \r
307 </refsection>\r
308 </refentry>\r
309 \r
310 <refentry version="5.0" xml:id="callout.graphics.extension">\r
311 <refmeta>\r
312 <refentrytitle>callout.graphics.extension</refentrytitle>\r
313 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
314 </refmeta>\r
315 <refnamediv>\r
316 <refname>callout.graphics.extension</refname>\r
317 <refpurpose>Filename extension for callout graphics</refpurpose>\r
318 </refnamediv>\r
319 \r
320 <refsynopsisdiv>\r
321 <programlisting xml:id="callout.graphics.extension.frag">\r
322 \r
323 &lt;xsl:param name="callout.graphics.extension"&gt;.svg&lt;/xsl:param&gt;\r
324 </programlisting>\r
325 </refsynopsisdiv>\r
326 \r
327 <refsection><info><title>Description</title></info>\r
328 <para>Sets the filename extension to use on callout graphics. </para>\r
329 \r
330 <itemizedlist>\r
331 <para>The Docbook XSL distribution provides callout graphics in the following formats:</para>\r
332 <listitem><para>SVG (extension: <filename class="extension">.svg</filename>)</para></listitem>\r
333 <listitem><para>PNG (extension: <filename class="extension">.png</filename>)</para></listitem>\r
334 <listitem><para>GIF (extension: <filename class="extension">.gif</filename>)</para></listitem>\r
335 </itemizedlist>\r
336 </refsection>\r
337 </refentry>\r
338 \r
339 <refentry version="5.0" xml:id="callout.graphics.number.limit">\r
340 <refmeta>\r
341 <refentrytitle>callout.graphics.number.limit</refentrytitle>\r
342 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>\r
343 </refmeta>\r
344 <refnamediv>\r
345 <refname>callout.graphics.number.limit</refname>\r
346 <refpurpose>Number of the largest callout graphic</refpurpose>\r
347 </refnamediv>\r
348 \r
349 <refsynopsisdiv>\r
350 <programlisting xml:id="callout.graphics.number.limit.frag">\r
351 \r
352 &lt;xsl:param name="callout.graphics.number.limit"&gt;30&lt;/xsl:param&gt;\r
353 </programlisting>\r
354 </refsynopsisdiv>\r
355 \r
356 <refsection><info><title>Description</title></info>\r
357 \r
358 <para>If <parameter>callout.graphics</parameter> is non-zero, graphics\r
359 are used to represent callout numbers instead of plain text. The value\r
360 of <parameter>callout.graphics.number.limit</parameter> is the largest\r
361 number for which a graphic exists. If the callout number exceeds this\r
362 limit, the default presentation "(plain text instead of a graphic)"\r
363 will  be used.\r
364 </para>\r
365 \r
366 </refsection>\r
367 </refentry>\r
368 \r
369 <refentry version="5.0" xml:id="callout.graphics.path">\r
370 <refmeta>\r
371 <refentrytitle>callout.graphics.path</refentrytitle>\r
372 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
373 </refmeta>\r
374 <refnamediv>\r
375 <refname>callout.graphics.path</refname>\r
376 <refpurpose>Path to callout graphics</refpurpose>\r
377 </refnamediv>\r
378 \r
379 <refsynopsisdiv>\r
380 <programlisting xml:id="callout.graphics.path.frag">\r
381 &lt;xsl:param name="callout.graphics.path"&gt;images/callouts/&lt;/xsl:param&gt;\r
382 </programlisting>\r
383 </refsynopsisdiv>\r
384 \r
385 <refsection><info><title>Description</title></info>\r
386 \r
387 <para>Sets the path to the directory holding the callout graphics. his\r
388 location is normally relative to the output html directory. see\r
389 base.dir. Always terminate the directory with / since the graphic file\r
390 is appended to this string, hence needs the separator.\r
391 </para>\r
392 \r
393 </refsection>\r
394 </refentry>\r
395 \r
396 <refentry version="5.0" xml:id="callout.icon.size">\r
397 <refmeta>\r
398 <refentrytitle>callout.icon.size</refentrytitle>\r
399 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
400 </refmeta>\r
401 <refnamediv>\r
402 <refname>callout.icon.size</refname>\r
403 <refpurpose>Specifies the size of callout marker icons</refpurpose>\r
404 </refnamediv>\r
405 \r
406 <refsynopsisdiv>\r
407 <programlisting xml:id="callout.icon.size.frag">\r
408 &lt;xsl:param name="callout.icon.size"&gt;7pt&lt;/xsl:param&gt;\r
409 </programlisting>\r
410 </refsynopsisdiv>\r
411 \r
412 <refsection><info><title>Description</title></info>\r
413 \r
414 <para>Specifies the size of the callout marker icons.\r
415 The default size is 7 points.</para>\r
416 \r
417 </refsection>\r
418 </refentry>\r
419 \r
420 <refentry version="5.0" xml:id="callout.unicode">\r
421 <refmeta>\r
422 <refentrytitle>callout.unicode</refentrytitle>\r
423 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
424 </refmeta>\r
425 <refnamediv>\r
426 <refname>callout.unicode</refname>\r
427 <refpurpose>Use Unicode characters rather than images for callouts.</refpurpose>\r
428 </refnamediv>\r
429 \r
430 <refsynopsisdiv>\r
431 <programlisting xml:id="callout.unicode.frag">&lt;xsl:param name="callout.unicode" select="0"&gt;&lt;/xsl:param&gt;</programlisting>\r
432 </refsynopsisdiv>\r
433 \r
434 <refsection><info><title>Description</title></info>\r
435 \r
436 <para>The stylesheets can use either an image of the numbers one to ten, or the single Unicode character which represents the numeral, in white on a black background. Use this to select the Unicode character option.\r
437 </para>\r
438 \r
439 </refsection>\r
440 </refentry>\r
441 \r
442 <refentry version="5.0" xml:id="callout.unicode.font">\r
443 <refmeta>\r
444 <refentrytitle>callout.unicode.font</refentrytitle>\r
445 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
446 </refmeta>\r
447 <refnamediv>\r
448 <refname>callout.unicode.font</refname>\r
449 <refpurpose>Specify a font for Unicode glyphs</refpurpose>\r
450 </refnamediv>\r
451 \r
452 <refsynopsisdiv>\r
453 <programlisting xml:id="callout.unicode.font.frag">\r
454 &lt;xsl:param name="callout.unicode.font"&gt;ZapfDingbats&lt;/xsl:param&gt;\r
455 </programlisting>\r
456 </refsynopsisdiv>\r
457 \r
458 <refsection><info><title>Description</title></info>\r
459 \r
460 <para>The name of the font to specify around Unicode callout glyphs.\r
461 If set to the empty string, no font change will occur.\r
462 </para>\r
463 \r
464 </refsection>\r
465 </refentry>\r
466 \r
467 <refentry version="5.0" xml:id="callout.unicode.number.limit">\r
468 <refmeta>\r
469 <refentrytitle>callout.unicode.number.limit</refentrytitle>\r
470 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>\r
471 </refmeta>\r
472 <refnamediv>\r
473 <refname>callout.unicode.number.limit</refname>\r
474 <refpurpose>Number of the largest unicode callout character</refpurpose>\r
475 </refnamediv>\r
476 \r
477 <refsynopsisdiv>\r
478 <programlisting xml:id="callout.unicode.number.limit.frag">\r
479 &lt;xsl:param name="callout.unicode.number.limit"&gt;10&lt;/xsl:param&gt;\r
480 </programlisting>\r
481 </refsynopsisdiv>\r
482 \r
483 <refsection><info><title>Description</title></info>\r
484 \r
485 <para>If <parameter>callout.unicode</parameter>\r
486 is non-zero, unicode characters are used to represent\r
487 callout numbers. The value of\r
488 <parameter>callout.unicode.number.limit</parameter>\r
489 is\r
490 the largest number for which a unicode character exists. If the callout number\r
491 exceeds this limit, the default presentation "(nnn)" will always\r
492 be used.\r
493 </para>\r
494 \r
495 </refsection>\r
496 </refentry>\r
497 \r
498 <refentry version="5.0" xml:id="callout.unicode.start.character">\r
499 <refmeta>\r
500 <refentrytitle>callout.unicode.start.character</refentrytitle>\r
501 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>\r
502 </refmeta>\r
503 <refnamediv>\r
504 <refname>callout.unicode.start.character</refname>\r
505 <refpurpose>First Unicode character to use, decimal value.</refpurpose>\r
506 </refnamediv>\r
507 \r
508 <refsynopsisdiv>\r
509 <programlisting xml:id="callout.unicode.start.character.frag">\r
510 &lt;xsl:param name="callout.unicode.start.character"&gt;10102&lt;/xsl:param&gt;\r
511 </programlisting>\r
512 </refsynopsisdiv>\r
513 \r
514 <refsection><info><title>Description</title></info>\r
515 \r
516 <para>If <parameter>callout.graphics</parameter> is zero and <parameter>callout.unicode</parameter>\r
517 is non-zero, unicode characters are used to represent\r
518 callout numbers. The value of\r
519 <parameter>callout.unicode.start.character</parameter>\r
520 is the decimal unicode value used for callout number one. Currently, \r
521 only 10102 is supported in the stylesheets for this parameter. \r
522 </para>\r
523 \r
524 </refsection>\r
525 </refentry>\r
526 \r
527 <refentry version="5.0" xml:id="callouts.extension">\r
528 <refmeta>\r
529 <refentrytitle>callouts.extension</refentrytitle>\r
530 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
531 </refmeta>\r
532 <refnamediv>\r
533 <refname>callouts.extension</refname>\r
534 <refpurpose>Enable the callout extension</refpurpose>\r
535 </refnamediv>\r
536 \r
537 <refsynopsisdiv>\r
538 <programlisting xml:id="callouts.extension.frag">\r
539 &lt;xsl:param name="callouts.extension" select="1"&gt;&lt;/xsl:param&gt;\r
540 </programlisting>\r
541 </refsynopsisdiv>\r
542 \r
543 <refsection><info><title>Description</title></info>\r
544 \r
545 <para>The callouts extension processes <tag>areaset</tag>\r
546 elements in <tag>ProgramListingCO</tag> and other text-based\r
547 callout elements.\r
548 </para>\r
549 \r
550 </refsection>\r
551 </refentry>\r
552 \r
553 </reference>\r
554 <reference xml:id="toc_index"><title>ToC/LoT/Index Generation</title>\r
555 <refentry version="5.0" xml:id="autotoc.label.separator">\r
556 <refmeta>\r
557 <refentrytitle>autotoc.label.separator</refentrytitle>\r
558 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
559 </refmeta>\r
560 <refnamediv>\r
561 <refname>autotoc.label.separator</refname>\r
562 <refpurpose>Separator between labels and titles in the ToC</refpurpose>\r
563 </refnamediv>\r
564 \r
565 <refsynopsisdiv>\r
566 <programlisting xml:id="autotoc.label.separator.frag">\r
567 &lt;xsl:param name="autotoc.label.separator"&gt;. &lt;/xsl:param&gt;\r
568 </programlisting>\r
569 </refsynopsisdiv>\r
570 \r
571 <refsection><info><title>Description</title></info>\r
572 \r
573 <para>String used to separate labels and titles in a table of contents.</para>\r
574 \r
575 </refsection>\r
576 </refentry>\r
577 \r
578 <refentry version="5.0" xml:id="process.empty.source.toc">\r
579 <refmeta>\r
580 <refentrytitle>process.empty.source.toc</refentrytitle>\r
581 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
582 </refmeta>\r
583 <refnamediv>\r
584 <refname>process.empty.source.toc</refname>\r
585 <refpurpose>Generate automated TOC if <tag>toc</tag> element occurs in a source document?</refpurpose>\r
586 </refnamediv>\r
587 \r
588 <refsynopsisdiv>\r
589 <programlisting xml:id="process.empty.source.toc.frag">&lt;xsl:param name="process.empty.source.toc" select="0"&gt;&lt;/xsl:param&gt;</programlisting>\r
590 </refsynopsisdiv>\r
591 \r
592 <refsection><info><title>Description</title></info>\r
593 \r
594 <para>Specifies that if an empty <tag>toc</tag> element is found in a\r
595 source document, an automated TOC is generated at this point in the\r
596 document.\r
597 <note>\r
598   <para>Depending on what the value of the\r
599   <parameter>generate.toc</parameter> parameter is, setting this\r
600   parameter to <literal>1</literal> could result in generation of\r
601   duplicate automated TOCs. So the\r
602   <parameter>process.empty.source.toc</parameter> is primarily useful\r
603   as an "override": by placing an empty <tag>toc</tag> in your\r
604   document and setting this parameter to <literal>1</literal>, you can\r
605   force a TOC to be generated even if <tag>generate.toc</tag>\r
606   says not to.</para>\r
607 </note>\r
608 </para>\r
609 \r
610 </refsection>\r
611 </refentry>\r
612 \r
613 <refentry version="5.0" xml:id="process.source.toc">\r
614 <refmeta>\r
615 <refentrytitle>process.source.toc</refentrytitle>\r
616 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
617 </refmeta>\r
618 <refnamediv>\r
619 <refname>process.source.toc</refname>\r
620 <refpurpose>Process a non-empty <tag>toc</tag> element if it occurs in a source document?</refpurpose>\r
621 </refnamediv>\r
622 \r
623 <refsynopsisdiv>\r
624 <programlisting xml:id="process.source.toc.frag">&lt;xsl:param name="process.source.toc" select="0"&gt;&lt;/xsl:param&gt;</programlisting>\r
625 </refsynopsisdiv>\r
626 \r
627 <refsection><info><title>Description</title></info>\r
628 \r
629 <para>Specifies that the contents of a non-empty "hard-coded"\r
630 <tag>toc</tag> element in a source document are processed to\r
631 generate a TOC in output.\r
632 <note>\r
633   <para>This parameter has no effect on automated generation of\r
634   TOCs. An automated TOC may still be generated along with the\r
635   "hard-coded" TOC. To suppress automated TOC generation, adjust the\r
636   value of the <parameter>generate.toc</parameter> paramameter.</para>\r
637 \r
638   <para>The <tag>process.source.toc</tag> parameter also has\r
639   no effect if the <tag>toc</tag> element is empty; handling\r
640   for empty <tag>toc</tag> is controlled by the\r
641   <parameter>process.empty.source.toc</parameter> parameter.</para>\r
642 </note>\r
643 </para>\r
644 \r
645 </refsection>\r
646 </refentry>\r
647 \r
648 <refentry version="5.0" xml:id="generate.toc">\r
649 <refmeta>\r
650 <refentrytitle>generate.toc</refentrytitle>\r
651 <refmiscinfo class="other" otherclass="datatype">table</refmiscinfo>\r
652 </refmeta>\r
653 <refnamediv>\r
654 <refname>generate.toc</refname>\r
655 <refpurpose>Control generation of ToCs and LoTs</refpurpose>\r
656 </refnamediv>\r
657 \r
658 <refsynopsisdiv>\r
659 <programlisting xml:id="generate.toc.frag">\r
660 \r
661 &lt;xsl:param name="generate.toc"&gt;\r
662 /appendix toc,title\r
663 article/appendix  nop\r
664 /article  toc,title\r
665 book      toc,title,figure,table,example,equation\r
666 /chapter  toc,title\r
667 part      toc,title\r
668 /preface  toc,title\r
669 reference toc,title\r
670 /sect1    toc\r
671 /sect2    toc\r
672 /sect3    toc\r
673 /sect4    toc\r
674 /sect5    toc\r
675 /section  toc\r
676 set       toc,title\r
677 &lt;/xsl:param&gt;\r
678 </programlisting>\r
679 </refsynopsisdiv>\r
680 \r
681 <refsection><info><title>Description</title></info>\r
682 \r
683 <para>This parameter has a structured value. It is a table of space-delimited\r
684 path/value pairs. Each path identifies some element in the source document\r
685 using a restricted subset of XPath (only the implicit child axis, no wildcards,\r
686 no predicates). Paths can be either relative or absolute.</para>\r
687 \r
688 <para>When processing a particular element, the stylesheets consult this table to\r
689 determine if a ToC (or LoT(s)) should be generated.</para>\r
690 \r
691 <para>For example, consider the entry:</para>\r
692 \r
693 <screen>book toc,figure</screen>\r
694 \r
695 <para>This indicates that whenever a <tag>book</tag> is formatted, a\r
696 Table Of Contents and a List of Figures should be generated. Similarly,</para>\r
697 \r
698 <screen>/chapter toc</screen>\r
699 \r
700 <para>indicates that whenever a document <emphasis>that has a root\r
701 of</emphasis> <tag>chapter</tag> is formatted, a Table of\r
702 Contents should be generated. The entry <literal>chapter</literal> would match\r
703 all chapters, but <literal>/chapter</literal> matches only <tag>chapter</tag>\r
704 document elements.</para>\r
705 \r
706 <para>Generally, the longest match wins. So, for example, if you want to distinguish\r
707 articles in books from articles in parts, you could use these two entries:</para>\r
708 \r
709 <screen>book/article toc,figure\r
710 part/article toc</screen>\r
711 \r
712 <para>Note that an article in a part can never match a <literal>book/article</literal>,\r
713 so if you want nothing to be generated for articles in parts, you can simply leave\r
714 that rule out.</para>\r
715 \r
716 <para>If you want to leave the rule in, to make it explicit that you're turning\r
717 something off, use the value <quote>nop</quote>. For example, the following\r
718 entry disables ToCs and LoTs for articles:</para>\r
719 \r
720 <screen>article nop</screen>\r
721 \r
722 <para>Do not simply leave the word <quote>article</quote> in the file\r
723 without a matching value. That'd be just begging the silly little\r
724 path/value parser to get confused.</para>\r
725 \r
726 <para>Section ToCs are further controlled by the\r
727 <parameter>generate.section.toc.level</parameter> parameter.\r
728 For a given section level to have a ToC, it must have both an entry in \r
729 <parameter>generate.toc</parameter> and be within the range enabled by\r
730 <parameter>generate.section.toc.level</parameter>.</para>\r
731 </refsection>\r
732 </refentry>\r
733 \r
734 <refentry version="5.0" xml:id="generate.index">\r
735 <refmeta>\r
736 <refentrytitle>generate.index</refentrytitle>\r
737 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
738 </refmeta>\r
739 <refnamediv>\r
740 <refname>generate.index</refname>\r
741 <refpurpose>Do you want an index?</refpurpose>\r
742 </refnamediv>\r
743 \r
744 <refsynopsisdiv>\r
745 <programlisting xml:id="generate.index.frag">&lt;xsl:param name="generate.index" select="1"&gt;&lt;/xsl:param&gt;</programlisting>\r
746 </refsynopsisdiv>\r
747 \r
748 <refsection><info><title>Description</title></info>\r
749 \r
750 <para>Specify if an index should be generated. </para>\r
751 \r
752 </refsection>\r
753 </refentry>\r
754 \r
755 <refentry version="5.0" xml:id="make.index.markup">\r
756 <refmeta>\r
757 <refentrytitle>make.index.markup</refentrytitle>\r
758 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
759 </refmeta>\r
760 <refnamediv>\r
761 <refname>make.index.markup</refname>\r
762 <refpurpose>Generate XML index markup in the index?</refpurpose>\r
763 </refnamediv>\r
764 \r
765 <refsynopsisdiv>\r
766 <programlisting xml:id="make.index.markup.frag">\r
767 &lt;xsl:param name="make.index.markup" select="0"&gt;&lt;/xsl:param&gt;\r
768 </programlisting>\r
769 </refsynopsisdiv>\r
770 \r
771 <refsection><info><title>Description</title></info>\r
772 \r
773 <para>This parameter enables a very neat trick for getting properly\r
774 merged, collated back-of-the-book indexes. G. Ken Holman suggested\r
775 this trick at Extreme Markup Languages 2002 and I'm indebted to him\r
776 for it.</para>\r
777 \r
778 <para>Jeni Tennison's excellent code in\r
779 <filename>autoidx.xsl</filename> does a great job of merging and\r
780 sorting <tag>indexterm</tag>s in the document and building a\r
781 back-of-the-book index. However, there's one thing that it cannot\r
782 reasonably be expected to do: merge page numbers into ranges. (I would\r
783 not have thought that it could collate and suppress duplicate page\r
784 numbers, but in fact it appears to manage that task somehow.)</para>\r
785 \r
786 <para>Ken's trick is to produce a document in which the index at the\r
787 back of the book is <quote>displayed</quote> in XML. Because the index\r
788 is generated by the FO processor, all of the page numbers have been resolved.\r
789 It's a bit hard to explain, but what it boils down to is that instead of having\r
790 an index at the back of the book that looks like this:</para>\r
791 \r
792 <blockquote>\r
793 <formalpara><info><title>A</title></info>\r
794 <para>ap1, 1, 2, 3</para>\r
795 </formalpara>\r
796 </blockquote>\r
797 \r
798 <para>you get one that looks like this:</para>\r
799 \r
800 <blockquote>\r
801 <programlisting>&lt;indexdiv&gt;A&lt;/indexdiv&gt;\r
802 &lt;indexentry&gt;\r
803 &lt;primaryie&gt;ap1&lt;/primaryie&gt;,\r
804 &lt;phrase role="pageno"&gt;1&lt;/phrase&gt;,\r
805 &lt;phrase role="pageno"&gt;2&lt;/phrase&gt;,\r
806 &lt;phrase role="pageno"&gt;3&lt;/phrase&gt;\r
807 &lt;/indexentry&gt;</programlisting>\r
808 </blockquote>\r
809 \r
810 <para>After building a PDF file with this sort of odd-looking index, you can\r
811 extract the text from the PDF file and the result is a proper index expressed in\r
812 XML.</para>\r
813 \r
814 <para>Now you have data that's amenable to processing and a simple Perl script\r
815 (such as <filename>fo/pdf2index</filename>) can\r
816 merge page ranges and generate a proper index.</para>\r
817 \r
818 <para>Finally, reformat your original document using this literal index instead of\r
819 an automatically generated one and <quote>bingo</quote>!</para>\r
820 \r
821 </refsection>\r
822 </refentry>\r
823 \r
824 <refentry version="5.0" xml:id="index.method">\r
825 <refmeta>\r
826 <refentrytitle>index.method</refentrytitle>\r
827 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>\r
828 <refmiscinfo class="other" otherclass="value">basic</refmiscinfo>\r
829 <refmiscinfo class="other" otherclass="value">kosek</refmiscinfo>\r
830 <refmiscinfo class="other" otherclass="value">kimber</refmiscinfo>\r
831 </refmeta>\r
832 <refnamediv>\r
833 <refname>index.method</refname>\r
834 <refpurpose>Select method used to group index entries in an index</refpurpose>\r
835 </refnamediv>\r
836 \r
837 <refsynopsisdiv>\r
838 <programlisting xml:id="index.method.frag">\r
839 &lt;xsl:param name="index.method"&gt;basic&lt;/xsl:param&gt;\r
840 </programlisting>\r
841 </refsynopsisdiv>\r
842 \r
843 <refsection><info><title>Description</title></info>\r
844 \r
845 <para>This parameter lets you select which method to use for sorting and grouping\r
846  index entries in an index.\r
847 Indexes in Latin-based languages that have accented characters typically\r
848 sort together accented words and unaccented words.\r
849 Thus <quote>&#193;</quote> (U+00C1 LATIN CAPITAL LETTER A WITH ACUTE) would sort together\r
850 with <quote>A</quote> (U+0041 LATIN CAPITAL LETTER A), so both would appear in the <quote>A</quote>\r
851 section of the index.\r
852 Languages using other alphabets (such as Russian,  which is written in the Cyrillic alphabet)\r
853 and languages using ideographic chararacters (such as Japanese)\r
854 require grouping specific to the languages and alphabets.\r
855 </para>\r
856 \r
857 <para>The default indexing method is limited.\r
858 It can group accented characters in Latin-based languages only.\r
859 It cannot handle non-Latin alphabets or ideographic languages.\r
860 The other indexing methods require extensions of one type or\r
861 another, and do not work with\r
862 all XSLT processors, which is why they are not used by default.</para>\r
863 \r
864 <para>The three choices for indexing method are:</para>\r
865 <variablelist>\r
866 <varlistentry>\r
867 <term><literal>basic</literal></term>\r
868 <listitem>\r
869 <para>\r
870 (default)  Sort and groups words based only on the Latin alphabet.\r
871 Words with accented Latin letters will group and sort with\r
872 their respective primary letter, but\r
873 words in non-Latin alphabets will be\r
874 put in the <quote>Symbols</quote> section of the index.\r
875 </para>\r
876 </listitem>\r
877 </varlistentry>\r
878 <varlistentry>\r
879 <term><literal>kosek</literal></term>\r
880 <listitem>\r
881 <para>\r
882 This method sorts and groups words based on letter groups configured in\r
883 the DocBook locale file for the given language.\r
884 See, for example, the French locale file <filename>common/fr.xml</filename>.\r
885 This method requires that the XSLT processor\r
886 supports the EXSLT extensions (most do).\r
887 It also requires support for using \r
888 user-defined functions in xsl:key (xsltproc does not).\r
889 </para>\r
890 <para>This method is suitable for any language for which you can\r
891 list all the individual characters that should appear\r
892 in each letter group in an index.\r
893 It is probably not practical to use it for ideographic languages\r
894 such as Chinese that have hundreds or thousands of characters.\r
895 </para>\r
896 \r
897 <para>To use the kosek method, you must:</para>\r
898 \r
899 <orderedlist>\r
900 <listitem>\r
901 <para>Use a processor that supports its extensions, such as\r
902 Saxon 6 or Xalan (xsltproc and Saxon 8 do not).\r
903 </para>\r
904 </listitem>\r
905 <listitem>\r
906 <para>Set the index.method parameter's value to <quote>kosek</quote>.\r
907 </para>\r
908 </listitem>\r
909 <listitem>\r
910 <para>Import the appropriate index extensions stylesheet module\r
911 <filename>fo/autoidx-kosek.xsl</filename> or \r
912 <filename>html/autoidx-kosek.xsl</filename> into your\r
913 customization.\r
914 </para>\r
915 </listitem>\r
916 </orderedlist>\r
917 \r
918 </listitem>\r
919 </varlistentry>\r
920 <varlistentry>\r
921 <term><literal>kimber</literal></term>\r
922 <listitem>\r
923 <para>\r
924 This method uses extensions to the Saxon processor to implement\r
925 sophisticated indexing processes. It uses its own \r
926 configuration file, which can include information for any number of\r
927 languages. Each language's configuration can group\r
928 words using one of two processes. In the\r
929 enumerated process similar to that used in the kosek method,\r
930 you indicate the groupings character-by-character.\r
931 In the between-key process, you specify the\r
932 break-points in the sort order that should start a new group.\r
933 The latter configuration is useful for ideographic languages\r
934 such as Chinese, Japanese, and Korean.\r
935 You can also define your own collation algorithms and how you\r
936 want mixed Latin-alphabet words sorted.</para>\r
937 <itemizedlist>\r
938 <listitem>\r
939 <para>For a whitepaper describing the extensions, see:\r
940 <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.innodata-isogen.com/knowledge_center/white_papers/back_of_book_for_xsl_fo.pdf">http://www.innodata-isogen.com/knowledge_center/white_papers/back_of_book_for_xsl_fo.pdf</link>.\r
941 </para>\r
942 </listitem>\r
943 <listitem>\r
944 <para>To download the extension library, see\r
945 <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.innodata-isogen.com/knowledge_center/tools_downloads/i18nsupport">http://www.innodata-isogen.com/knowledge_center/tools_downloads/i18nsupport</link>.\r
946 </para>\r
947 </listitem>\r
948 </itemizedlist>\r
949 \r
950 <para>To use the kimber method, you must:</para>\r
951 \r
952 <orderedlist>\r
953 <listitem>\r
954 <para>Use Saxon (version 6 or 8) as your XSLT processor.\r
955 </para>\r
956 </listitem>\r
957 <listitem>\r
958 <para>Install and configure the Innodata Isogen library, using\r
959 the documentation that comes with it.\r
960 </para>\r
961 </listitem>\r
962 <listitem>\r
963 <para>Set the index.method parameter's value to <quote>kimber</quote>.\r
964 </para>\r
965 </listitem>\r
966 <listitem>\r
967 <para>Import the appropriate index extensions stylesheet module\r
968 <filename>fo/autoidx-kimber.xsl</filename> or \r
969 <filename>html/autoidx-kimber.xsl</filename> into your\r
970 customization.\r
971 </para>\r
972 </listitem>\r
973 </orderedlist>\r
974 \r
975 </listitem>\r
976 </varlistentry>\r
977 </variablelist>\r
978 \r
979 </refsection>\r
980 </refentry>\r
981 \r
982 <refentry version="5.0" xml:id="index.on.type">\r
983 <refmeta>\r
984 <refentrytitle>index.on.type</refentrytitle>\r
985 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
986 </refmeta>\r
987 <refnamediv>\r
988 <refname>index.on.type</refname>\r
989 <refpurpose>Select indexterms based on <tag class="attribute">type</tag>\r
990 attribute value</refpurpose>\r
991 </refnamediv>\r
992 \r
993 <refsynopsisdiv>\r
994 <programlisting xml:id="index.on.type.frag">\r
995 &lt;xsl:param name="index.on.type" select="0"&gt;&lt;/xsl:param&gt;\r
996 </programlisting>\r
997 </refsynopsisdiv>\r
998 \r
999 <refsection><info><title>Description</title></info>\r
1000 \r
1001 <para>\r
1002 If non-zero, \r
1003 then an <tag>index</tag> element that has a\r
1004 <tag class="attribute">type</tag> attribute\r
1005 value will contain only those <tag>indexterm</tag>\r
1006 elements with a matching <tag class="attribute">type</tag> attribute value.\r
1007 If an <tag>index</tag> has no <tag class="attribute">type</tag>\r
1008 attribute or it is blank, then the index will contain\r
1009 all <tag>indexterm</tag>s in the current scope.\r
1010 </para>\r
1011 \r
1012 <para>\r
1013 If <literal>index.on.type</literal> is zero, then the\r
1014 <tag class="attribute">type</tag> attribute has no effect\r
1015 on selecting indexterms for an index.\r
1016 </para>\r
1017 \r
1018 <para>For those using DocBook version 4.2 or earlier,\r
1019 the <tag class="attribute">type</tag> attribute is not available\r
1020 for index terms.  However, you can achieve the same\r
1021 effect by using the <tag class="attribute">role</tag> attribute\r
1022 in the same manner on <tag>indexterm</tag>\r
1023 and <tag>index</tag>, and setting the stylesheet parameter \r
1024 <parameter>index.on.role</parameter> to a nonzero value.\r
1025 </para>\r
1026 \r
1027 </refsection>\r
1028 </refentry>\r
1029 \r
1030 <refentry version="5.0" xml:id="index.on.role">\r
1031 <refmeta>\r
1032 <refentrytitle>index.on.role</refentrytitle>\r
1033 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
1034 </refmeta>\r
1035 <refnamediv>\r
1036 <refname>index.on.role</refname>\r
1037 <refpurpose>Select indexterms based on <tag class="attribute">role</tag> value</refpurpose>\r
1038 </refnamediv>\r
1039 \r
1040 <refsynopsisdiv>\r
1041 <programlisting xml:id="index.on.role.frag">\r
1042 &lt;xsl:param name="index.on.role" select="0"&gt;&lt;/xsl:param&gt;\r
1043 </programlisting>\r
1044 </refsynopsisdiv>\r
1045 \r
1046 <refsection><info><title>Description</title></info>\r
1047 \r
1048 <para>\r
1049 If non-zero, \r
1050 then an <tag>index</tag> element that has a\r
1051 <tag class="attribute">role</tag> attribute\r
1052 value will contain only those <tag>indexterm</tag>\r
1053 elements with a matching role value.\r
1054 If an <tag>index</tag> has no <tag class="attribute">role</tag>\r
1055 attribute or it is blank, then the index will contain\r
1056 all <tag>indexterm</tag>s in the current scope.\r
1057 </para>\r
1058 <para>\r
1059 If <literal>index.on.role</literal> is zero, then the\r
1060 <tag class="attribute">role</tag> attribute has no effect\r
1061 on selecting indexterms for an index.\r
1062 </para>\r
1063 \r
1064 <para>If you are using DocBook version 4.3 or later, you should\r
1065 use the <tag class="attribute">type</tag> attribute instead of <tag class="attribute">role</tag>\r
1066 on <tag>indexterm</tag> and <tag>index</tag>,\r
1067 and set the <parameter>index.on.type</parameter> to a nonzero\r
1068 value.\r
1069 </para>\r
1070 \r
1071 </refsection>\r
1072 </refentry>\r
1073 \r
1074 <refentry version="5.0" xml:id="index.preferred.page.properties">\r
1075 <refmeta>\r
1076 <refentrytitle>index.preferred.page.properties</refentrytitle>\r
1077 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
1078 </refmeta>\r
1079 <refnamediv>\r
1080 <refname>index.preferred.page.properties</refname>\r
1081 <refpurpose>Properties used to emphasize page number references for\r
1082 significant index terms</refpurpose>\r
1083 </refnamediv>\r
1084 \r
1085 <refsynopsisdiv>\r
1086 <programlisting xml:id="index.preferred.page.properties.frag">\r
1087 &lt;xsl:attribute-set name="index.preferred.page.properties"&gt;\r
1088   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;\r
1089 &lt;/xsl:attribute-set&gt;\r
1090 </programlisting>\r
1091 </refsynopsisdiv>\r
1092 \r
1093 <refsection><info><title>Description</title></info>\r
1094 \r
1095 <para>Properties used to emphasize page number references for\r
1096 significant index terms (<tag class="attribute">significance</tag>=<tag class="attvalue">preferred</tag>). Currently works only with\r
1097 XEP.</para>\r
1098 \r
1099 </refsection>\r
1100 </refentry>\r
1101 \r
1102 <refentry version="5.0" xml:id="index.entry.properties">\r
1103 <refmeta>\r
1104 <refentrytitle>index.entry.properties</refentrytitle>\r
1105 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
1106 </refmeta>\r
1107 <refnamediv>\r
1108 <refname>index.entry.properties</refname>\r
1109 <refpurpose>Properties applied to the formatted entries\r
1110 in an index</refpurpose>\r
1111 </refnamediv>\r
1112 \r
1113 <refsynopsisdiv>\r
1114 <programlisting xml:id="index.entry.properties.frag">\r
1115 &lt;xsl:attribute-set name="index.entry.properties"&gt;\r
1116   &lt;xsl:attribute name="start-indent"&gt;0pt&lt;/xsl:attribute&gt;\r
1117 &lt;/xsl:attribute-set&gt;\r
1118 </programlisting>\r
1119 </refsynopsisdiv>\r
1120 \r
1121 <refsection><info><title>Description</title></info>\r
1122 \r
1123 <para>This attribute set is applied to the block containing\r
1124 the entries in a letter division in an index.  It can be used to set the\r
1125 font-size, font-family, and other inheritable properties that will be\r
1126 applied to all index entries.</para>\r
1127 \r
1128 </refsection>\r
1129 </refentry>\r
1130 \r
1131 <refentry version="5.0" xml:id="index.div.title.properties">\r
1132 <refmeta>\r
1133 <refentrytitle>index.div.title.properties</refentrytitle>\r
1134 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
1135 </refmeta>\r
1136 <refnamediv>\r
1137 <refname>index.div.title.properties</refname>\r
1138 <refpurpose>Properties associated with the letter headings in an\r
1139 index</refpurpose>\r
1140 </refnamediv>\r
1141 \r
1142 <refsynopsisdiv>\r
1143 <programlisting xml:id="index.div.title.properties.frag">\r
1144 &lt;xsl:attribute-set name="index.div.title.properties"&gt;\r
1145   &lt;xsl:attribute name="margin-{$direction.align.start}"&gt;0pt&lt;/xsl:attribute&gt;\r
1146   &lt;xsl:attribute name="font-size"&gt;14.4pt&lt;/xsl:attribute&gt;\r
1147   &lt;xsl:attribute name="font-family"&gt;&lt;xsl:value-of select="$title.fontset"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;\r
1148   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;\r
1149   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;\r
1150   &lt;xsl:attribute name="space-before.optimum"&gt;&lt;xsl:value-of select="concat($body.font.master,'pt')"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;\r
1151   &lt;xsl:attribute name="space-before.minimum"&gt;&lt;xsl:value-of select="concat($body.font.master,'pt * 0.8')"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;\r
1152   &lt;xsl:attribute name="space-before.maximum"&gt;&lt;xsl:value-of select="concat($body.font.master,'pt * 1.2')"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;\r
1153   &lt;xsl:attribute name="start-indent"&gt;0pt&lt;/xsl:attribute&gt;\r
1154 &lt;/xsl:attribute-set&gt;\r
1155 </programlisting>\r
1156 </refsynopsisdiv>\r
1157 \r
1158 <refsection><info><title>Description</title></info>\r
1159 \r
1160 <para>This attribute set is used on the letter headings that separate\r
1161 the divisions in an index.</para>\r
1162 \r
1163 </refsection>\r
1164 </refentry>\r
1165 \r
1166 <refentry version="5.0" xml:id="index.number.separator">\r
1167 <refmeta>\r
1168 <refentrytitle>index.number.separator</refentrytitle>\r
1169 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
1170 </refmeta>\r
1171 <refnamediv>\r
1172 <refname>index.number.separator</refname>\r
1173 <refpurpose>Override for punctuation separating page numbers in index</refpurpose>\r
1174 </refnamediv>\r
1175 \r
1176 <refsynopsisdiv>\r
1177 <programlisting xml:id="index.number.separator.frag">\r
1178 &lt;xsl:param name="index.number.separator"&gt;&lt;/xsl:param&gt;\r
1179 </programlisting>\r
1180 </refsynopsisdiv>\r
1181 \r
1182 <refsection><info><title>Description</title></info>\r
1183 \r
1184 <para>This parameter permits you to override the text to insert between\r
1185 page references in a formatted index entry.  Typically \r
1186 that would be a comma and a space.\r
1187 </para>\r
1188 \r
1189 <para>Because this text may be locale dependent,\r
1190 this parameter's value is normally taken from a gentext\r
1191 template named 'number-separator' in the\r
1192 context 'index' in the stylesheet\r
1193 locale file for the language\r
1194 of the current document.\r
1195 This parameter can be used to override the gentext string,\r
1196 and would typically be used on the command line.\r
1197 This parameter would apply to all languages.\r
1198 </para>\r
1199 \r
1200 <para>So this text string can be customized in two ways.\r
1201 You can reset the default gentext string using\r
1202 the <parameter>local.l10n.xml</parameter> parameter, or you can\r
1203 override the gentext with the content of this parameter.\r
1204 The content can be a simple string, or it can be\r
1205 something more complex such as a call-template.\r
1206 </para>\r
1207 \r
1208 <para>In HTML index output, section title references are used instead of\r
1209 page number references.  This punctuation appears between\r
1210 such section titles in an HTML index.\r
1211 </para>\r
1212 \r
1213 </refsection>\r
1214 </refentry>\r
1215 \r
1216 <refentry version="5.0" xml:id="index.range.separator">\r
1217 <refmeta>\r
1218 <refentrytitle>index.range.separator</refentrytitle>\r
1219 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
1220 </refmeta>\r
1221 <refnamediv>\r
1222 <refname>index.range.separator</refname>\r
1223 <refpurpose>Override for punctuation separating the two numbers\r
1224 in a page range in index</refpurpose>\r
1225 </refnamediv>\r
1226 \r
1227 <refsynopsisdiv>\r
1228 <programlisting xml:id="index.range.separator.frag">\r
1229 &lt;xsl:param name="index.range.separator"&gt;&lt;/xsl:param&gt;\r
1230 </programlisting>\r
1231 </refsynopsisdiv>\r
1232 \r
1233 <refsection><info><title>Description</title></info>\r
1234 \r
1235 <para>This parameter permits you\r
1236 to override the text to insert between\r
1237 the two numbers of a page range in an index.\r
1238 This parameter is only used by those XSL-FO processors\r
1239 that support an extension for generating such page ranges\r
1240 (such as XEP).</para>\r
1241 \r
1242 <para>Because this text may be locale dependent,\r
1243 this parameter's value is normally taken from a gentext\r
1244 template named 'range-separator' in the\r
1245 context 'index' in the stylesheet\r
1246 locale file for the language\r
1247 of the current document.\r
1248 This parameter can be used to override the gentext string,\r
1249 and would typically be used on the command line.\r
1250 This parameter would apply to all languages.\r
1251 </para>\r
1252 \r
1253 <para>So this text string can be customized in two ways.\r
1254 You can reset the default gentext string using\r
1255 the <parameter>local.l10n.xml</parameter> parameter, or you can\r
1256 override the gentext with the content of this parameter.\r
1257 The content can be a simple string, or it can be\r
1258 something more complex such as a call-template.\r
1259 </para>\r
1260 \r
1261 <para>In HTML index output, section title references are used instead of\r
1262 page number references. So there are no page ranges\r
1263 and this parameter has no effect.\r
1264 </para>\r
1265 \r
1266 </refsection>\r
1267 </refentry>\r
1268 \r
1269 <refentry version="5.0" xml:id="index.term.separator">\r
1270 <refmeta>\r
1271 <refentrytitle>index.term.separator</refentrytitle>\r
1272 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
1273 </refmeta>\r
1274 <refnamediv>\r
1275 <refname>index.term.separator</refname>\r
1276 <refpurpose>Override for punctuation separating an index term \r
1277 from its list of page references in an index</refpurpose>\r
1278 </refnamediv>\r
1279 \r
1280 <refsynopsisdiv>\r
1281 <programlisting xml:id="index.term.separator.frag">\r
1282 &lt;xsl:param name="index.term.separator"&gt;&lt;/xsl:param&gt;\r
1283 </programlisting>\r
1284 </refsynopsisdiv>\r
1285 \r
1286 <refsection><info><title>Description</title></info>\r
1287 \r
1288 <para>This parameter permits you to override\r
1289 the text to insert between\r
1290 the end of an index term and its list of page references.\r
1291 Typically that might be a comma and a space.\r
1292 </para>\r
1293 \r
1294 <para>Because this text may be locale dependent,\r
1295 this parameter's value is normally taken from a gentext\r
1296 template named 'term-separator' in the\r
1297 context 'index' in the stylesheet\r
1298 locale file for the language\r
1299 of the current document.\r
1300 This parameter can be used to override the gentext string,\r
1301 and would typically be used on the command line.\r
1302 This parameter would apply to all languages.\r
1303 </para>\r
1304 \r
1305 <para>So this text string can be customized in two ways.\r
1306 You can reset the default gentext string using\r
1307 the <parameter>local.l10n.xml</parameter> parameter, or you can\r
1308 fill in the content for this normally empty \r
1309 override parameter.\r
1310 The content can be a simple string, or it can be\r
1311 something more complex such as a call-template.\r
1312 For fo output, it could be an <tag>fo:leader</tag>\r
1313 element to provide space of a specific length, or a dot leader.\r
1314 </para>\r
1315 \r
1316 </refsection>\r
1317 </refentry>\r
1318 \r
1319 <refentry version="5.0" xml:id="xep.index.item.properties">\r
1320 <refmeta>\r
1321 <refentrytitle>xep.index.item.properties</refentrytitle>\r
1322 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
1323 </refmeta>\r
1324 <refnamediv>\r
1325 <refname>xep.index.item.properties</refname>\r
1326 <refpurpose>Properties associated with XEP index-items</refpurpose>\r
1327 </refnamediv>\r
1328 \r
1329 <refsynopsisdiv>\r
1330 <programlisting xml:id="xep.index.item.properties.frag">\r
1331 &lt;xsl:attribute-set name="xep.index.item.properties" use-attribute-sets="index.page.number.properties"&gt;\r
1332   &lt;xsl:attribute name="merge-subsequent-page-numbers"&gt;true&lt;/xsl:attribute&gt;\r
1333   &lt;xsl:attribute name="link-back"&gt;true&lt;/xsl:attribute&gt;\r
1334 &lt;/xsl:attribute-set&gt;\r
1335 </programlisting>\r
1336 </refsynopsisdiv>\r
1337 \r
1338 <refsection><info><title>Description</title></info>\r
1339 \r
1340 <para>Properties associated with XEP index-items, which generate\r
1341 page numbers in an index processed by XEP. For more info see\r
1342 the XEP documentation section "Indexes" in\r
1343 <uri xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.renderx.com/reference.html#Indexes">http://www.renderx.com/reference.html#Indexes</uri>.</para>\r
1344 \r
1345 <para>This attribute-set also adds by default any properties from the\r
1346 <tag class="attribute">index.page.number.properties</tag>\r
1347 attribute-set.</para>\r
1348 </refsection>\r
1349 </refentry>\r
1350 \r
1351 <refentry version="5.0" xml:id="toc.section.depth">\r
1352 <refmeta>\r
1353 <refentrytitle>toc.section.depth</refentrytitle>\r
1354 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>\r
1355 </refmeta>\r
1356 <refnamediv>\r
1357 <refname>toc.section.depth</refname>\r
1358 <refpurpose>How deep should recursive <tag>section</tag>s appear\r
1359 in the TOC?</refpurpose>\r
1360 </refnamediv>\r
1361 \r
1362 <refsynopsisdiv>\r
1363 <programlisting xml:id="toc.section.depth.frag">&lt;xsl:param name="toc.section.depth"&gt;2&lt;/xsl:param&gt;</programlisting>\r
1364 </refsynopsisdiv>\r
1365 \r
1366 <refsection><info><title>Description</title></info>\r
1367 \r
1368 <para>Specifies the depth to which recursive sections should appear in the\r
1369 TOC.\r
1370 </para>\r
1371 \r
1372 </refsection>\r
1373 </refentry>\r
1374 \r
1375 <refentry version="5.0" xml:id="toc.max.depth">\r
1376 <refmeta>\r
1377 <refentrytitle>toc.max.depth</refentrytitle>\r
1378 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>\r
1379 </refmeta>\r
1380 <refnamediv>\r
1381 <refname>toc.max.depth</refname>\r
1382 <refpurpose>How many levels should be created for each TOC?</refpurpose>\r
1383 </refnamediv>\r
1384 \r
1385 <refsynopsisdiv>\r
1386 <programlisting xml:id="toc.max.depth.frag">&lt;xsl:param name="toc.max.depth"&gt;8&lt;/xsl:param&gt;</programlisting>\r
1387 </refsynopsisdiv>\r
1388 \r
1389 <refsection><info><title>Description</title></info>\r
1390 \r
1391 <para>Specifies the maximal depth of TOC on all levels.</para>\r
1392 \r
1393 </refsection>\r
1394 </refentry>\r
1395 \r
1396 <refentry version="5.0" xml:id="toc.indent.width">\r
1397 <refmeta>\r
1398 <refentrytitle>toc.indent.width</refentrytitle>\r
1399 <refmiscinfo class="other" otherclass="datatype">float</refmiscinfo>\r
1400 </refmeta>\r
1401 <refnamediv>\r
1402 <refname>toc.indent.width</refname>\r
1403 <refpurpose>Amount of indentation for TOC entries</refpurpose>\r
1404 </refnamediv>\r
1405 \r
1406 <refsynopsisdiv>\r
1407 <programlisting xml:id="toc.indent.width.frag">\r
1408 &lt;xsl:param name="toc.indent.width"&gt;24&lt;/xsl:param&gt;\r
1409 &lt;!-- inconsistant point specification? --&gt;\r
1410 </programlisting>\r
1411 </refsynopsisdiv>\r
1412 \r
1413 <refsection><info><title>Description</title></info>\r
1414 \r
1415 <para>Specifies, in points, the distance by which each level of the\r
1416 TOC is indented from its parent.</para>\r
1417 \r
1418 <para>This value is expressed in points, without\r
1419 a unit (in other words, it is a bare number). Using a bare number allows the stylesheet\r
1420 to perform calculations that would otherwise have to be performed by the FO processor\r
1421 because not all processors support expressions.</para>\r
1422 \r
1423 </refsection>\r
1424 </refentry>\r
1425 \r
1426 <refentry version="5.0" xml:id="toc.line.properties">\r
1427 <refmeta>\r
1428 <refentrytitle>toc.line.properties</refentrytitle>\r
1429 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
1430 </refmeta>\r
1431 <refnamediv>\r
1432 <refname>toc.line.properties</refname>\r
1433 <refpurpose>Properties for lines in ToC and LoTs</refpurpose>\r
1434 </refnamediv>\r
1435 \r
1436 <refsynopsisdiv>\r
1437 <programlisting xml:id="toc.line.properties.frag">\r
1438 &lt;xsl:attribute-set name="toc.line.properties"&gt;\r
1439   &lt;xsl:attribute name="text-align-last"&gt;justify&lt;/xsl:attribute&gt;\r
1440   &lt;xsl:attribute name="text-align"&gt;start&lt;/xsl:attribute&gt;\r
1441   &lt;xsl:attribute name="end-indent"&gt;&lt;xsl:value-of select="concat($toc.indent.width, 'pt')"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;\r
1442   &lt;xsl:attribute name="last-line-end-indent"&gt;&lt;xsl:value-of select="concat('-', $toc.indent.width, 'pt')"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;\r
1443 &lt;/xsl:attribute-set&gt;\r
1444 </programlisting>\r
1445 </refsynopsisdiv>\r
1446 \r
1447 <refsection><info><title>Description</title></info>\r
1448 \r
1449 <para>Properties which are applied to every line in ToC (or LoT). You can\r
1450 modify them in order to change appearance of all, or some lines. For\r
1451 example in order to make lines for chapters in bold specify the\r
1452 following in your customization layer.</para>\r
1453 \r
1454 <programlisting>&lt;xsl:attribute-set name="toc.line.properties"&gt;\r
1455   &lt;xsl:attribute name="font-weight"&gt;\r
1456     &lt;xsl:when test="self::chapter | self::preface | self::appendix"&gt;bold&lt;/xsl:when&gt;\r
1457     &lt;xsl:otherwise&gt;normal&lt;/xsl:otherwise&gt;\r
1458   &lt;/xsl:attribute&gt;\r
1459 &lt;/xsl:attribute-set&gt;</programlisting>\r
1460 \r
1461 </refsection>\r
1462 </refentry>\r
1463 \r
1464 <refentry version="5.0" xml:id="toc.margin.properties">\r
1465 <refmeta>\r
1466 <refentrytitle>toc.margin.properties</refentrytitle>\r
1467 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
1468 </refmeta>\r
1469 <refnamediv>\r
1470 <refname>toc.margin.properties</refname>\r
1471 <refpurpose>Margin properties used on Tables of Contents</refpurpose>\r
1472 </refnamediv>\r
1473 \r
1474 <refsynopsisdiv>\r
1475 <programlisting xml:id="toc.margin.properties.frag">\r
1476 &lt;xsl:attribute-set name="toc.margin.properties"&gt;\r
1477   &lt;xsl:attribute name="space-before.minimum"&gt;0.5em&lt;/xsl:attribute&gt;\r
1478   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;\r
1479   &lt;xsl:attribute name="space-before.maximum"&gt;2em&lt;/xsl:attribute&gt;\r
1480   &lt;xsl:attribute name="space-after.minimum"&gt;0.5em&lt;/xsl:attribute&gt;\r
1481   &lt;xsl:attribute name="space-after.optimum"&gt;1em&lt;/xsl:attribute&gt;\r
1482   &lt;xsl:attribute name="space-after.maximum"&gt;2em&lt;/xsl:attribute&gt;\r
1483 &lt;/xsl:attribute-set&gt;\r
1484 </programlisting>\r
1485 </refsynopsisdiv>\r
1486 \r
1487 <refsection><info><title>Description</title></info>\r
1488 <para>This attribute set is used on Tables of Contents. These attributes are set\r
1489 on the wrapper that surrounds the ToC block, not on each individual lines.</para>\r
1490 </refsection>\r
1491 </refentry>\r
1492 \r
1493 <refentry version="5.0" xml:id="bridgehead.in.toc">\r
1494 <refmeta>\r
1495 <refentrytitle>bridgehead.in.toc</refentrytitle>\r
1496 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
1497 </refmeta>\r
1498 <refnamediv>\r
1499 <refname>bridgehead.in.toc</refname>\r
1500 <refpurpose>Should bridgehead elements appear in the TOC?</refpurpose>\r
1501 </refnamediv>\r
1502 \r
1503 <refsynopsisdiv>\r
1504 <programlisting xml:id="bridgehead.in.toc.frag">&lt;xsl:param name="bridgehead.in.toc" select="0"&gt;&lt;/xsl:param&gt;</programlisting>\r
1505 </refsynopsisdiv>\r
1506 \r
1507 <refsection><info><title>Description</title></info>\r
1508 \r
1509 <para>If non-zero, <tag>bridgehead</tag>s appear in the TOC. Note that\r
1510 this option is not fully supported and may be removed in a future\r
1511 version of the stylesheets.\r
1512 </para>\r
1513 \r
1514 </refsection>\r
1515 </refentry>\r
1516 \r
1517 <refentry version="5.0" xml:id="simplesect.in.toc">\r
1518 <refmeta>\r
1519 <refentrytitle>simplesect.in.toc</refentrytitle>\r
1520 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
1521 </refmeta>\r
1522 <refnamediv>\r
1523 <refname>simplesect.in.toc</refname>\r
1524 <refpurpose>Should <tag>simplesect</tag> elements appear in the TOC?</refpurpose>\r
1525 </refnamediv>\r
1526 \r
1527 <refsynopsisdiv>\r
1528 <programlisting xml:id="simplesect.in.toc.frag">&lt;xsl:param name="simplesect.in.toc" select="0"&gt;&lt;/xsl:param&gt;</programlisting>\r
1529 </refsynopsisdiv>\r
1530 \r
1531 <refsection><info><title>Description</title></info>\r
1532 \r
1533 <para>If non-zero, <tag>simplesect</tag>s will be included in the TOC.\r
1534 </para>\r
1535 \r
1536 </refsection>\r
1537 </refentry>\r
1538 \r
1539 <refentry version="5.0" xml:id="generate.section.toc.level">\r
1540 <refmeta>\r
1541 <refentrytitle>generate.section.toc.level</refentrytitle>\r
1542 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>\r
1543 </refmeta>\r
1544 <refnamediv>\r
1545 <refname>generate.section.toc.level</refname>\r
1546 <refpurpose>Control depth of TOC generation in sections</refpurpose>\r
1547 </refnamediv>\r
1548 \r
1549 <refsynopsisdiv>\r
1550 <programlisting xml:id="generate.section.toc.level.frag">\r
1551 &lt;xsl:param name="generate.section.toc.level" select="0"&gt;&lt;/xsl:param&gt;\r
1552 </programlisting>\r
1553 </refsynopsisdiv>\r
1554 \r
1555 <refsection><info><title>Description</title></info>\r
1556 \r
1557 <para>The <parameter>generate.section.toc.level</parameter> parameter\r
1558 controls the depth of <tag>section</tag> in which TOCs will be generated. Note\r
1559 that this is related to, but not the same as\r
1560 <parameter>toc.section.depth</parameter>, which controls the depth to\r
1561 which TOC entries will be generated in a given TOC.</para>\r
1562 <para>If, for example, <parameter>generate.section.toc.level</parameter>\r
1563 is <literal>3</literal>, TOCs will be generated in first, second, and third\r
1564 level sections, but not in fourth level sections.\r
1565 </para>\r
1566 \r
1567 </refsection>\r
1568 </refentry>\r
1569 \r
1570 \r
1571 \r
1572 \r
1573 </reference>\r
1574 <reference xml:id="fo_ext"><title>Processor Extensions</title>\r
1575 <refentry version="5.0" xml:id="arbortext.extensions">\r
1576 <refmeta>\r
1577 <refentrytitle>arbortext.extensions</refentrytitle>\r
1578 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
1579 </refmeta>\r
1580 <refnamediv>\r
1581 <refname>arbortext.extensions</refname>\r
1582 <refpurpose>Enable Arbortext extensions?</refpurpose>\r
1583 </refnamediv>\r
1584 \r
1585 <refsynopsisdiv>\r
1586 <programlisting xml:id="arbortext.extensions.frag">&lt;xsl:param name="arbortext.extensions" select="0"&gt;&lt;/xsl:param&gt;</programlisting>\r
1587 </refsynopsisdiv>\r
1588 \r
1589 <refsection><info><title>Description</title></info>\r
1590 \r
1591 <para>If non-zero,\r
1592 <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.arbortext.com/">Arbortext</link>\r
1593 extensions will be used.\r
1594 </para>\r
1595 <para>This parameter can also affect which graphics file formats\r
1596 are supported</para>\r
1597 \r
1598 </refsection>\r
1599 </refentry>\r
1600 \r
1601 <refentry version="5.0" xml:id="axf.extensions">\r
1602 <refmeta>\r
1603 <refentrytitle>axf.extensions</refentrytitle>\r
1604 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
1605 </refmeta>\r
1606 <refnamediv>\r
1607 <refname>axf.extensions</refname>\r
1608 <refpurpose>Enable XSL Formatter extensions?</refpurpose>\r
1609 </refnamediv>\r
1610 \r
1611 <refsynopsisdiv>\r
1612 <programlisting xml:id="axf.extensions.frag">\r
1613 &lt;xsl:param name="axf.extensions" select="0"&gt;&lt;/xsl:param&gt;\r
1614 </programlisting>\r
1615 </refsynopsisdiv>\r
1616 \r
1617 <refsection><info><title>Description</title></info>\r
1618 \r
1619 <para>If non-zero,\r
1620 <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.antennahouse.com/">XSL Formatter</link>\r
1621 extensions will be used. XSL Formatter extensions consists of PDF bookmarks,\r
1622 document information and better index processing.</para>\r
1623 \r
1624 <para>This parameter can also affect which graphics file formats\r
1625 are supported</para>\r
1626 \r
1627 </refsection>\r
1628 </refentry>\r
1629 \r
1630 <refentry version="5.0" xml:id="fop.extensions">\r
1631 <refmeta>\r
1632 <refentrytitle>fop.extensions</refentrytitle>\r
1633 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
1634 </refmeta>\r
1635 <refnamediv>\r
1636 <refname>fop.extensions</refname>\r
1637 <refpurpose>Enable extensions for FOP version 0.20.5 and earlier</refpurpose>\r
1638 </refnamediv>\r
1639 \r
1640 <refsynopsisdiv>\r
1641 <programlisting xml:id="fop.extensions.frag">&lt;xsl:param name="fop.extensions" select="0"&gt;&lt;/xsl:param&gt;</programlisting>\r
1642 </refsynopsisdiv>\r
1643 \r
1644 <refsection><info><title>Description</title></info>\r
1645 \r
1646 <para>If non-zero, extensions intended for\r
1647 <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://xml.apache.org/fop/">FOP</link>\r
1648 version 0.20.5 and earlier will be used.\r
1649 At present, this consists of PDF bookmarks.\r
1650 </para>\r
1651 \r
1652 <para>This parameter can also affect which graphics file formats\r
1653 are supported.</para>\r
1654 \r
1655 <para>If you are using a version of FOP beyond\r
1656 version 0.20.5, then use the <parameter>fop1.extensions</parameter> parameter\r
1657 instead.\r
1658 </para>\r
1659 </refsection>\r
1660 </refentry>\r
1661 \r
1662 <refentry version="5.0" xml:id="fop1.extensions">\r
1663 <refmeta>\r
1664 <refentrytitle>fop1.extensions</refentrytitle>\r
1665 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
1666 </refmeta>\r
1667 <refnamediv>\r
1668 <refname>fop1.extensions</refname>\r
1669 <refpurpose>Enable extensions for FOP version 0.90 and later</refpurpose>\r
1670 </refnamediv>\r
1671 \r
1672 <refsynopsisdiv>\r
1673 <programlisting xml:id="fop1.extensions.frag">&lt;xsl:param name="fop1.extensions" select="0"&gt;&lt;/xsl:param&gt;</programlisting>\r
1674 </refsynopsisdiv>\r
1675 \r
1676 <refsection><info><title>Description</title></info>\r
1677 \r
1678 <para>If non-zero, extensions for \r
1679 <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://xml.apache.org/fop/">FOP</link>\r
1680 version 0.90 and later will be used.\r
1681 </para>\r
1682 \r
1683 <para>This parameter can also affect which graphics file formats\r
1684 are supported.</para>\r
1685 \r
1686 <para>The original <parameter>fop.extensions</parameter> parameter\r
1687 should still be used for FOP version 0.20.5 and earlier.\r
1688 </para>\r
1689 </refsection>\r
1690 </refentry>\r
1691 \r
1692 <refentry version="5.0" xml:id="passivetex.extensions">\r
1693 <refmeta>\r
1694 <refentrytitle>passivetex.extensions</refentrytitle>\r
1695 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
1696 </refmeta>\r
1697 <refnamediv>\r
1698 <refname>passivetex.extensions</refname>\r
1699 <refpurpose>Enable PassiveTeX extensions?</refpurpose>\r
1700 </refnamediv>\r
1701 \r
1702 <refsynopsisdiv>\r
1703 <programlisting xml:id="passivetex.extensions.frag">&lt;xsl:param name="passivetex.extensions" select="0"&gt;&lt;/xsl:param&gt;</programlisting>\r
1704 </refsynopsisdiv>\r
1705 \r
1706 <refsection><info><title>Description</title></info>\r
1707 \r
1708 <para>If non-zero,\r
1709 <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.tei-c.org.uk/Software/passivetex/">PassiveTeX</link>\r
1710 extensions will be used. At present, this consists of PDF bookmarks\r
1711 and sorted index terms.\r
1712 </para>\r
1713 \r
1714 <para>This parameter can also affect which graphics file formats\r
1715 are supported</para>\r
1716 \r
1717 <note>\r
1718   <para>PassiveTeX is incomplete and development has ceased. In most cases, \r
1719 another XSL-FO engine is probably a better choice.</para>\r
1720 </note>\r
1721 \r
1722 </refsection>\r
1723 </refentry>\r
1724 \r
1725 <refentry version="5.0" xml:id="tex.math.in.alt">\r
1726 <refmeta>\r
1727 <refentrytitle>tex.math.in.alt</refentrytitle>\r
1728 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> \r
1729 <refmiscinfo class="other" otherclass="value">plain</refmiscinfo>\r
1730 <refmiscinfo class="other" otherclass="value">latex</refmiscinfo>\r
1731 </refmeta>\r
1732 <refnamediv>\r
1733 <refname>tex.math.in.alt</refname>\r
1734 <refpurpose>TeX notation used for equations</refpurpose>\r
1735 </refnamediv>\r
1736 \r
1737 <refsynopsisdiv>\r
1738 <programlisting xml:id="tex.math.in.alt.frag">\r
1739 &lt;xsl:param name="tex.math.in.alt"&gt;&lt;/xsl:param&gt;\r
1740 </programlisting>\r
1741 </refsynopsisdiv>\r
1742 \r
1743 <refsection><info><title>Description</title></info>\r
1744 \r
1745 <para>If you want type math directly in TeX notation in equations,\r
1746 this parameter specifies notation used. Currently are supported two\r
1747 values -- <literal>plain</literal> and <literal>latex</literal>. Empty\r
1748 value means that you are not using TeX math at all.</para>\r
1749 \r
1750 <para>Preferred way for including TeX alternative of math is inside of\r
1751 <tag>textobject</tag> element. Eg.:</para>\r
1752 \r
1753 <programlisting>&lt;inlineequation&gt;\r
1754 &lt;inlinemediaobject&gt;\r
1755 &lt;imageobject&gt;\r
1756 &lt;imagedata fileref="eq1.gif"/&gt;\r
1757 &lt;/imageobject&gt;\r
1758 &lt;textobject&gt;&lt;phrase&gt;E=mc squared&lt;/phrase&gt;&lt;/textobject&gt;\r
1759 &lt;textobject role="tex"&gt;&lt;phrase&gt;E=mc^2&lt;/phrase&gt;&lt;/textobject&gt;\r
1760 &lt;/inlinemediaobject&gt;\r
1761 &lt;/inlineequation&gt;</programlisting>\r
1762 \r
1763 <para>If you are using <tag>graphic</tag> element, you can\r
1764 store TeX inside <tag>alt</tag> element:</para>\r
1765 \r
1766 <programlisting>&lt;inlineequation&gt;\r
1767 &lt;alt role="tex"&gt;a^2+b^2=c^2&lt;/alt&gt;\r
1768 &lt;graphic fileref="a2b2c2.gif"/&gt;  \r
1769 &lt;/inlineequation&gt;</programlisting>\r
1770 \r
1771 <para>If you want use this feature, you should process your FO with\r
1772 PassiveTeX, which only supports TeX math notation. When calling\r
1773 stylsheet, don't forget to specify also\r
1774 passivetex.extensions=1.</para>\r
1775 \r
1776 <para>If you want equations in HTML, just process generated file\r
1777 <filename>tex-math-equations.tex</filename> by TeX or LaTeX. Then run\r
1778 dvi2bitmap program on result DVI file. You will get images for\r
1779 equations in your document.</para>\r
1780 \r
1781 <warning>\r
1782   <para>This feature is useful for print/PDF output only if you\r
1783     use the obsolete and now unsupported PassiveTeX XSL-FO\r
1784     engine.</para>\r
1785 </warning>\r
1786 \r
1787 </refsection>\r
1788 \r
1789 <refsection><info><title>Related Parameters</title></info>\r
1790   <para><parameter>tex.math.delims</parameter>,\r
1791     <parameter>passivetex.extensions</parameter>,\r
1792     <parameter>tex.math.file</parameter></para>\r
1793 </refsection>\r
1794 <refsection><info><title>More information</title></info>\r
1795   <para>For how-to documentation on embedding TeX equations and\r
1796     generating output from them, see\r
1797     <link xmlns:xlink="http://www.w3.org/1999/xlink" role="tcg" xlink:href="TexMath.html">DBTeXMath</link>.</para>\r
1798 </refsection>\r
1799 </refentry>\r
1800 \r
1801 <refentry version="5.0" xml:id="tex.math.delims">\r
1802 <refmeta>\r
1803 <refentrytitle>tex.math.delims</refentrytitle>\r
1804 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
1805 </refmeta>\r
1806 <refnamediv>\r
1807 <refname>tex.math.delims</refname>\r
1808 <refpurpose>Should equations output for processing by TeX be\r
1809 surrounded by math mode delimiters?</refpurpose>\r
1810 </refnamediv> \r
1811 \r
1812 <refsynopsisdiv>\r
1813 <programlisting xml:id="tex.math.delims.frag">\r
1814 &lt;xsl:param name="tex.math.delims" select="1"&gt;&lt;/xsl:param&gt;\r
1815 </programlisting>\r
1816 </refsynopsisdiv>\r
1817 \r
1818 <refsection><info><title>Description</title></info>\r
1819 \r
1820 <para>For compatibility with DSSSL based DBTeXMath from Allin Cottrell\r
1821 you should set this parameter to 0.</para>\r
1822 \r
1823 </refsection>\r
1824 <refsection><info><title>Related Parameters</title></info>\r
1825   <para><parameter>tex.math.in.alt</parameter>,\r
1826     <parameter>passivetex.extensions</parameter></para>\r
1827 </refsection>\r
1828 \r
1829 <refsection><info><title>See Also</title></info>\r
1830   <para>You can also use the <tag class="xmlpi">dbtex delims</tag> processing\r
1831     instruction to control whether delimiters are output.</para>\r
1832 </refsection>\r
1833 <refsection><info><title>More information</title></info>\r
1834   <para>For how-to documentation on embedding TeX equations and\r
1835     generating output from them, see\r
1836     <link xmlns:xlink="http://www.w3.org/1999/xlink" role="tcg" xlink:href="TexMath.html">DBTeXMath</link>.</para>\r
1837 </refsection>\r
1838 </refentry>\r
1839 \r
1840 <refentry version="5.0" xml:id="xep.extensions">\r
1841 <refmeta>\r
1842 <refentrytitle>xep.extensions</refentrytitle>\r
1843 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
1844 </refmeta>\r
1845 <refnamediv>\r
1846 <refname>xep.extensions</refname>\r
1847 <refpurpose>Enable XEP extensions?</refpurpose>\r
1848 </refnamediv>\r
1849 \r
1850 <refsynopsisdiv>\r
1851 <programlisting xml:id="xep.extensions.frag">&lt;xsl:param name="xep.extensions" select="0"&gt;&lt;/xsl:param&gt;</programlisting>\r
1852 </refsynopsisdiv>\r
1853 \r
1854 <refsection><info><title>Description</title></info>\r
1855 \r
1856 <para>If non-zero,\r
1857 <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.renderx.com/">XEP</link>\r
1858 extensions will be used. XEP extensions consists of PDF bookmarks,\r
1859 document information and better index processing.\r
1860 </para>\r
1861 \r
1862 <para>This parameter can also affect which graphics file formats\r
1863 are supported</para>\r
1864 </refsection>\r
1865 </refentry>\r
1866 \r
1867 </reference>\r
1868 <reference xml:id="dbk_ext"><title>Stylesheet Extensions</title>\r
1869 <refentry version="5.0" xml:id="linenumbering.everyNth">\r
1870 <refmeta>\r
1871 <refentrytitle>linenumbering.everyNth</refentrytitle>\r
1872 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>\r
1873 </refmeta>\r
1874 <refnamediv>\r
1875 <refname>linenumbering.everyNth</refname>\r
1876 <refpurpose>Indicate which lines should be numbered</refpurpose>\r
1877 </refnamediv>\r
1878 \r
1879 <refsynopsisdiv>\r
1880 <programlisting xml:id="linenumbering.everyNth.frag">\r
1881 &lt;xsl:param name="linenumbering.everyNth"&gt;5&lt;/xsl:param&gt;\r
1882 </programlisting>\r
1883 </refsynopsisdiv>\r
1884 \r
1885 <refsection><info><title>Description</title></info>\r
1886 \r
1887 <para>If line numbering is enabled, everyNth line will be\r
1888 numbered. Note that numbering is one based, not zero based.\r
1889 </para>\r
1890 \r
1891 </refsection>\r
1892 </refentry>\r
1893 \r
1894 <refentry version="5.0" xml:id="linenumbering.extension">\r
1895 <refmeta>\r
1896 <refentrytitle>linenumbering.extension</refentrytitle>\r
1897 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
1898 </refmeta>\r
1899 <refnamediv>\r
1900 <refname>linenumbering.extension</refname>\r
1901 <refpurpose>Enable the line numbering extension</refpurpose>\r
1902 </refnamediv>\r
1903 \r
1904 <refsynopsisdiv>\r
1905 <programlisting xml:id="linenumbering.extension.frag">\r
1906 &lt;xsl:param name="linenumbering.extension" select="1"&gt;&lt;/xsl:param&gt;\r
1907 </programlisting>\r
1908 </refsynopsisdiv>\r
1909 \r
1910 <refsection><info><title>Description</title></info>\r
1911 \r
1912 <para>If non-zero, verbatim environments (<tag>address</tag>, <tag>literallayout</tag>,\r
1913 <tag>programlisting</tag>, <tag>screen</tag>, <tag>synopsis</tag>) that specify line numbering will\r
1914 have line numbers.\r
1915 </para>\r
1916 \r
1917 </refsection>\r
1918 </refentry>\r
1919 \r
1920 <refentry version="5.0" xml:id="linenumbering.separator">\r
1921 <refmeta>\r
1922 <refentrytitle>linenumbering.separator</refentrytitle>\r
1923 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
1924 </refmeta>\r
1925 <refnamediv>\r
1926 <refname>linenumbering.separator</refname>\r
1927 <refpurpose>Specify a separator between line numbers and lines</refpurpose>\r
1928 </refnamediv>\r
1929 \r
1930 <refsynopsisdiv>\r
1931 <programlisting xml:id="linenumbering.separator.frag">\r
1932 &lt;xsl:param name="linenumbering.separator"&gt;&lt;xsl:text&gt; &lt;/xsl:text&gt;&lt;/xsl:param&gt;\r
1933 </programlisting>\r
1934 </refsynopsisdiv>\r
1935 \r
1936 <refsection><info><title>Description</title></info>\r
1937 \r
1938 <para>The separator is inserted between line numbers and lines in the\r
1939 verbatim environment. The default value is a single white space.\r
1940  Note the interaction with <parameter>linenumbering.width</parameter>\r
1941 </para>\r
1942 \r
1943 </refsection>\r
1944 </refentry>\r
1945 \r
1946 <refentry version="5.0" xml:id="linenumbering.width">\r
1947 <refmeta>\r
1948 <refentrytitle>linenumbering.width</refentrytitle>\r
1949 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>\r
1950 </refmeta>\r
1951 <refnamediv>\r
1952 <refname>linenumbering.width</refname>\r
1953 <refpurpose>Indicates the width of line numbers</refpurpose>\r
1954 </refnamediv>\r
1955 \r
1956 <refsynopsisdiv>\r
1957 <programlisting xml:id="linenumbering.width.frag">\r
1958 &lt;xsl:param name="linenumbering.width"&gt;3&lt;/xsl:param&gt;\r
1959 </programlisting>\r
1960 </refsynopsisdiv>\r
1961 \r
1962 <refsection><info><title>Description</title></info>\r
1963 \r
1964 <para>If line numbering is enabled, line numbers will appear right\r
1965 justified in a field "width" characters wide.\r
1966 </para>\r
1967 \r
1968 </refsection>\r
1969 </refentry>\r
1970 \r
1971 <refentry version="5.0" xml:id="tablecolumns.extension">\r
1972 <refmeta>\r
1973 <refentrytitle>tablecolumns.extension</refentrytitle>\r
1974 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
1975 </refmeta>\r
1976 <refnamediv>\r
1977 <refname>tablecolumns.extension</refname>\r
1978 <refpurpose>Enable the table columns extension function</refpurpose>\r
1979 </refnamediv>\r
1980 \r
1981 <refsynopsisdiv>\r
1982 <programlisting xml:id="tablecolumns.extension.frag">\r
1983 &lt;xsl:param name="tablecolumns.extension" select="1"&gt;&lt;/xsl:param&gt;\r
1984 </programlisting>\r
1985 </refsynopsisdiv>\r
1986 \r
1987 <refsection><info><title>Description</title></info>\r
1988 \r
1989 <para>The table columns extension function adjusts the widths of table\r
1990 columns in the HTML result to more accurately reflect the specifications\r
1991 in the CALS table.\r
1992 </para>\r
1993 \r
1994 </refsection>\r
1995 </refentry>\r
1996 \r
1997 <refentry version="5.0" xml:id="textinsert.extension">\r
1998   <refmeta>\r
1999     <refentrytitle>textinsert.extension</refentrytitle>\r
2000     <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
2001   </refmeta>\r
2002   <refnamediv>\r
2003     <refname>textinsert.extension</refname>\r
2004     <refpurpose>Enables the textinsert extension element</refpurpose>\r
2005   </refnamediv>\r
2006   <refsynopsisdiv>\r
2007     <programlisting xml:id="textinsert.extension.frag">\r
2008   &lt;xsl:param name="textinsert.extension" select="1"&gt;&lt;/xsl:param&gt;\r
2009 </programlisting>\r
2010   </refsynopsisdiv>\r
2011   <refsection><info><title>Description</title></info>\r
2012     <para>The textinsert extension element inserts the contents of\r
2013       a file into the result tree (as text).</para>\r
2014     <note>\r
2015       <para>To use the textinsert extension element, you must use\r
2016         either Saxon or Xalan as your XSLT processor (it doesn&#8217;t\r
2017         work with xsltproc), along with either the DocBook Saxon\r
2018         extensions or DocBook Xalan extensions (for more\r
2019         information about those extensions, see <link xmlns:xlink="http://www.w3.org/1999/xlink" role="tcg" xlink:href="InstallingAProcessor.html#SaxonExtensions">DocBook Saxon Extensions</link> and <link xmlns:xlink="http://www.w3.org/1999/xlink" role="tcg" xlink:href="InstallingAProcessor.html#XalanExtensions">DocBook Xalan Extensions</link>), and you must set both\r
2020         the <parameter>use.extensions</parameter> and\r
2021         <parameter>textinsert.extension</parameter> parameters to\r
2022         <literal>1</literal>.</para>\r
2023       <para>As an alternative to using the textinsert element,\r
2024         consider using an Xinclude element with the\r
2025         <literal>parse="text"</literal> attribute and value\r
2026         specified, as detailed in <link xmlns:xlink="http://www.w3.org/1999/xlink" role="tcg" xlink:href="ExternalCode.html#XIncludeCode">Using XInclude for text inclusions</link>.</para>\r
2027     </note>\r
2028   </refsection>\r
2029   <refsection><info><title>See Also</title></info>\r
2030     <para>You can also use the <tag class="xmlpi">dbhtml-include&#160;href</tag> processing\r
2031       instruction to insert external files &#8212; both files containing\r
2032       plain text and files with markup content (including HTML\r
2033       content).</para>\r
2034   </refsection>\r
2035   <refsection><info><title>More information</title></info>\r
2036     <para>For how-to documentation on inserting contents of\r
2037       external code files and other text files into output, see\r
2038       <link xmlns:xlink="http://www.w3.org/1999/xlink" role="tcg" xlink:href="ExternalCode.html">External code files</link>.</para>\r
2039     <para>For guidelines on inserting contents of\r
2040       HTML files into output, see <link xmlns:xlink="http://www.w3.org/1999/xlink" role="tcg" xlink:href="InsertExtHtml.html">Inserting external HTML code</link>.</para>\r
2041   </refsection>\r
2042 </refentry>\r
2043 \r
2044 <refentry version="5.0" xml:id="textdata.default.encoding">\r
2045 <refmeta>\r
2046 <refentrytitle>textdata.default.encoding</refentrytitle>\r
2047 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
2048 </refmeta>\r
2049 <refnamediv>\r
2050 <refname>textdata.default.encoding</refname>\r
2051 <refpurpose>Default encoding of external text files which are included\r
2052 using textdata element</refpurpose>\r
2053 </refnamediv>\r
2054 \r
2055 <refsynopsisdiv>\r
2056 <programlisting xml:id="textdata.default.encoding.frag">\r
2057 &lt;xsl:param name="textdata.default.encoding"&gt;&lt;/xsl:param&gt;\r
2058 </programlisting>\r
2059 </refsynopsisdiv>\r
2060 \r
2061 <refsection><info><title>Description</title></info>\r
2062 \r
2063 <para>Specifies the encoding of any external text files included using\r
2064 <tag>textdata</tag> element. This value is used only when you do\r
2065 not specify encoding by the appropriate attribute \r
2066 directly on textdata. An empty string is interpreted as the system\r
2067 default encoding.</para>\r
2068 \r
2069 </refsection>\r
2070 </refentry>\r
2071 \r
2072 <refentry version="5.0" xml:id="use.extensions">\r
2073 <refmeta>\r
2074 <refentrytitle>use.extensions</refentrytitle>\r
2075 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
2076 </refmeta>\r
2077 <refnamediv>\r
2078 <refname>use.extensions</refname>\r
2079 <refpurpose>Enable extensions</refpurpose>\r
2080 </refnamediv>\r
2081 \r
2082 <refsynopsisdiv>\r
2083 <programlisting xml:id="use.extensions.frag">\r
2084 &lt;xsl:param name="use.extensions" select="0"&gt;&lt;/xsl:param&gt;\r
2085 </programlisting>\r
2086 </refsynopsisdiv>\r
2087 \r
2088 <refsection><info><title>Description</title></info>\r
2089 \r
2090 <para>If non-zero, extensions may be used. Each extension is\r
2091 further controlled by its own parameter. But if\r
2092 <parameter>use.extensions</parameter> is zero, no extensions will\r
2093 be used.\r
2094 </para>\r
2095 \r
2096 </refsection>\r
2097 </refentry>\r
2098 \r
2099 </reference>\r
2100 <reference xml:id="labels"><title>Automatic labelling</title>\r
2101 <refentry version="5.0" xml:id="appendix.autolabel">\r
2102 <refmeta>\r
2103 <refentrytitle>appendix.autolabel</refentrytitle>\r
2104 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> \r
2105 <refmiscinfo class="other" otherclass="value">0<alt>none</alt></refmiscinfo>\r
2106 <refmiscinfo class="other" otherclass="value">1<alt>1,2,3...</alt></refmiscinfo>\r
2107 <refmiscinfo class="other" otherclass="value">A<alt>A,B,C...</alt></refmiscinfo>\r
2108 <refmiscinfo class="other" otherclass="value">a<alt>a,b,c...</alt></refmiscinfo>\r
2109 <refmiscinfo class="other" otherclass="value">i<alt>i,ii,iii...</alt></refmiscinfo>\r
2110 <refmiscinfo class="other" otherclass="value">I<alt>I,II,III...</alt></refmiscinfo>\r
2111 </refmeta>\r
2112 <refnamediv>\r
2113 <refname>appendix.autolabel</refname>\r
2114 <refpurpose>Specifies the labeling format for Appendix titles</refpurpose>\r
2115 </refnamediv>\r
2116 \r
2117 <refsynopsisdiv>\r
2118 <programlisting xml:id="appendix.autolabel.frag">\r
2119 &lt;xsl:param name="appendix.autolabel"&gt;A&lt;/xsl:param&gt;\r
2120 </programlisting>\r
2121 </refsynopsisdiv>\r
2122 \r
2123 <refsection><info><title>Description</title></info>\r
2124 \r
2125 <para>If non-zero, then appendices will be numbered using the\r
2126 parameter value as the number format if the value matches one of the\r
2127 following:\r
2128 </para>\r
2129 \r
2130 <variablelist>\r
2131   <varlistentry>\r
2132     <term>1 or arabic</term>\r
2133     <listitem>\r
2134       <para>Arabic numeration (1, 2, 3 ...).</para>\r
2135     </listitem>\r
2136   </varlistentry>\r
2137   <varlistentry>\r
2138     <term>A or upperalpha</term>\r
2139     <listitem>\r
2140       <para>Uppercase letter numeration (A, B, C ...).</para>\r
2141     </listitem>\r
2142   </varlistentry>\r
2143   <varlistentry>\r
2144     <term>a or loweralpha</term>\r
2145     <listitem>\r
2146       <para>Lowercase letter numeration (a, b, c ...).</para>\r
2147     </listitem>\r
2148   </varlistentry>\r
2149   <varlistentry>\r
2150     <term>I or upperroman</term>\r
2151     <listitem>\r
2152       <para>Uppercase roman numeration (I, II, III ...).</para>\r
2153     </listitem>\r
2154   </varlistentry>\r
2155   <varlistentry>\r
2156     <term>i or lowerroman</term>\r
2157     <listitem>\r
2158       <para>Lowercase roman letter numeration (i, ii, iii ...).</para>\r
2159     </listitem>\r
2160   </varlistentry>\r
2161 </variablelist>\r
2162 \r
2163 <para>Any nonzero value other than the above will generate\r
2164 the default number format (upperalpha).\r
2165 </para>\r
2166 \r
2167 </refsection>\r
2168 </refentry>\r
2169 \r
2170 <refentry version="5.0" xml:id="chapter.autolabel">\r
2171 <refmeta>\r
2172 <refentrytitle>chapter.autolabel</refentrytitle>\r
2173 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> \r
2174 <refmiscinfo class="other" otherclass="value">0<alt>none</alt></refmiscinfo>\r
2175 <refmiscinfo class="other" otherclass="value">1<alt>1,2,3...</alt></refmiscinfo>\r
2176 <refmiscinfo class="other" otherclass="value">A<alt>A,B,C...</alt></refmiscinfo>\r
2177 <refmiscinfo class="other" otherclass="value">a<alt>a,b,c...</alt></refmiscinfo>\r
2178 <refmiscinfo class="other" otherclass="value">i<alt>i,ii,iii...</alt></refmiscinfo>\r
2179 <refmiscinfo class="other" otherclass="value">I<alt>I,II,III...</alt></refmiscinfo>\r
2180 </refmeta>\r
2181 <refnamediv>\r
2182 <refname>chapter.autolabel</refname>\r
2183 <refpurpose>Specifies the labeling format for Chapter titles</refpurpose>\r
2184 </refnamediv>\r
2185 \r
2186 <refsynopsisdiv>\r
2187 <programlisting xml:id="chapter.autolabel.frag">\r
2188 &lt;xsl:param name="chapter.autolabel" select="1"&gt;&lt;/xsl:param&gt;</programlisting>\r
2189 </refsynopsisdiv>\r
2190 \r
2191 <refsection><info><title>Description</title></info>\r
2192 \r
2193 <para>If non-zero, then chapters will be numbered using the parameter\r
2194 value as the number format if the value matches one of the following:\r
2195 </para>\r
2196 \r
2197 <variablelist>\r
2198   <varlistentry>\r
2199     <term>1 or arabic</term>\r
2200     <listitem>\r
2201       <para>Arabic numeration (1, 2, 3 ...).</para>\r
2202     </listitem>\r
2203   </varlistentry>\r
2204   <varlistentry>\r
2205     <term>A or upperalpha</term>\r
2206     <listitem>\r
2207       <para>Uppercase letter numeration (A, B, C ...).</para>\r
2208     </listitem>\r
2209   </varlistentry>\r
2210   <varlistentry>\r
2211     <term>a or loweralpha</term>\r
2212     <listitem>\r
2213       <para>Lowercase letter numeration (a, b, c ...).</para>\r
2214     </listitem>\r
2215   </varlistentry>\r
2216   <varlistentry>\r
2217     <term>I or upperroman</term>\r
2218     <listitem>\r
2219       <para>Uppercase roman numeration (I, II, III ...).</para>\r
2220     </listitem>\r
2221   </varlistentry>\r
2222   <varlistentry>\r
2223     <term>i or lowerroman</term>\r
2224     <listitem>\r
2225       <para>Lowercase roman letter numeration (i, ii, iii ...).</para>\r
2226     </listitem>\r
2227   </varlistentry>\r
2228 </variablelist>\r
2229 \r
2230 <para>Any nonzero value other than the above will generate\r
2231 the default number format (arabic).\r
2232 </para>\r
2233 \r
2234 </refsection>\r
2235 </refentry>\r
2236 \r
2237 <refentry version="5.0" xml:id="part.autolabel">\r
2238 <refmeta>\r
2239 <refentrytitle>part.autolabel</refentrytitle>\r
2240 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> \r
2241 <refmiscinfo class="other" otherclass="value">0<alt>none</alt></refmiscinfo>\r
2242 <refmiscinfo class="other" otherclass="value">1<alt>1,2,3...</alt></refmiscinfo>\r
2243 <refmiscinfo class="other" otherclass="value">A<alt>A,B,C...</alt></refmiscinfo>\r
2244 <refmiscinfo class="other" otherclass="value">a<alt>a,b,c...</alt></refmiscinfo>\r
2245 <refmiscinfo class="other" otherclass="value">i<alt>i,ii,iii...</alt></refmiscinfo>\r
2246 <refmiscinfo class="other" otherclass="value">I<alt>I,II,III...</alt></refmiscinfo>\r
2247 </refmeta>\r
2248 <refnamediv>\r
2249 <refname>part.autolabel</refname>\r
2250 <refpurpose>Specifies the labeling format for Part titles</refpurpose>\r
2251 </refnamediv>\r
2252 \r
2253 <refsynopsisdiv>\r
2254 <programlisting xml:id="part.autolabel.frag">\r
2255 &lt;xsl:param name="part.autolabel"&gt;I&lt;/xsl:param&gt;\r
2256 </programlisting>\r
2257 </refsynopsisdiv>\r
2258 \r
2259 <refsection><info><title>Description</title></info>\r
2260 \r
2261 <para>If non-zero, then parts will be numbered using the parameter\r
2262 value as the number format if the value matches one of the following:\r
2263 </para>\r
2264 \r
2265 <variablelist>\r
2266   <varlistentry>\r
2267     <term>1 or arabic</term>\r
2268     <listitem>\r
2269       <para>Arabic numeration (1, 2, 3 ...).</para>\r
2270     </listitem>\r
2271   </varlistentry>\r
2272   <varlistentry>\r
2273     <term>A or upperalpha</term>\r
2274     <listitem>\r
2275       <para>Uppercase letter numeration (A, B, C ...).</para>\r
2276     </listitem>\r
2277   </varlistentry>\r
2278   <varlistentry>\r
2279     <term>a or loweralpha</term>\r
2280     <listitem>\r
2281       <para>Lowercase letter numeration (a, b, c ...).</para>\r
2282     </listitem>\r
2283   </varlistentry>\r
2284   <varlistentry>\r
2285     <term>I or upperroman</term>\r
2286     <listitem>\r
2287       <para>Uppercase roman numeration (I, II, III ...).</para>\r
2288     </listitem>\r
2289   </varlistentry>\r
2290   <varlistentry>\r
2291     <term>i or lowerroman</term>\r
2292     <listitem>\r
2293       <para>Lowercase roman letter numeration (i, ii, iii ...).</para>\r
2294     </listitem>\r
2295   </varlistentry>\r
2296 </variablelist>\r
2297 \r
2298 <para>Any nonzero value other than the above will generate\r
2299 the default number format (upperroman).\r
2300 </para>\r
2301 \r
2302 \r
2303 </refsection>\r
2304 </refentry>\r
2305 \r
2306 <refentry version="5.0" xml:id="reference.autolabel">\r
2307 <refmeta>\r
2308 <refentrytitle>reference.autolabel</refentrytitle>\r
2309 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> \r
2310 <refmiscinfo class="other" otherclass="value">0<alt>none</alt></refmiscinfo>\r
2311 <refmiscinfo class="other" otherclass="value">1<alt>1,2,3...</alt></refmiscinfo>\r
2312 <refmiscinfo class="other" otherclass="value">A<alt>A,B,C...</alt></refmiscinfo>\r
2313 <refmiscinfo class="other" otherclass="value">a<alt>a,b,c...</alt></refmiscinfo>\r
2314 <refmiscinfo class="other" otherclass="value">i<alt>i,ii,iii...</alt></refmiscinfo>\r
2315 <refmiscinfo class="other" otherclass="value">I<alt>I,II,III...</alt></refmiscinfo>\r
2316 </refmeta>\r
2317 <refnamediv>\r
2318 <refname>reference.autolabel</refname>\r
2319 <refpurpose>Specifies the labeling format for Reference titles</refpurpose>\r
2320 </refnamediv>\r
2321 <refsynopsisdiv>\r
2322 <programlisting xml:id="reference.autolabel.frag">\r
2323   &lt;xsl:param name="reference.autolabel"&gt;I&lt;/xsl:param&gt;\r
2324 </programlisting>\r
2325 </refsynopsisdiv>\r
2326 <refsection><info><title>Description</title></info>\r
2327 <para>If non-zero, references will be numbered using the parameter\r
2328   value as the number format if the value matches one of the\r
2329   following:\r
2330 </para>\r
2331 <variablelist>\r
2332   <varlistentry>\r
2333     <term>1 or arabic</term>\r
2334     <listitem>\r
2335       <para>Arabic numeration (1, 2, 3 ...).</para>\r
2336     </listitem>\r
2337   </varlistentry>\r
2338   <varlistentry>\r
2339     <term>A or upperalpha</term>\r
2340     <listitem>\r
2341       <para>Uppercase letter numeration (A, B, C ...).</para>\r
2342     </listitem>\r
2343   </varlistentry>\r
2344   <varlistentry>\r
2345     <term>a or loweralpha</term>\r
2346     <listitem>\r
2347       <para>Lowercase letter numeration (a, b, c ...).</para>\r
2348     </listitem>\r
2349   </varlistentry>\r
2350   <varlistentry>\r
2351     <term>I or upperroman</term>\r
2352     <listitem>\r
2353       <para>Uppercase roman numeration (I, II, III ...).</para>\r
2354     </listitem>\r
2355   </varlistentry>\r
2356   <varlistentry>\r
2357     <term>i or lowerroman</term>\r
2358     <listitem>\r
2359       <para>Lowercase roman letter numeration (i, ii, iii ...).</para>\r
2360     </listitem>\r
2361   </varlistentry>\r
2362 </variablelist>\r
2363 <para>Any non-zero value other than the above will generate\r
2364 the default number format (upperroman).\r
2365 </para>\r
2366 </refsection>\r
2367 </refentry>\r
2368 \r
2369 <refentry version="5.0" xml:id="preface.autolabel">\r
2370 <refmeta>\r
2371 <refentrytitle>preface.autolabel</refentrytitle>\r
2372 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> \r
2373 <refmiscinfo class="other" otherclass="value">0<alt>none</alt></refmiscinfo>\r
2374 <refmiscinfo class="other" otherclass="value">1<alt>1,2,3...</alt></refmiscinfo>\r
2375 <refmiscinfo class="other" otherclass="value">A<alt>A,B,C...</alt></refmiscinfo>\r
2376 <refmiscinfo class="other" otherclass="value">a<alt>a,b,c...</alt></refmiscinfo>\r
2377 <refmiscinfo class="other" otherclass="value">i<alt>i,ii,iii...</alt></refmiscinfo>\r
2378 <refmiscinfo class="other" otherclass="value">I<alt>I,II,III...</alt></refmiscinfo>\r
2379 </refmeta>\r
2380 <refnamediv>\r
2381 <refname>preface.autolabel</refname>\r
2382 <refpurpose>Specifices the labeling format for Preface titles</refpurpose>\r
2383 </refnamediv>\r
2384 \r
2385 <refsynopsisdiv>\r
2386 <programlisting xml:id="preface.autolabel.frag">&lt;xsl:param name="preface.autolabel" select="0"&gt;&lt;/xsl:param&gt;</programlisting>\r
2387 </refsynopsisdiv>\r
2388 \r
2389 <refsection><info><title>Description</title></info>\r
2390 \r
2391 <para>If non-zero then prefaces will be numbered using the parameter\r
2392 value as the number format if the value matches one of the following:\r
2393 </para>\r
2394 \r
2395 <variablelist>\r
2396   <varlistentry>\r
2397     <term>1 or arabic</term>\r
2398     <listitem>\r
2399       <para>Arabic numeration (1, 2, 3 ...).</para>\r
2400     </listitem>\r
2401   </varlistentry>\r
2402   <varlistentry>\r
2403     <term>A or upperalpha</term>\r
2404     <listitem>\r
2405       <para>Uppercase letter numeration (A, B, C ...).</para>\r
2406     </listitem>\r
2407   </varlistentry>\r
2408   <varlistentry>\r
2409     <term>a or loweralpha</term>\r
2410     <listitem>\r
2411       <para>Lowercase letter numeration (a, b, c ...).</para>\r
2412     </listitem>\r
2413   </varlistentry>\r
2414   <varlistentry>\r
2415     <term>I or upperroman</term>\r
2416     <listitem>\r
2417       <para>Uppercase roman numeration (I, II, III ...).</para>\r
2418     </listitem>\r
2419   </varlistentry>\r
2420   <varlistentry>\r
2421     <term>i or lowerroman</term>\r
2422     <listitem>\r
2423       <para>Lowercase roman letter numeration (i, ii, iii ...).</para>\r
2424     </listitem>\r
2425   </varlistentry>\r
2426 </variablelist>\r
2427 \r
2428 <para>Any nonzero value other than the above will generate\r
2429 the default number format (arabic).\r
2430 </para>\r
2431 \r
2432 \r
2433 </refsection>\r
2434 </refentry>\r
2435 \r
2436 <refentry version="5.0" xml:id="section.autolabel">\r
2437 <refmeta>\r
2438 <refentrytitle>section.autolabel</refentrytitle>\r
2439 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
2440 </refmeta>\r
2441 <refnamediv>\r
2442 <refname>section.autolabel</refname>\r
2443 <refpurpose>Are sections enumerated?</refpurpose>\r
2444 </refnamediv>\r
2445 \r
2446 <refsynopsisdiv>\r
2447 <programlisting xml:id="section.autolabel.frag">&lt;xsl:param name="section.autolabel" select="0"&gt;&lt;/xsl:param&gt;</programlisting>\r
2448 </refsynopsisdiv>\r
2449 \r
2450 <refsection><info><title>Description</title></info>\r
2451 \r
2452 <para>If true (non-zero), unlabeled sections will be enumerated.\r
2453 </para>\r
2454 \r
2455 </refsection>\r
2456 </refentry>\r
2457 \r
2458 <refentry version="5.0" xml:id="section.autolabel.max.depth">\r
2459 <refmeta>\r
2460 <refentrytitle>section.autolabel.max.depth</refentrytitle>\r
2461 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>\r
2462 </refmeta>\r
2463 <refnamediv>\r
2464 <refname>section.autolabel.max.depth</refname>\r
2465 <refpurpose>The deepest level of sections that are numbered.</refpurpose>\r
2466 </refnamediv>\r
2467 \r
2468 <refsynopsisdiv>\r
2469 <programlisting xml:id="section.autolabel.max.depth.frag">\r
2470 &lt;xsl:param name="section.autolabel.max.depth"&gt;8&lt;/xsl:param&gt;\r
2471 </programlisting>\r
2472 </refsynopsisdiv>\r
2473 \r
2474 <refsection><info><title>Description</title></info>\r
2475 \r
2476 <para>When section numbering is turned on by the\r
2477 <parameter>section.autolabel</parameter> parameter, then this\r
2478 parameter controls the depth of <tag>section</tag> nesting that is\r
2479 numbered.  Sections nested to a level deeper than this value will not\r
2480 be numbered.\r
2481 </para>\r
2482 \r
2483 </refsection>\r
2484 </refentry>\r
2485 \r
2486 <refentry version="5.0" xml:id="section.label.includes.component.label">\r
2487 <refmeta>\r
2488 <refentrytitle>section.label.includes.component.label</refentrytitle>\r
2489 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
2490 </refmeta>\r
2491 <refnamediv>\r
2492 <refname>section.label.includes.component.label</refname>\r
2493 <refpurpose>Do section labels include the component label?</refpurpose>\r
2494 </refnamediv>\r
2495 \r
2496 <refsynopsisdiv>\r
2497 <programlisting xml:id="section.label.includes.component.label.frag">&lt;xsl:param name="section.label.includes.component.label" select="0"&gt;&lt;/xsl:param&gt;</programlisting>\r
2498 </refsynopsisdiv>\r
2499 \r
2500 <refsection><info><title>Description</title></info>\r
2501 \r
2502 <para>If non-zero, section labels are prefixed with the label of the\r
2503 component that contains them.\r
2504 </para>\r
2505 \r
2506 </refsection>\r
2507 </refentry>\r
2508 \r
2509 <refentry version="5.0" xml:id="label.from.part">\r
2510 <refmeta>\r
2511 <refentrytitle>label.from.part</refentrytitle>\r
2512 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
2513 </refmeta>\r
2514 <refnamediv>\r
2515 <refname>label.from.part</refname>\r
2516 <refpurpose>Renumber components in each part?</refpurpose>\r
2517 </refnamediv>\r
2518 \r
2519 <refsynopsisdiv>\r
2520 <programlisting xml:id="label.from.part.frag">\r
2521 &lt;xsl:param name="label.from.part" select="0"&gt;&lt;/xsl:param&gt;\r
2522 </programlisting>\r
2523 </refsynopsisdiv>\r
2524 \r
2525 <refsection><info><title>Description</title></info>\r
2526 \r
2527 <para>If <parameter>label.from.part</parameter> is non-zero, then\r
2528   numbering of components &#8212; <tag>preface</tag>,\r
2529   <tag>chapter</tag>, <tag>appendix</tag>, and\r
2530   <tag>reference</tag> (when <tag>reference</tag> occurs at the\r
2531   component level) &#8212; is re-started within each\r
2532   <tag>part</tag>.</para>\r
2533 <para>If <parameter>label.from.part</parameter> is zero (the\r
2534   default), numbering of components is <emphasis>not</emphasis>\r
2535   re-started within each <tag>part</tag>; instead, components are\r
2536   numbered sequentially throughout each <tag>book</tag>,\r
2537   regardless of whether or not they occur within <tag>part</tag>\r
2538   instances.</para>\r
2539 \r
2540 </refsection>\r
2541 </refentry>\r
2542 \r
2543 <refentry version="5.0" xml:id="component.label.includes.part.label">\r
2544 <refmeta>\r
2545 <refentrytitle>component.label.includes.part.label</refentrytitle>\r
2546 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
2547 </refmeta>\r
2548 <refnamediv>\r
2549 <refname>component.label.includes.part.label</refname>\r
2550 <refpurpose>Do component labels include the part label?</refpurpose>\r
2551 </refnamediv>\r
2552 \r
2553 <refsynopsisdiv>\r
2554 <programlisting xml:id="component.label.includes.part.label.frag">&lt;xsl:param name="component.label.includes.part.label" select="0"&gt;&lt;/xsl:param&gt;</programlisting>\r
2555 </refsynopsisdiv>\r
2556 \r
2557 <refsection><info><title>Description</title></info>\r
2558 \r
2559 <para>If non-zero, number labels for <tag>chapter</tag>,\r
2560 <tag>appendix</tag>, and other component elements are prefixed with\r
2561 the label of the part element that contains them.  So you might see\r
2562 Chapter II.3 instead of Chapter 3.  Also, the labels for formal\r
2563 elements such as <tag>table</tag> and <tag>figure</tag> will include\r
2564 the part label.  If there is no part element container, then no prefix\r
2565 is generated.\r
2566 </para>\r
2567 <para>\r
2568 This feature is most useful when the\r
2569 <parameter>label.from.part</parameter> parameter is turned on.\r
2570 In that case, there would be more than one <tag>chapter</tag>\r
2571 <quote>1</quote>, and the extra part label prefix will identify\r
2572 each chapter unambiguously.\r
2573 </para>\r
2574 \r
2575 </refsection>\r
2576 </refentry>\r
2577 \r
2578 </reference>\r
2579 <reference xml:id="xslt"><title>XSLT Processing</title>\r
2580 <refentry version="5.0" xml:id="rootid">\r
2581 <refmeta>\r
2582 <refentrytitle>rootid</refentrytitle>\r
2583 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
2584 </refmeta>\r
2585 <refnamediv>\r
2586 <refname>rootid</refname>\r
2587 <refpurpose>Specify the root element to format</refpurpose>\r
2588 </refnamediv>\r
2589 \r
2590 <refsynopsisdiv>\r
2591 <programlisting xml:id="rootid.frag">\r
2592 &lt;xsl:param name="rootid"&gt;&lt;/xsl:param&gt;</programlisting>\r
2593 </refsynopsisdiv>\r
2594 \r
2595 <refsection><info><title>Description</title></info>\r
2596 \r
2597 <para>If <parameter>rootid</parameter> is not empty, it must be the\r
2598 value of an ID that occurs in the document being formatted. The entire\r
2599 document will be loaded and parsed, but formatting will begin at the\r
2600 element identified, rather than at the root. For example, this allows\r
2601 you to process only <tag>chapter</tag> 4 of a <tag>book</tag>.</para>\r
2602 <para>Because the entire document is available to the processor, automatic\r
2603 numbering, cross references, and other dependencies are correctly\r
2604 resolved.</para>\r
2605 \r
2606 </refsection>\r
2607 </refentry>\r
2608 \r
2609 </reference>\r
2610 <reference xml:id="meta"><title>Meta/*Info</title>\r
2611 <refentry version="5.0" xml:id="make.single.year.ranges">\r
2612 <refmeta>\r
2613 <refentrytitle>make.single.year.ranges</refentrytitle>\r
2614 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
2615 </refmeta>\r
2616 <refnamediv>\r
2617 <refname>make.single.year.ranges</refname>\r
2618 <refpurpose>Print single-year ranges (e.g., 1998-1999)</refpurpose>\r
2619 </refnamediv>\r
2620 \r
2621 <refsynopsisdiv>\r
2622 <programlisting xml:id="make.single.year.ranges.frag">\r
2623 &lt;xsl:param name="make.single.year.ranges" select="0"&gt;&lt;/xsl:param&gt;</programlisting>\r
2624 </refsynopsisdiv>\r
2625 \r
2626 <refsection><info><title>Description</title></info>\r
2627 \r
2628 <para>If non-zero, year ranges that span a single year will be printed\r
2629 in range notation (1998-1999) instead of discrete notation\r
2630 (1998, 1999).</para>\r
2631 \r
2632 </refsection>\r
2633 </refentry>\r
2634 \r
2635 <refentry version="5.0" xml:id="make.year.ranges">\r
2636 <refmeta>\r
2637 <refentrytitle>make.year.ranges</refentrytitle>\r
2638 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
2639 </refmeta>\r
2640 <refnamediv>\r
2641 <refname>make.year.ranges</refname>\r
2642 <refpurpose>Collate copyright years into ranges?</refpurpose>\r
2643 </refnamediv>\r
2644 \r
2645 <refsynopsisdiv>\r
2646 <programlisting xml:id="make.year.ranges.frag">&lt;xsl:param name="make.year.ranges" select="0"&gt;&lt;/xsl:param&gt;</programlisting>\r
2647 </refsynopsisdiv>\r
2648 \r
2649 <refsection><info><title>Description</title></info>\r
2650 \r
2651 <para>If non-zero, multiple copyright <tag>year</tag> elements will be\r
2652 collated into ranges.\r
2653 This works only if each year number is put into a separate\r
2654 year element.  The copyright element permits multiple\r
2655 year elements. If a year element contains a dash or\r
2656 a comma, then that year element will not be merged into\r
2657 any range.\r
2658 </para>\r
2659 \r
2660 </refsection>\r
2661 </refentry>\r
2662 \r
2663 <refentry version="5.0" xml:id="author.othername.in.middle">\r
2664 <refmeta>\r
2665 <refentrytitle>author.othername.in.middle</refentrytitle>\r
2666 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
2667 </refmeta>\r
2668 <refnamediv>\r
2669 <refname>author.othername.in.middle</refname>\r
2670 <refpurpose>Is <tag>othername</tag> in <tag>author</tag> a\r
2671 middle name?</refpurpose>\r
2672 </refnamediv>\r
2673 \r
2674 <refsynopsisdiv>\r
2675 <programlisting xml:id="author.othername.in.middle.frag">\r
2676 &lt;xsl:param name="author.othername.in.middle" select="1"&gt;&lt;/xsl:param&gt;</programlisting>\r
2677 </refsynopsisdiv>\r
2678 \r
2679 <refsection><info><title>Description</title></info>\r
2680 \r
2681 <para>If non-zero, the <tag>othername</tag> of an <tag>author</tag>\r
2682 appears between the <tag>firstname</tag> and\r
2683 <tag>surname</tag>.  Otherwise, <tag>othername</tag>\r
2684 is suppressed.\r
2685 </para>\r
2686 \r
2687 </refsection>\r
2688 </refentry>\r
2689 \r
2690 </reference>\r
2691 <reference xml:id="refentry"><title>Reference Pages</title>\r
2692 <refentry version="5.0" xml:id="funcsynopsis.decoration">\r
2693 <refmeta>\r
2694 <refentrytitle>funcsynopsis.decoration</refentrytitle>\r
2695 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
2696 </refmeta>\r
2697 <refnamediv>\r
2698 <refname>funcsynopsis.decoration</refname>\r
2699 <refpurpose>Decorate elements of a <tag>funcsynopsis</tag>?</refpurpose>\r
2700 </refnamediv>\r
2701 \r
2702 <refsynopsisdiv>\r
2703 <programlisting xml:id="funcsynopsis.decoration.frag">\r
2704 &lt;xsl:param name="funcsynopsis.decoration" select="1"&gt;&lt;/xsl:param&gt;\r
2705 </programlisting>\r
2706 </refsynopsisdiv>\r
2707 \r
2708 <refsection><info><title>Description</title></info>\r
2709 \r
2710 <para>If non-zero, elements of the <tag>funcsynopsis</tag> will be\r
2711 decorated (e.g. rendered as bold or italic text). The decoration is controlled by\r
2712 templates that can be redefined in a customization layer.\r
2713 </para>\r
2714 \r
2715 </refsection>\r
2716 </refentry>\r
2717 \r
2718 <refentry version="5.0" xml:id="funcsynopsis.style">\r
2719 <refmeta>\r
2720 <refentrytitle>funcsynopsis.style</refentrytitle>\r
2721 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>\r
2722 <refmiscinfo class="other" otherclass="value">ansi</refmiscinfo>\r
2723 <refmiscinfo class="other" otherclass="value">kr</refmiscinfo>\r
2724 </refmeta>\r
2725 <refnamediv>\r
2726 <refname>funcsynopsis.style</refname>\r
2727 <refpurpose>What style of <tag>funcsynopsis</tag> should be generated?</refpurpose>\r
2728 </refnamediv>\r
2729 \r
2730 <refsynopsisdiv>\r
2731 <programlisting xml:id="funcsynopsis.style.frag">&lt;xsl:param name="funcsynopsis.style"&gt;kr&lt;/xsl:param&gt;</programlisting>\r
2732 </refsynopsisdiv>\r
2733 \r
2734 <refsection><info><title>Description</title></info>\r
2735 \r
2736 <para>If <parameter>funcsynopsis.style</parameter> is <literal>ansi</literal>,\r
2737 ANSI-style function synopses are generated for a\r
2738 <tag>funcsynopsis</tag>, otherwise K&amp;R-style\r
2739 function synopses are generated.\r
2740 </para>\r
2741 \r
2742 </refsection>\r
2743 </refentry>\r
2744 \r
2745 <refentry version="5.0" xml:id="function.parens">\r
2746 <refmeta>\r
2747 <refentrytitle>function.parens</refentrytitle>\r
2748 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
2749 </refmeta>\r
2750 <refnamediv>\r
2751 <refname>function.parens</refname>\r
2752 <refpurpose>Generate parens after a function?</refpurpose>\r
2753 </refnamediv>\r
2754 \r
2755 <refsynopsisdiv>\r
2756 <programlisting xml:id="function.parens.frag">\r
2757 &lt;xsl:param name="function.parens" select="0"&gt;&lt;/xsl:param&gt;\r
2758 </programlisting>\r
2759 </refsynopsisdiv>\r
2760 \r
2761 <refsection><info><title>Description</title></info>\r
2762 \r
2763 <para>If non-zero, the formatting of a <tag>function</tag> element\r
2764 will include generated parentheses.\r
2765 </para>\r
2766 \r
2767 </refsection>\r
2768 </refentry>\r
2769 \r
2770 <refentry version="5.0" xml:id="refentry.generate.name">\r
2771 <refmeta>\r
2772 <refentrytitle>refentry.generate.name</refentrytitle>\r
2773 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
2774 </refmeta>\r
2775 <refnamediv>\r
2776 <refname>refentry.generate.name</refname>\r
2777 <refpurpose>Output NAME header before <tag>refname</tag>s?</refpurpose>\r
2778 </refnamediv>\r
2779 \r
2780 <refsynopsisdiv>\r
2781 <programlisting xml:id="refentry.generate.name.frag">\r
2782 &lt;xsl:param name="refentry.generate.name" select="1"&gt;&lt;/xsl:param&gt;\r
2783 </programlisting>\r
2784 </refsynopsisdiv>\r
2785 \r
2786 <refsection><info><title>Description</title></info>\r
2787 \r
2788 <para>If non-zero, a "NAME" section title is output before the list\r
2789 of <tag>refname</tag>s. This parameter and\r
2790 <parameter>refentry.generate.title</parameter> are mutually\r
2791 exclusive. This means that if you change this parameter to zero, you\r
2792 should set <parameter>refentry.generate.title</parameter> to non-zero unless\r
2793 you want get quite strange output.\r
2794 </para>\r
2795 \r
2796 </refsection>\r
2797 </refentry>\r
2798 \r
2799 <refentry version="5.0" xml:id="refentry.generate.title">\r
2800 <refmeta>\r
2801 <refentrytitle>refentry.generate.title</refentrytitle>\r
2802 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
2803 </refmeta>\r
2804 <refnamediv>\r
2805 <refname>refentry.generate.title</refname>\r
2806 <refpurpose>Output title before <tag>refname</tag>s?</refpurpose>\r
2807 </refnamediv>\r
2808 \r
2809 <refsynopsisdiv>\r
2810 <programlisting xml:id="refentry.generate.title.frag">\r
2811 &lt;xsl:param name="refentry.generate.title" select="0"&gt;&lt;/xsl:param&gt;\r
2812 </programlisting>\r
2813 </refsynopsisdiv>\r
2814 \r
2815 <refsection><info><title>Description</title></info>\r
2816 \r
2817 <para>If non-zero, the reference page title or first name is\r
2818 output before the list of <tag>refname</tag>s. This parameter and\r
2819 <parameter>refentry.generate.name</parameter> are mutually exclusive.\r
2820 This means that if you change this parameter to non-zero, you\r
2821 should set <parameter>refentry.generate.name</parameter> to zero unless\r
2822 you want get quite strange output.</para>\r
2823 \r
2824 \r
2825 </refsection>\r
2826 </refentry>\r
2827 \r
2828 <refentry version="5.0" xml:id="refentry.pagebreak">\r
2829 <refmeta>\r
2830 <refentrytitle>refentry.pagebreak</refentrytitle>\r
2831 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
2832 </refmeta>\r
2833 <refnamediv>\r
2834 <refname>refentry.pagebreak</refname>\r
2835 <refpurpose>Start each refentry on a new page</refpurpose>\r
2836 </refnamediv>\r
2837 \r
2838 <refsynopsisdiv>\r
2839 <programlisting xml:id="refentry.pagebreak.frag">&lt;xsl:param name="refentry.pagebreak" select="1"&gt;&lt;/xsl:param&gt;</programlisting>\r
2840 </refsynopsisdiv>\r
2841 \r
2842 <refsection><info><title>Description</title></info>\r
2843 \r
2844 <para>If non-zero (the default), each <tag>refentry</tag>\r
2845 element will start on a new page.  If zero, a page\r
2846 break will not be generated between <tag>refentry</tag> elements.\r
2847 The exception is when the <tag>refentry</tag> elements are children of\r
2848 a <tag>part</tag> element, in which case the page breaks are always\r
2849 retained.  That is because a <tag>part</tag> element does not generate\r
2850 a page-sequence for its children, so each <tag>refentry</tag> must\r
2851 start its own page-sequence.\r
2852 </para>\r
2853 \r
2854 </refsection>\r
2855 </refentry>\r
2856 \r
2857 <refentry version="5.0" xml:id="refentry.title.properties">\r
2858 <refmeta>\r
2859 <refentrytitle>refentry.title.properties</refentrytitle>\r
2860 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
2861 </refmeta>\r
2862 <refnamediv>\r
2863 <refname>refentry.title.properties</refname>\r
2864 <refpurpose>Title properties for a refentry title</refpurpose>\r
2865 </refnamediv>\r
2866 \r
2867 <refsynopsisdiv>\r
2868 <programlisting xml:id="refentry.title.properties.frag">\r
2869 &lt;xsl:attribute-set name="refentry.title.properties"&gt;\r
2870   &lt;xsl:attribute name="font-family"&gt;\r
2871     &lt;xsl:value-of select="$title.font.family"&gt;&lt;/xsl:value-of&gt;\r
2872   &lt;/xsl:attribute&gt;\r
2873   &lt;xsl:attribute name="font-size"&gt;18pt&lt;/xsl:attribute&gt;\r
2874   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;\r
2875   &lt;xsl:attribute name="space-after"&gt;1em&lt;/xsl:attribute&gt;\r
2876   &lt;xsl:attribute name="hyphenate"&gt;false&lt;/xsl:attribute&gt;\r
2877   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;\r
2878   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;\r
2879   &lt;xsl:attribute name="space-before.optimum"&gt;1.0em&lt;/xsl:attribute&gt;\r
2880   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;\r
2881   &lt;xsl:attribute name="space-after.optimum"&gt;0.5em&lt;/xsl:attribute&gt;\r
2882   &lt;xsl:attribute name="space-after.minimum"&gt;0.4em&lt;/xsl:attribute&gt;\r
2883   &lt;xsl:attribute name="space-after.maximum"&gt;0.6em&lt;/xsl:attribute&gt;\r
2884   &lt;xsl:attribute name="start-indent"&gt;&lt;xsl:value-of select="$title.margin.left"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;\r
2885 &lt;/xsl:attribute-set&gt;\r
2886 </programlisting>\r
2887 </refsynopsisdiv>\r
2888 \r
2889 <refsection><info><title>Description</title></info>\r
2890 \r
2891 <para>Formatting properties applied to the title generated for the\r
2892 <tag>refnamediv</tag> part of output for\r
2893 <tag>refentry</tag> when the value of the\r
2894 <parameter>refentry.generate.title</parameter> parameter is\r
2895 non-zero. The font size is supplied by the appropriate <parameter>section.level<replaceable>X</replaceable>.title.properties</parameter>\r
2896 attribute-set, computed from the location of the\r
2897 <tag>refentry</tag> in the section hierarchy.</para>\r
2898 \r
2899 <note>\r
2900   <para>This parameter has no effect on the the title generated for\r
2901   the <tag>refnamediv</tag> part of output for\r
2902   <tag>refentry</tag> when the value of the\r
2903   <parameter>refentry.generate.name</parameter> parameter is\r
2904   non-zero. By default, that title is formatted with the same\r
2905   properties as the titles for all other first-level children of\r
2906   <tag>refentry</tag>.</para>\r
2907 </note>\r
2908 \r
2909 </refsection>\r
2910 </refentry>\r
2911 \r
2912 <refentry version="5.0" xml:id="refentry.xref.manvolnum">\r
2913 <refmeta>\r
2914 <refentrytitle>refentry.xref.manvolnum</refentrytitle>\r
2915 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
2916 </refmeta>\r
2917 <refnamediv>\r
2918 <refname>refentry.xref.manvolnum</refname>\r
2919 <refpurpose>Output <tag>manvolnum</tag> as part of \r
2920 <tag>refentry</tag> cross-reference?</refpurpose>\r
2921 </refnamediv>\r
2922 \r
2923 <refsynopsisdiv>\r
2924 <programlisting xml:id="refentry.xref.manvolnum.frag">\r
2925 &lt;xsl:param name="refentry.xref.manvolnum" select="1"&gt;&lt;/xsl:param&gt;\r
2926 </programlisting>\r
2927 </refsynopsisdiv>\r
2928 \r
2929 <refsection><info><title>Description</title></info>\r
2930 \r
2931 <para>if non-zero, the <tag>manvolnum</tag> is used when cross-referencing\r
2932 <tag>refentry</tag>s, either with <tag>xref</tag>\r
2933 or <tag>citerefentry</tag>.\r
2934 </para>\r
2935 \r
2936 </refsection>\r
2937 </refentry>\r
2938 \r
2939 <refentry version="5.0" xml:id="refclass.suppress">\r
2940 <refmeta>\r
2941 <refentrytitle>refclass.suppress</refentrytitle>\r
2942 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
2943 </refmeta>\r
2944 <refnamediv>\r
2945 <refname>refclass.suppress</refname>\r
2946 <refpurpose>Suppress display of refclass contents?</refpurpose>\r
2947 </refnamediv>\r
2948 \r
2949 <refsynopsisdiv>\r
2950 <programlisting xml:id="refclass.suppress.frag">\r
2951 &lt;xsl:param name="refclass.suppress" select="0"&gt;&lt;/xsl:param&gt;</programlisting>\r
2952 </refsynopsisdiv>\r
2953 \r
2954 <refsection><info><title>Description</title></info>\r
2955 \r
2956 <para>If the value of <parameter>refclass.suppress</parameter> is\r
2957 non-zero, then display of <tag>refclass</tag> contents is\r
2958 suppressed in output.</para>\r
2959 \r
2960 </refsection>\r
2961 </refentry>\r
2962 \r
2963 </reference>\r
2964 <reference xml:id="tables"><title>Tables</title>\r
2965 <refentry version="5.0" xml:id="default.table.width">\r
2966 <refmeta>\r
2967 <refentrytitle>default.table.width</refentrytitle>\r
2968 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
2969 </refmeta>\r
2970 <refnamediv>\r
2971 <refname>default.table.width</refname>\r
2972 <refpurpose>The default width of tables</refpurpose>\r
2973 </refnamediv>\r
2974 <refsynopsisdiv>\r
2975 <programlisting xml:id="default.table.width.frag">\r
2976 &lt;xsl:param name="default.table.width"&gt;&lt;/xsl:param&gt;\r
2977 </programlisting>\r
2978 </refsynopsisdiv>\r
2979 <refsection><info><title>Description</title></info>\r
2980 <para>If non-zero, this value will be used for the\r
2981 <literal>width</literal> attribute on <tag>table</tag>s that do not specify an\r
2982 alternate width (with the <tag class="xmlpi">dbhtml table-width</tag> or \r
2983 <tag class="xmlpi">dbfo table-width</tag> processing instruction).</para>\r
2984 </refsection>\r
2985 </refentry>\r
2986 \r
2987 <refentry version="5.0" xml:id="nominal.table.width">\r
2988 <refmeta>\r
2989 <refentrytitle>nominal.table.width</refentrytitle>\r
2990 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
2991 </refmeta>\r
2992 <refnamediv>\r
2993 <refname>nominal.table.width</refname>\r
2994 <refpurpose>The (absolute) nominal width of tables</refpurpose>\r
2995 </refnamediv>\r
2996 \r
2997 <refsynopsisdiv>\r
2998 <programlisting xml:id="nominal.table.width.frag">\r
2999 &lt;xsl:param name="nominal.table.width"&gt;6in&lt;/xsl:param&gt;\r
3000 </programlisting>\r
3001 </refsynopsisdiv>\r
3002 \r
3003 <refsection><info><title>Description</title></info>\r
3004 \r
3005 <para>In order to convert CALS column widths into HTML column widths, it\r
3006 is sometimes necessary to have an absolute table width to use for conversion\r
3007 of mixed absolute and relative widths. This value must be an absolute\r
3008 length (not a percentage).</para>\r
3009 \r
3010 </refsection>\r
3011 </refentry>\r
3012 \r
3013 <refentry version="5.0" xml:id="default.table.frame">\r
3014 <refmeta>\r
3015 <refentrytitle>default.table.frame</refentrytitle>\r
3016 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
3017 </refmeta>\r
3018 <refnamediv>\r
3019 <refname>default.table.frame</refname>\r
3020 <refpurpose>The default framing of tables</refpurpose>\r
3021 </refnamediv>\r
3022 \r
3023 <refsynopsisdiv>\r
3024 <programlisting xml:id="default.table.frame.frag">\r
3025 &lt;xsl:param name="default.table.frame"&gt;all&lt;/xsl:param&gt;\r
3026 </programlisting>\r
3027 </refsynopsisdiv>\r
3028 \r
3029 <refsection><info><title>Description</title></info>\r
3030 \r
3031 <para>This value will be used when there is no frame attribute on the\r
3032 table. </para>\r
3033 \r
3034 </refsection>\r
3035 </refentry>\r
3036 \r
3037 <refentry version="5.0" xml:id="default.table.rules">\r
3038 <refmeta>\r
3039 <refentrytitle>default.table.rules</refentrytitle>\r
3040 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
3041 </refmeta>\r
3042 <refnamediv>\r
3043 <refname>default.table.rules</refname>\r
3044 <refpurpose>The default column and row rules for tables using HTML markup</refpurpose>\r
3045 </refnamediv>\r
3046 \r
3047 <refsynopsisdiv>\r
3048 <programlisting xml:id="default.table.rules.frag">\r
3049 &lt;xsl:param name="default.table.rules"&gt;none&lt;/xsl:param&gt;\r
3050 </programlisting>\r
3051 </refsynopsisdiv>\r
3052 \r
3053 <refsection><info><title>Description</title></info>\r
3054 \r
3055 <para>Tables using HTML markup elements can use an attribute\r
3056 named <tag class="attribute">rules</tag> on the <tag>table</tag> or\r
3057 <tag>informaltable</tag> element\r
3058 to specify whether column and row border rules should be \r
3059 displayed. This parameter lets you specify a global default\r
3060 style for all HTML tables that don't otherwise have\r
3061 that attribute.</para>\r
3062 <para>These are the supported values:</para>\r
3063 \r
3064 <variablelist>\r
3065 <varlistentry><term>all</term>\r
3066 <listitem>\r
3067 <para>Rules will appear between all rows and columns.</para>\r
3068 </listitem>\r
3069 </varlistentry>\r
3070 \r
3071 <varlistentry><term>rows</term>\r
3072 <listitem>\r
3073 <para>Rules will appear between rows only.</para>\r
3074 </listitem>\r
3075 </varlistentry>\r
3076 \r
3077 <varlistentry><term>cols</term>\r
3078 <listitem>\r
3079 <para>Rules will appear between columns only.</para>\r
3080 </listitem>\r
3081 </varlistentry>\r
3082 \r
3083 <varlistentry><term>groups</term>\r
3084 <listitem>\r
3085 <para>Rules will appear between row groups (thead, tfoot, tbody).\r
3086 No support for rules between column groups yet.\r
3087 </para>\r
3088 </listitem>\r
3089 </varlistentry>\r
3090 \r
3091 <varlistentry><term>none</term>\r
3092 <listitem>\r
3093 <para>No rules.  This is the default value.\r
3094 </para>\r
3095 </listitem>\r
3096 </varlistentry>\r
3097 \r
3098 </variablelist>\r
3099 \r
3100 <para>The border after the last row and the border after\r
3101 the last column are not affected by\r
3102 this setting. Those borders are controlled by\r
3103 the <tag class="attribute">frame</tag> attribute on the table element.\r
3104 </para>\r
3105 \r
3106 </refsection>\r
3107 </refentry>\r
3108 \r
3109 <refentry version="5.0" xml:id="table.cell.padding">\r
3110 <refmeta>\r
3111 <refentrytitle>table.cell.padding</refentrytitle>\r
3112 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
3113 </refmeta>\r
3114 <refnamediv>\r
3115 <refname>table.cell.padding</refname>\r
3116 <refpurpose>Specifies the padding of table cells</refpurpose>\r
3117 </refnamediv>\r
3118 \r
3119 <refsynopsisdiv>\r
3120 <programlisting xml:id="table.cell.padding.frag">\r
3121 &lt;xsl:attribute-set name="table.cell.padding"&gt;\r
3122   &lt;xsl:attribute name="padding-start"&gt;2pt&lt;/xsl:attribute&gt;\r
3123   &lt;xsl:attribute name="padding-end"&gt;2pt&lt;/xsl:attribute&gt;\r
3124   &lt;xsl:attribute name="padding-top"&gt;2pt&lt;/xsl:attribute&gt;\r
3125   &lt;xsl:attribute name="padding-bottom"&gt;2pt&lt;/xsl:attribute&gt;\r
3126 &lt;/xsl:attribute-set&gt;\r
3127 </programlisting>\r
3128 </refsynopsisdiv>\r
3129 \r
3130 <refsection><info><title>Description</title></info>\r
3131 \r
3132 <para>Specifies the padding of table cells.</para>\r
3133 \r
3134 </refsection>\r
3135 </refentry>\r
3136 \r
3137 <refentry version="5.0" xml:id="table.frame.border.thickness">\r
3138 <refmeta>\r
3139 <refentrytitle>table.frame.border.thickness</refentrytitle>\r
3140 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
3141 </refmeta>\r
3142 <refnamediv>\r
3143 <refname>table.frame.border.thickness</refname>\r
3144 <refpurpose>Specifies the thickness of the frame border</refpurpose>\r
3145 </refnamediv>\r
3146 \r
3147 <refsynopsisdiv>\r
3148 <programlisting xml:id="table.frame.border.thickness.frag">\r
3149 &lt;xsl:param name="table.frame.border.thickness"&gt;0.5pt&lt;/xsl:param&gt;\r
3150 </programlisting>\r
3151 </refsynopsisdiv>\r
3152 \r
3153 <refsection><info><title>Description</title></info>\r
3154 \r
3155 <para>Specifies the thickness of the border on the table's frame.</para>\r
3156 \r
3157 </refsection>\r
3158 </refentry>\r
3159 \r
3160 <refentry version="5.0" xml:id="table.frame.border.style">\r
3161 <refmeta>\r
3162 <refentrytitle>table.frame.border.style</refentrytitle>\r
3163 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> \r
3164 <refmiscinfo class="other" otherclass="value">none</refmiscinfo>\r
3165 <refmiscinfo class="other" otherclass="value">solid</refmiscinfo>\r
3166 <refmiscinfo class="other" otherclass="value">dotted</refmiscinfo>\r
3167 <refmiscinfo class="other" otherclass="value">dashed</refmiscinfo>\r
3168 <refmiscinfo class="other" otherclass="value">double</refmiscinfo>\r
3169 <refmiscinfo class="other" otherclass="value">groove</refmiscinfo>                       \r
3170 <refmiscinfo class="other" otherclass="value">ridge</refmiscinfo>\r
3171 <refmiscinfo class="other" otherclass="value">inset</refmiscinfo>\r
3172 <refmiscinfo class="other" otherclass="value">outset</refmiscinfo>          \r
3173 <refmiscinfo class="other" otherclass="value">solid</refmiscinfo>\r
3174 </refmeta>\r
3175 <refnamediv>\r
3176 <refname>table.frame.border.style</refname>\r
3177 <refpurpose>Specifies the border style of table frames</refpurpose>\r
3178 </refnamediv>\r
3179 \r
3180 <refsynopsisdiv>\r
3181 <programlisting xml:id="table.frame.border.style.frag">\r
3182 &lt;xsl:param name="table.frame.border.style"&gt;solid&lt;/xsl:param&gt;\r
3183 </programlisting>\r
3184 </refsynopsisdiv>\r
3185 \r
3186 <refsection><info><title>Description</title></info>\r
3187 \r
3188 <para>Specifies the border style of table frames.</para>\r
3189 \r
3190 </refsection>\r
3191 </refentry>\r
3192 \r
3193 <refentry version="5.0" xml:id="table.frame.border.color">\r
3194 <refmeta>\r
3195 <refentrytitle>table.frame.border.color</refentrytitle>\r
3196 <refmiscinfo class="other" otherclass="datatype">color</refmiscinfo>\r
3197 </refmeta>\r
3198 <refnamediv>\r
3199 <refname>table.frame.border.color</refname>\r
3200 <refpurpose>Specifies the border color of table frames</refpurpose>\r
3201 </refnamediv>\r
3202 \r
3203 <refsynopsisdiv>\r
3204 <programlisting xml:id="table.frame.border.color.frag">\r
3205 \r
3206 &lt;xsl:param name="table.frame.border.color"&gt;black&lt;/xsl:param&gt;\r
3207 </programlisting>\r
3208 </refsynopsisdiv>\r
3209 \r
3210 <refsection><info><title>Description</title></info>\r
3211 \r
3212 <para>Specifies the border color of table frames.</para>\r
3213 \r
3214 </refsection>\r
3215 </refentry>\r
3216 \r
3217 <refentry version="5.0" xml:id="table.cell.border.thickness">\r
3218 <refmeta>\r
3219 <refentrytitle>table.cell.border.thickness</refentrytitle>\r
3220 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
3221 </refmeta>\r
3222 <refnamediv>\r
3223 <refname>table.cell.border.thickness</refname>\r
3224 <refpurpose>Specifies the thickness of table cell borders</refpurpose>\r
3225 </refnamediv>\r
3226 \r
3227 <refsynopsisdiv>\r
3228 <programlisting xml:id="table.cell.border.thickness.frag">\r
3229 &lt;xsl:param name="table.cell.border.thickness"&gt;0.5pt&lt;/xsl:param&gt;\r
3230 </programlisting>\r
3231 </refsynopsisdiv>\r
3232 \r
3233 <refsection><info><title>Description</title></info>\r
3234 \r
3235 <para>If non-zero, specifies the thickness of borders on table\r
3236 cells. The units are points. See <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.w3.org/TR/CSS21/box.html#border-width-properties">\r
3237 CSS</link></para>\r
3238 \r
3239 <note>\r
3240   <para>To control properties of cell borders in HTML output, you must also turn on the \r
3241   <parameter>table.borders.with.css</parameter> parameter.</para>\r
3242 </note>\r
3243 \r
3244 </refsection>\r
3245 </refentry>\r
3246 \r
3247 <refentry version="5.0" xml:id="table.cell.border.style">\r
3248 <refmeta>\r
3249 <refentrytitle>table.cell.border.style</refentrytitle>\r
3250 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> \r
3251 <refmiscinfo class="other" otherclass="value">none</refmiscinfo>\r
3252 <refmiscinfo class="other" otherclass="value">solid</refmiscinfo>\r
3253 <refmiscinfo class="other" otherclass="value">dotted</refmiscinfo>\r
3254 <refmiscinfo class="other" otherclass="value">dashed</refmiscinfo>\r
3255 <refmiscinfo class="other" otherclass="value">double</refmiscinfo>\r
3256 <refmiscinfo class="other" otherclass="value">groove</refmiscinfo>                       \r
3257 <refmiscinfo class="other" otherclass="value">ridge</refmiscinfo>\r
3258 <refmiscinfo class="other" otherclass="value">inset</refmiscinfo>\r
3259 <refmiscinfo class="other" otherclass="value">outset</refmiscinfo>          \r
3260 <refmiscinfo class="other" otherclass="value">solid</refmiscinfo>\r
3261 </refmeta>\r
3262 <refnamediv>\r
3263 <refname>table.cell.border.style</refname>\r
3264 <refpurpose>Specifies the border style of table cells</refpurpose>\r
3265 </refnamediv>\r
3266 \r
3267 <refsynopsisdiv>\r
3268 <programlisting xml:id="table.cell.border.style.frag">\r
3269 &lt;xsl:param name="table.cell.border.style"&gt;solid&lt;/xsl:param&gt;\r
3270 </programlisting>\r
3271 </refsynopsisdiv>\r
3272 \r
3273 <refsection><info><title>Description</title></info>\r
3274 \r
3275 <para>Specifies the border style of table cells.</para>\r
3276 \r
3277 <note>\r
3278   <para>To control properties of cell borders in HTML output, you must also turn on the \r
3279   <parameter>table.borders.with.css</parameter> parameter.</para>\r
3280 </note>\r
3281 \r
3282 </refsection>\r
3283 </refentry>\r
3284 \r
3285 <refentry version="5.0" xml:id="table.cell.border.color">\r
3286 <refmeta>\r
3287 <refentrytitle>table.cell.border.color</refentrytitle>\r
3288 <refmiscinfo class="other" otherclass="datatype">color</refmiscinfo>\r
3289 </refmeta>\r
3290 <refnamediv>\r
3291 <refname>table.cell.border.color</refname>\r
3292 <refpurpose>Specifies the border color of table cells</refpurpose>\r
3293 </refnamediv>\r
3294 \r
3295 <refsynopsisdiv>\r
3296 <programlisting xml:id="table.cell.border.color.frag">\r
3297 \r
3298 &lt;xsl:param name="table.cell.border.color"&gt;black&lt;/xsl:param&gt;\r
3299 </programlisting>\r
3300 </refsynopsisdiv>\r
3301 \r
3302 <refsection><info><title>Description</title></info>\r
3303 \r
3304 <para>Set the color of table cell borders. If non-zero, the value is used\r
3305 for the border coloration. See <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.w3.org/TR/CSS21/syndata.html#value-def-color">CSS</link>. A\r
3306 <literal>color</literal> is either a keyword or a numerical RGB specification.\r
3307 Keywords are aqua, black, blue, fuchsia, gray, green, lime, maroon,\r
3308 navy, olive, orange, purple, red, silver, teal, white, and\r
3309 yellow.</para>\r
3310 \r
3311 <note>\r
3312   <para>To control properties of cell borders in HTML output, you must also turn on the \r
3313   <parameter>table.borders.with.css</parameter> parameter.</para>\r
3314 </note>\r
3315 \r
3316 </refsection>\r
3317 </refentry>\r
3318 \r
3319 <refentry version="5.0" xml:id="table.table.properties">\r
3320 <refmeta>\r
3321 <refentrytitle>table.table.properties</refentrytitle>\r
3322 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
3323 </refmeta>\r
3324 <refnamediv>\r
3325 <refname>table.table.properties</refname>\r
3326 <refpurpose>Properties associated with a table</refpurpose>\r
3327 </refnamediv>\r
3328 \r
3329 <refsynopsisdiv>\r
3330 <programlisting xml:id="table.table.properties.frag">\r
3331 &lt;xsl:attribute-set name="table.table.properties"&gt;\r
3332   &lt;xsl:attribute name="border-before-width.conditionality"&gt;retain&lt;/xsl:attribute&gt;\r
3333   &lt;xsl:attribute name="border-collapse"&gt;collapse&lt;/xsl:attribute&gt;\r
3334 &lt;/xsl:attribute-set&gt;\r
3335 </programlisting>\r
3336 </refsynopsisdiv>\r
3337 \r
3338 <refsection><info><title>Description</title></info>\r
3339 \r
3340 <para>The styling for tables. This parameter should really\r
3341 have been called <literal>table.properties</literal>, but that parameter\r
3342 name was inadvertently established for the block-level properties\r
3343 of the table as a whole.\r
3344 </para>\r
3345 \r
3346 <para>See also <parameter>table.properties</parameter>.</para>\r
3347 \r
3348 </refsection>\r
3349 </refentry>\r
3350 \r
3351 </reference>\r
3352 <reference xml:id="links"><title>Linking</title>\r
3353 <refentry version="5.0" xml:id="current.docid"> \r
3354 <refmeta> \r
3355 <refentrytitle>current.docid</refentrytitle> \r
3356 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo> \r
3357 </refmeta> \r
3358 <refnamediv> \r
3359 <refname>current.docid</refname> \r
3360 <refpurpose>targetdoc identifier for the document being\r
3361 processed</refpurpose> \r
3362 </refnamediv> \r
3363 <refsynopsisdiv> <programlisting xml:id="current.docid.frag">\r
3364 &lt;xsl:param name="current.docid"&gt;&lt;/xsl:param&gt;\r
3365 </programlisting> \r
3366 </refsynopsisdiv> \r
3367 <refsection><info><title>Description</title></info> \r
3368  \r
3369 <para>When olinks between documents are resolved for HTML output, the stylesheet can compute the relative path between the current document and the target document. The stylesheet needs to know the <literal>targetdoc</literal> identifiers for both documents, as they appear in the <parameter>target.database.document</parameter> database file. This parameter passes to the stylesheet\r
3370 the targetdoc identifier of the current document, since that\r
3371 identifier does not appear in the document itself. </para>\r
3372 <para>This parameter can also be used for print output. If an olink's  <literal>targetdoc</literal>  id differs from the <literal>current.docid</literal>, then the stylesheet can append the target document's title to the generated olink text. That identifies to the reader that the link is to a different document, not the current document. See also <parameter>olink.doctitle</parameter> to enable that feature.</para> \r
3373 </refsection> \r
3374 </refentry>\r
3375 \r
3376 <refentry version="5.0" xml:id="collect.xref.targets"> \r
3377 <refmeta> \r
3378 <refentrytitle>collect.xref.targets</refentrytitle> \r
3379 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> \r
3380 <refmiscinfo class="other" otherclass="value">no</refmiscinfo>\r
3381 <refmiscinfo class="other" otherclass="value">yes</refmiscinfo>\r
3382 <refmiscinfo class="other" otherclass="value">only</refmiscinfo>\r
3383 </refmeta> \r
3384 <refnamediv> \r
3385 <refname>collect.xref.targets</refname> \r
3386 <refpurpose>Controls whether cross reference data is\r
3387 collected</refpurpose> \r
3388 </refnamediv> \r
3389 <refsynopsisdiv> <programlisting xml:id="collect.xref.targets.frag">\r
3390 &lt;xsl:param name="collect.xref.targets"&gt;no&lt;/xsl:param&gt;\r
3391 </programlisting> \r
3392 </refsynopsisdiv> \r
3393 <refsection><info><title>Description</title></info> \r
3394  \r
3395 <para>\r
3396 In order to resolve olinks efficiently, the stylesheets can\r
3397 generate an external data file containing information about\r
3398 all potential cross reference endpoints in a document.\r
3399 This parameter determines whether the collection process is run when the document is processed by the stylesheet. The default value is  <literal>no</literal>, which means the data file is not generated during processing. The other choices are <literal>yes</literal>, which means the data file is created and the document is processed for output, and <literal>only</literal>, which means the data file is created but the document is not processed for output.\r
3400 See also <parameter>targets.filename</parameter>.\r
3401 </para> \r
3402 </refsection> \r
3403 </refentry>\r
3404 \r
3405 <refentry version="5.0" xml:id="insert.olink.page.number">\r
3406 <refmeta>\r
3407 <refentrytitle>insert.olink.page.number</refentrytitle>\r
3408 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> \r
3409 <refmiscinfo class="other" otherclass="value">no</refmiscinfo>\r
3410 <refmiscinfo class="other" otherclass="value">yes</refmiscinfo>\r
3411 <refmiscinfo class="other" otherclass="value">maybe</refmiscinfo>\r
3412 </refmeta>\r
3413 <refnamediv>\r
3414 <refname>insert.olink.page.number</refname>\r
3415 <refpurpose>Turns page numbers in olinks on and off</refpurpose>\r
3416 </refnamediv>\r
3417 \r
3418 <refsynopsisdiv>\r
3419 <programlisting xml:id="insert.olink.page.number.frag">\r
3420 &lt;xsl:param name="insert.olink.page.number"&gt;no&lt;/xsl:param&gt;\r
3421 </programlisting>\r
3422 </refsynopsisdiv>\r
3423 \r
3424 <refsection><info><title>Description</title></info>\r
3425 \r
3426 <para>The value of this parameter determines if\r
3427 cross references made between documents with\r
3428 <tag>olink</tag> will \r
3429 include page number citations.\r
3430 In most cases this is only applicable to references in printed output.\r
3431 </para>\r
3432 <para>The parameter has three possible values.\r
3433 </para>\r
3434 <variablelist>\r
3435 <varlistentry>\r
3436 <term>no</term>\r
3437 <listitem><para>No page number references will be generated for olinks.\r
3438 </para></listitem>\r
3439 </varlistentry>\r
3440 <varlistentry>\r
3441 <term>yes</term>\r
3442 <listitem><para>Page number references will be generated\r
3443 for all <tag>olink</tag> references.\r
3444 The style of page reference may be changed\r
3445 if an <tag class="attribute">xrefstyle</tag>\r
3446 attribute is used.\r
3447 </para></listitem>\r
3448 </varlistentry>\r
3449 <varlistentry>\r
3450 <term>maybe</term>\r
3451 <listitem><para>Page number references will not be generated\r
3452 for an <tag>olink</tag> element unless \r
3453 it has an\r
3454 <tag class="attribute">xrefstyle</tag>\r
3455 attribute whose value specifies a page reference.\r
3456 </para></listitem>\r
3457 </varlistentry>\r
3458 </variablelist>\r
3459 <para>Olinks that point to targets within the same document\r
3460 are treated as <tag>xref</tag>s, and controlled by\r
3461 the <parameter>insert.xref.page.number</parameter> parameter.\r
3462 </para>\r
3463 \r
3464 <para>Page number references for olinks to\r
3465 external documents can only be inserted if the \r
3466 information exists in the olink database. \r
3467 This means each olink target element \r
3468 (<tag>div</tag> or <tag>obj</tag>)\r
3469 must have a <tag class="attribute">page</tag> attribute\r
3470 whose value is its page number in the target document.\r
3471 The XSL stylesheets are not able to extract that information\r
3472 during processing because pages have not yet been created in\r
3473 XSLT transformation.  Only the XSL-FO processor knows what\r
3474 page each element is placed on.\r
3475 Therefore some postprocessing must take place to populate\r
3476 page numbers in the olink database.\r
3477 </para>\r
3478 \r
3479 \r
3480 \r
3481 </refsection>\r
3482 </refentry>\r
3483 \r
3484 <refentry version="5.0" xml:id="insert.olink.pdf.frag">\r
3485 <refmeta>\r
3486 <refentrytitle>insert.olink.pdf.frag</refentrytitle>\r
3487 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
3488 </refmeta>\r
3489 <refnamediv>\r
3490 <refname>insert.olink.pdf.frag</refname>\r
3491 <refpurpose>Add fragment identifiers for links into PDF files</refpurpose>\r
3492 </refnamediv>\r
3493 \r
3494 <refsynopsisdiv>\r
3495 <programlisting xml:id="insert.olink.pdf.frag.frag">\r
3496 &lt;xsl:param name="insert.olink.pdf.frag" select="0"&gt;&lt;/xsl:param&gt;\r
3497 </programlisting>\r
3498 </refsynopsisdiv>\r
3499 \r
3500 <refsection><info><title>Description</title></info>\r
3501 \r
3502 <para>The value of this parameter determines whether\r
3503 the cross reference URIs to PDF documents made with\r
3504 <tag>olink</tag> will \r
3505 include fragment identifiers.\r
3506 </para>\r
3507 \r
3508 <para>When forming a URI to link to a PDF document,\r
3509 a fragment identifier (typically a '#' followed by an\r
3510 id value) appended to the PDF filename can be used by\r
3511 the PDF viewer to open\r
3512 the PDF file to a location within the document instead of\r
3513 the first page.\r
3514 However, not all PDF files have id\r
3515 values embedded in them, and not all PDF viewers can\r
3516 handle fragment identifiers. \r
3517 </para>\r
3518 \r
3519 <para>If <parameter>insert.olink.pdf.frag</parameter> is set\r
3520 to a non-zero value, then any olink targeting a\r
3521 PDF file will have the fragment identifier appended to the URI.\r
3522 The URI is formed by concatenating the value of the\r
3523 <parameter>olink.base.uri</parameter> parameter, the\r
3524 value of the <tag class="attribute">baseuri</tag>\r
3525 attribute from the <tag class="element">document</tag>\r
3526 element in the olink database with the matching\r
3527 <tag class="attribute">targetdoc</tag> value,\r
3528 and the value of the <tag class="attribute">href</tag>\r
3529 attribute for the targeted element in the olink database.\r
3530 The <tag class="attribute">href</tag> attribute\r
3531 contains the fragment identifier.\r
3532 </para>\r
3533 \r
3534 <para>If <parameter>insert.olink.pdf.frag</parameter> is set\r
3535 to zero (the default value), then \r
3536 the <tag class="attribute">href</tag> attribute\r
3537 from the olink database\r
3538 is not appended to PDF olinks, so the fragment identifier is left off.\r
3539 A PDF olink is any olink for which the\r
3540 <tag class="attribute">baseuri</tag> attribute\r
3541 from the matching <tag class="element">document</tag>\r
3542 element in the olink database ends with '.pdf'.\r
3543 Any other olinks will still have the fragment identifier added.\r
3544 </para>\r
3545 </refsection>\r
3546 </refentry>\r
3547 \r
3548 <refentry version="5.0" xml:id="olink.base.uri"> \r
3549 <refmeta> \r
3550 <refentrytitle>olink.base.uri</refentrytitle> \r
3551 <refmiscinfo class="other" otherclass="datatype">uri</refmiscinfo> \r
3552 </refmeta> \r
3553 <refnamediv> \r
3554 <refname>olink.base.uri</refname> \r
3555 <refpurpose>Base URI used in olink hrefs</refpurpose> \r
3556 </refnamediv> \r
3557 <refsynopsisdiv> <programlisting xml:id="olink.base.uri.frag">\r
3558 &lt;xsl:param name="olink.base.uri"&gt;&lt;/xsl:param&gt;\r
3559 </programlisting> \r
3560 </refsynopsisdiv> \r
3561 <refsection><info><title>Description</title></info> \r
3562  \r
3563 <para>When cross reference data is collected for resolving olinks, it\r
3564 may be necessary to prepend a base URI to each target's href. This\r
3565 parameter lets you set that base URI when cross reference data is\r
3566 collected. This feature is needed when you want to link to a document\r
3567 that is processed without chunking. The output filename for such a\r
3568 document is not known to the XSL stylesheet; the only target\r
3569 information consists of fragment identifiers such as\r
3570 <literal>#idref</literal>. To enable the resolution of olinks between\r
3571 documents, you should pass the name of the HTML output file as the\r
3572 value of this parameter. Then the hrefs recorded in the cross\r
3573 reference data collection look like\r
3574 <literal>outfile.html#idref</literal>, which can be reached as links\r
3575 from other documents.</para>\r
3576 </refsection> \r
3577 </refentry>\r
3578 \r
3579 <refentry version="5.0" xml:id="olink.debug">\r
3580 <refmeta>\r
3581 <refentrytitle>olink.debug</refentrytitle>\r
3582 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
3583 </refmeta>\r
3584 <refnamediv>\r
3585 <refname>olink.debug</refname>\r
3586 <refpurpose>Turn on debugging messages for olinks</refpurpose>\r
3587 </refnamediv>\r
3588 \r
3589 <refsynopsisdiv>\r
3590 <programlisting xml:id="olink.debug.frag">\r
3591 &lt;xsl:param name="olink.debug" select="0"&gt;&lt;/xsl:param&gt;\r
3592 </programlisting>\r
3593 </refsynopsisdiv>\r
3594 \r
3595 <refsection><info><title>Description</title></info>\r
3596 \r
3597 <para>If non-zero, then each olink will generate several\r
3598 messages about how it is being resolved during processing.\r
3599 This is useful when an olink does not resolve properly\r
3600 and the standard error messages are not sufficient to\r
3601 find the problem. \r
3602 </para>\r
3603 \r
3604 <para>You may need to read through the olink XSL templates\r
3605 to understand the context for some of the debug messages.\r
3606 </para>\r
3607 \r
3608 </refsection>\r
3609 </refentry>\r
3610 \r
3611 <refentry version="5.0" xml:id="olink.doctitle"> \r
3612 <refmeta> \r
3613 <refentrytitle>olink.doctitle</refentrytitle> \r
3614 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> \r
3615 <refmiscinfo class="other" otherclass="value">no</refmiscinfo>\r
3616 <refmiscinfo class="other" otherclass="value">yes</refmiscinfo>\r
3617 <refmiscinfo class="other" otherclass="value">maybe</refmiscinfo>\r
3618 </refmeta> \r
3619 <refnamediv> \r
3620 <refname>olink.doctitle</refname> \r
3621 <refpurpose>show the document title for external olinks?</refpurpose>\r
3622 \r
3623 </refnamediv> \r
3624 <refsynopsisdiv> <programlisting xml:id="olink.doctitle.frag">\r
3625 &lt;xsl:param name="olink.doctitle"&gt;no&lt;/xsl:param&gt; \r
3626 </programlisting> \r
3627 </refsynopsisdiv> \r
3628 <refsection><info><title>Description</title></info> \r
3629  \r
3630 <para>When olinks between documents are resolved, the generated text\r
3631 may not make it clear that the reference is to another document.\r
3632 It is possible for the stylesheets to append the other document's\r
3633 title to external olinks. For this to happen, two parameters must\r
3634 be set.</para>\r
3635 <itemizedlist>\r
3636 <listitem>\r
3637 <para>This <parameter>olink.doctitle</parameter> parameter\r
3638 should be set to either <literal>yes</literal> or <literal>maybe</literal>\r
3639 to enable this feature.\r
3640 </para>\r
3641 </listitem>\r
3642 <listitem>\r
3643 <para>And you should also set the <parameter>current.docid</parameter>\r
3644 parameter to the document id for the  document currently\r
3645 being processed for output.\r
3646 </para>\r
3647 </listitem>\r
3648 </itemizedlist>\r
3649 \r
3650 <para>\r
3651 Then if an olink's  <literal>targetdoc</literal> id differs from\r
3652 the <literal>current.docid</literal> value, the stylesheet knows\r
3653 that it is a reference to another document and can\r
3654 append the target document's\r
3655 title to the generated olink text. </para> \r
3656 \r
3657 <para>The text for the target document's title is copied from the\r
3658 olink database from the <tag>ttl</tag> element\r
3659 of the top-level <tag>div</tag> for that document.\r
3660 If that <tag>ttl</tag> element is missing or empty,\r
3661 no title is output.\r
3662 </para>\r
3663 \r
3664 <para>The supported values for <parameter>olink.doctitle</parameter> are:\r
3665 </para>\r
3666 <variablelist>\r
3667 <varlistentry>\r
3668 <term><literal>yes</literal></term>\r
3669 <listitem>\r
3670 <para>\r
3671 Always insert the title to the target document if it is not\r
3672 the current document.\r
3673 </para>\r
3674 </listitem>\r
3675 </varlistentry>\r
3676 <varlistentry>\r
3677 <term><literal>no</literal></term>\r
3678 <listitem>\r
3679 <para>\r
3680 Never insert the title to the target document, even if requested\r
3681 in an <tag class="attribute">xrefstyle</tag> attribute.\r
3682 </para>\r
3683 </listitem>\r
3684 </varlistentry>\r
3685 <varlistentry>\r
3686 <term><literal>maybe</literal></term>\r
3687 <listitem>\r
3688 <para>\r
3689 Only insert the title to the target document, if requested\r
3690 in an <tag class="attribute">xrefstyle</tag> attribute.\r
3691 </para>\r
3692 </listitem>\r
3693 </varlistentry>\r
3694 </variablelist>\r
3695 <para>An <tag class="attribute">xrefstyle</tag> attribute\r
3696 may override the global setting for individual olinks.\r
3697 The following values are supported in an\r
3698 <tag class="attribute">xrefstyle</tag>\r
3699 attribute using the <literal>select:</literal> syntax:\r
3700 </para>\r
3701 \r
3702 <variablelist>\r
3703 <varlistentry>\r
3704 <term><literal>docname</literal></term>\r
3705 <listitem>\r
3706 <para>\r
3707 Insert the target document name for this olink using the\r
3708 <literal>docname</literal> gentext template, but only\r
3709 if the value of <parameter>olink.doctitle</parameter>\r
3710 is not <literal>no</literal>.\r
3711 </para>\r
3712 </listitem>\r
3713 </varlistentry>\r
3714 <varlistentry>\r
3715 <term><literal>docnamelong</literal></term>\r
3716 <listitem>\r
3717 <para>\r
3718 Insert the target document name for this olink using the\r
3719 <literal>docnamelong</literal> gentext template, but only\r
3720 if the value of <parameter>olink.doctitle</parameter>\r
3721 is not <literal>no</literal>.\r
3722 </para>\r
3723 </listitem>\r
3724 </varlistentry>\r
3725 <varlistentry>\r
3726 <term><literal>nodocname</literal></term>\r
3727 <listitem>\r
3728 <para>\r
3729 Omit the target document name even if\r
3730 the value of <parameter>olink.doctitle</parameter>\r
3731 is <literal>yes</literal>.\r
3732 </para>\r
3733 </listitem>\r
3734 </varlistentry>\r
3735 </variablelist>\r
3736 <para>Another way of inserting the target document name \r
3737 for a single olink is to employ an\r
3738 <tag class="attribute">xrefstyle</tag>\r
3739 attribute using the <literal>template:</literal> syntax.\r
3740 The <literal>%o</literal> placeholder (the letter o, not zero)\r
3741 in such a template\r
3742 will be filled in with the target document's title when it is processed.\r
3743 This will occur regardless of \r
3744 the value of <parameter>olink.doctitle</parameter>.\r
3745 </para>\r
3746 <para>Note that prior to version 1.66 of the XSL stylesheets,\r
3747 the allowed values for this parameter were 0 and 1.  Those\r
3748 values are still supported and mapped to 'no' and 'yes', respectively.\r
3749 </para>\r
3750 </refsection> \r
3751 </refentry>\r
3752 \r
3753 <refentry version="5.0" xml:id="olink.lang.fallback.sequence"> \r
3754 <refmeta> \r
3755 <refentrytitle>olink.lang.fallback.sequence</refentrytitle> \r
3756 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo> \r
3757 </refmeta> \r
3758 <refnamediv> \r
3759 <refname>olink.lang.fallback.sequence</refname> \r
3760 <refpurpose>look up translated documents if olink not found?</refpurpose>\r
3761 \r
3762 </refnamediv> \r
3763 <refsynopsisdiv> <programlisting xml:id="olink.lang.fallback.sequence.frag">\r
3764 &lt;xsl:param name="olink.lang.fallback.sequence"&gt;&lt;/xsl:param&gt;\r
3765 </programlisting> \r
3766 </refsynopsisdiv> \r
3767 <refsection><info><title>Description</title></info> \r
3768  \r
3769 \r
3770 <para>This parameter defines a list of lang values\r
3771 to search among to resolve olinks.\r
3772 </para>\r
3773 \r
3774 <para>Normally an olink tries to resolve to a document in the same\r
3775 language as the olink itself.  The language of an olink\r
3776 is determined by its nearest ancestor element with a\r
3777 <tag class="attribute">lang</tag> attribute, otherwise the\r
3778 value of the <parameter>l10n.gentext.default.lang</parameter>\r
3779 parameter.\r
3780 </para>\r
3781 \r
3782 <para>An olink database can contain target data for the same\r
3783 document in multiple languages.  Each set of data has the\r
3784 same value for the <tag>targetdoc</tag> attribute in\r
3785 the <tag>document</tag> element in the database, but with a \r
3786 different <tag>lang</tag> attribute value.\r
3787 </para>\r
3788 \r
3789 <para>When an olink is being resolved, the target is first\r
3790 sought in the document with the same language as the olink.\r
3791 If no match is found there, then this parameter is consulted\r
3792 for additional languages to try.</para>\r
3793 \r
3794 <para>The <parameter>olink.lang.fallback.sequence</parameter>\r
3795 must be a whitespace separated list of lang values to\r
3796 try.  The first one with a match in the olink database is used.\r
3797 The default value is empty.</para>\r
3798 \r
3799 <para>For example, a document might be written in German\r
3800 and contain an olink with\r
3801 <literal>targetdoc="adminguide"</literal>.\r
3802 When the document is processed, the processor\r
3803 first looks for a target dataset in the\r
3804 olink database starting with:</para>\r
3805 \r
3806 <literallayout><literal>&lt;document targetdoc="adminguide" lang="de"&gt;</literal>.\r
3807 </literallayout>\r
3808 \r
3809 <para>If there is no such element, then the\r
3810 <parameter>olink.lang.fallback.sequence</parameter> \r
3811 parameter is consulted.\r
3812 If its value is, for example, <quote>fr en</quote>, then the processor next\r
3813 looks for <literal>targetdoc="adminguide" lang="fr"</literal>, and\r
3814 then for <literal>targetdoc="adminguide" lang="en"</literal>.\r
3815 If there is still no match, it looks for\r
3816 <literal>targetdoc="adminguide"</literal> with no\r
3817 lang attribute.\r
3818 </para>\r
3819 \r
3820 <para>This parameter is useful when a set of documents is only\r
3821 partially translated, or is in the process of being translated.  \r
3822 If a target of an olink has not yet been translated, then this\r
3823 parameter permits the processor to look for the document in\r
3824 other languages.  This assumes the reader would rather have\r
3825 a link to a document in a different language than to have\r
3826 a broken link.\r
3827 </para>\r
3828 \r
3829 </refsection> \r
3830 </refentry>\r
3831 \r
3832 <refentry version="5.0" xml:id="olink.properties">\r
3833 <refmeta>\r
3834 <refentrytitle>olink.properties</refentrytitle>\r
3835 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
3836 </refmeta>\r
3837 <refnamediv>\r
3838 <refname>olink.properties</refname>\r
3839 <refpurpose>Properties associated with the cross-reference \r
3840 text of an olink.</refpurpose>\r
3841 </refnamediv>\r
3842 \r
3843 <refsynopsisdiv>\r
3844 <programlisting xml:id="olink.properties.frag">\r
3845 &lt;xsl:attribute-set name="olink.properties"&gt;\r
3846   &lt;xsl:attribute name="show-destination"&gt;replace&lt;/xsl:attribute&gt;\r
3847 &lt;/xsl:attribute-set&gt;\r
3848 </programlisting>\r
3849 </refsynopsisdiv>\r
3850 \r
3851 <refsection><info><title>Description</title></info>\r
3852 \r
3853 <para>This <literal>attribute set</literal> is applied to the\r
3854 <literal>fo:basic-link</literal> element of an olink. It is not applied to the\r
3855 optional page number or optional title of the external\r
3856 document.</para>\r
3857 \r
3858 </refsection>\r
3859 </refentry>\r
3860 \r
3861 <refentry version="5.0" xml:id="prefer.internal.olink">\r
3862 <refmeta>\r
3863 <refentrytitle>prefer.internal.olink</refentrytitle>\r
3864 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
3865 </refmeta>\r
3866 <refnamediv>\r
3867 <refname>prefer.internal.olink</refname>\r
3868 <refpurpose>Prefer a local olink reference to an external reference</refpurpose>\r
3869 </refnamediv>\r
3870 \r
3871 <refsynopsisdiv>\r
3872 <programlisting xml:id="prefer.internal.olink.frag">\r
3873 &lt;xsl:param name="prefer.internal.olink" select="0"&gt;&lt;/xsl:param&gt;\r
3874 </programlisting>\r
3875 </refsynopsisdiv>\r
3876 \r
3877 <refsection><info><title>Description</title></info>\r
3878 \r
3879 <para>If you are re-using XML content modules in multiple documents,\r
3880 you may want to redirect some of your olinks.  This parameter\r
3881 permits you to redirect an olink to the current document.\r
3882 </para>\r
3883 \r
3884 <para>For example: you are writing documentation for a  product, \r
3885 which includes 3 manuals: a little installation\r
3886 booklet (booklet.xml), a user \r
3887 guide (user.xml), and a reference manual (reference.xml).\r
3888 All 3 documents begin with the same introduction section (intro.xml) that \r
3889 contains a reference to the customization section (custom.xml) which is \r
3890 included in both user.xml and reference.xml documents.\r
3891 </para>\r
3892 \r
3893 <para>How do you write the link to custom.xml in intro.xml\r
3894 so that it is interpreted correctly in all 3 documents?</para>\r
3895 <itemizedlist>\r
3896 <listitem><para>If you use xref, it will fail in user.xml.</para>\r
3897 </listitem>\r
3898 <listitem><para>If you use olink (pointing to reference.xml),\r
3899 the reference in user.xml  \r
3900 will point to the customization section of the reference manual, while it is \r
3901 actually available in user.xml.</para>\r
3902 </listitem>\r
3903 </itemizedlist>\r
3904 \r
3905 <para>If you set the <parameter>prefer.internal.olink</parameter>\r
3906 parameter to a non-zero value, then the processor will\r
3907 first look in the olink database\r
3908 for the olink's <tag>targetptr</tag> attribute value\r
3909 in document matching the <parameter>current.docid</parameter>\r
3910 parameter value.  If it isn't found there, then\r
3911 it tries the document in the database\r
3912 with the <tag>targetdoc</tag>\r
3913 value that matches the olink's <tag>targetdoc</tag>\r
3914 attribute.\r
3915 </para>\r
3916 \r
3917 <para>This feature permits an olink reference to resolve to\r
3918 the current document if there is an element\r
3919 with an id matching the olink's <tag>targetptr</tag>\r
3920 value.  The current document's olink data must be\r
3921 included in the target database for this to work.</para>\r
3922 \r
3923 <caution>\r
3924 <para>There is a potential for incorrect links if\r
3925 the same <tag>id</tag> attribute value is used for different\r
3926 content in different documents.\r
3927 Some of your olinks may be redirected to the current document\r
3928 when they shouldn't be.  It is not possible to control\r
3929 individual olink instances.</para>\r
3930 </caution>\r
3931 \r
3932 </refsection>\r
3933 </refentry>\r
3934 \r
3935 <refentry version="5.0" xml:id="target.database.document"> \r
3936 <refmeta> \r
3937 <refentrytitle>target.database.document</refentrytitle> \r
3938 <refmiscinfo class="other" otherclass="datatype">uri</refmiscinfo> \r
3939 </refmeta> \r
3940 <refnamediv> \r
3941 <refname>target.database.document</refname> \r
3942 <refpurpose>Name of master database file for resolving\r
3943 olinks</refpurpose> \r
3944 </refnamediv> \r
3945 <refsynopsisdiv> \r
3946 <programlisting xml:id="target.database.document.frag">\r
3947  &lt;xsl:param name="target.database.document"&gt;olinkdb.xml&lt;/xsl:param&gt;\r
3948 </programlisting> \r
3949 </refsynopsisdiv> \r
3950 <refsection><info><title>Description</title></info>\r
3951  \r
3952 <para>\r
3953 To resolve olinks between documents, the stylesheets use a master\r
3954 database document that identifies the target datafiles for all the\r
3955 documents within the scope of the olinks. This parameter value is the\r
3956 URI of the master document to be read during processing to resolve\r
3957 olinks.  The default value is <filename>olinkdb.xml</filename>.</para>\r
3958 \r
3959 <para>The data structure of the file is defined in the\r
3960 <filename>targetdatabase.dtd</filename> DTD.  The database file\r
3961 provides the high level elements to record the identifiers, locations,\r
3962 and relationships of documents. The cross reference data for\r
3963 individual documents is generally pulled into the database using\r
3964 system entity references or XIncludes. See also\r
3965 <parameter>targets.filename</parameter>.  </para> </refsection>\r
3966 </refentry>\r
3967 \r
3968 <refentry version="5.0" xml:id="targets.filename"> \r
3969 <refmeta> \r
3970 <refentrytitle>targets.filename</refentrytitle> \r
3971 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo> \r
3972 </refmeta> \r
3973 <refnamediv> \r
3974 <refname>targets.filename</refname> \r
3975 <refpurpose>Name of cross reference targets data file</refpurpose> \r
3976 </refnamediv> \r
3977 <refsynopsisdiv> <programlisting xml:id="targets.filename.frag">\r
3978 &lt;xsl:param name="targets.filename"&gt;target.db&lt;/xsl:param&gt;\r
3979 </programlisting> \r
3980 </refsynopsisdiv> \r
3981 <refsection><info><title>Description</title></info>\r
3982  \r
3983 <para>\r
3984 In order to resolve olinks efficiently, the stylesheets can\r
3985 generate an external data file containing information about\r
3986 all potential cross reference endpoints in a document.\r
3987 This parameter lets you change the name of the generated\r
3988 file from the default name <filename>target.db</filename>.\r
3989 The name must agree with that used in the target database\r
3990 used to resolve olinks during processing.\r
3991 See also <parameter>target.database.document</parameter>.\r
3992 </para> \r
3993 </refsection> \r
3994 </refentry>\r
3995 \r
3996 <refentry version="5.0" xml:id="use.local.olink.style"> \r
3997 <refmeta> \r
3998 <refentrytitle>use.local.olink.style</refentrytitle> \r
3999 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo> \r
4000 </refmeta> \r
4001 <refnamediv> \r
4002 <refname>use.local.olink.style</refname> \r
4003 <refpurpose>Process olinks using xref style of current\r
4004 document</refpurpose> \r
4005 </refnamediv> \r
4006 <refsynopsisdiv> <programlisting xml:id="use.local.olink.style.frag">\r
4007 &lt;xsl:param name="use.local.olink.style" select="0"&gt;&lt;/xsl:param&gt; </programlisting> \r
4008 </refsynopsisdiv> \r
4009 <refsection><info><title>Description</title></info> \r
4010  \r
4011 <para>When cross reference data is collected for use by olinks, the data for each potential target includes one field containing a completely assembled cross reference string, as if it were an xref generated in that document. Other fields record the separate title, number, and element name of each target. When an olink is formed to a target from another document, the olink resolves to that preassembled string by default. If the <parameter>use.local.olink.style</parameter> parameter is set to non-zero, then instead the cross\r
4012 reference string is formed again from the target title, number, and\r
4013 element name, using the stylesheet processing the targeting document.\r
4014 Then olinks will match the xref style in the targeting document\r
4015 rather than in the target document. If  both documents are processed\r
4016 with the same stylesheet, then the results will be the same.</para> \r
4017 </refsection> \r
4018 </refentry>\r
4019 \r
4020 </reference>\r
4021 <reference xml:id="xrefs"><title>Cross References</title>\r
4022 <refentry version="5.0" xml:id="insert.xref.page.number">\r
4023 <refmeta>\r
4024 <refentrytitle>insert.xref.page.number</refentrytitle>\r
4025 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> \r
4026 <refmiscinfo class="other" otherclass="value">no</refmiscinfo>\r
4027 <refmiscinfo class="other" otherclass="value">yes</refmiscinfo>\r
4028 <refmiscinfo class="other" otherclass="value">maybe</refmiscinfo>\r
4029 </refmeta>\r
4030 <refnamediv>\r
4031 <refname>insert.xref.page.number</refname>\r
4032 <refpurpose>Turns page numbers in xrefs on and off</refpurpose>\r
4033 </refnamediv>\r
4034 \r
4035 <refsynopsisdiv>\r
4036 <programlisting xml:id="insert.xref.page.number.frag">\r
4037 &lt;xsl:param name="insert.xref.page.number"&gt;no&lt;/xsl:param&gt;\r
4038 </programlisting>\r
4039 </refsynopsisdiv>\r
4040 \r
4041 <refsection><info><title>Description</title></info>\r
4042 \r
4043 <para>The value of this parameter determines if\r
4044 cross references (<tag>xref</tag>s) in\r
4045 printed output will\r
4046 include page number citations.\r
4047 It has three possible values.\r
4048 </para>\r
4049 <variablelist>\r
4050 <varlistentry>\r
4051 <term>no</term>\r
4052 <listitem><para>No page number references will be generated.\r
4053 </para></listitem>\r
4054 </varlistentry>\r
4055 <varlistentry>\r
4056 <term>yes</term>\r
4057 <listitem><para>Page number references will be generated\r
4058 for all <tag>xref</tag> elements.\r
4059 The style of page reference may be changed\r
4060 if an <tag class="attribute">xrefstyle</tag>\r
4061 attribute is used.\r
4062 </para></listitem>\r
4063 </varlistentry>\r
4064 <varlistentry>\r
4065 <term>maybe</term>\r
4066 <listitem><para>Page number references will not be generated\r
4067 for an <tag>xref</tag> element unless \r
4068 it has an\r
4069 <tag class="attribute">xrefstyle</tag>\r
4070 attribute whose value specifies a page reference.\r
4071 </para></listitem>\r
4072 </varlistentry>\r
4073 </variablelist>\r
4074 \r
4075 </refsection>\r
4076 </refentry>\r
4077 \r
4078 <refentry version="5.0" xml:id="xref.properties">\r
4079 <refmeta>\r
4080 <refentrytitle>xref.properties</refentrytitle>\r
4081 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
4082 </refmeta>\r
4083 <refnamediv>\r
4084 <refname>xref.properties</refname>\r
4085 <refpurpose>Properties associated with cross-reference text</refpurpose>\r
4086 </refnamediv>\r
4087 \r
4088 <refsynopsisdiv>\r
4089 <programlisting xml:id="xref.properties.frag">\r
4090 &lt;xsl:attribute-set name="xref.properties"&gt;\r
4091 &lt;/xsl:attribute-set&gt;\r
4092 </programlisting>\r
4093 </refsynopsisdiv>\r
4094 \r
4095 <refsection><info><title>Description</title></info>\r
4096 \r
4097 <para>This attribute set is used to set properties\r
4098 on cross reference text.</para>\r
4099 \r
4100 </refsection>\r
4101 </refentry>\r
4102 \r
4103 <refentry version="5.0" xml:id="xref.label-title.separator">\r
4104 <refmeta>\r
4105 <refentrytitle>xref.label-title.separator</refentrytitle>\r
4106 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
4107 </refmeta>\r
4108 <refnamediv>\r
4109 <refname>xref.label-title.separator</refname>\r
4110 <refpurpose>Punctuation or space separating label from title in xref</refpurpose>\r
4111 </refnamediv>\r
4112 \r
4113 <refsynopsisdiv>\r
4114 <programlisting xml:id="xref.label-title.separator.frag">&lt;xsl:param name="xref.label-title.separator"&gt;: &lt;/xsl:param&gt;</programlisting>\r
4115 </refsynopsisdiv>\r
4116 \r
4117 <refsection><info><title>Description</title></info>\r
4118 \r
4119 <para>\r
4120 This parameter allows you to control the punctuation of certain\r
4121 types of generated cross reference text.\r
4122 When cross reference text is generated for an \r
4123 <tag class="element">xref</tag> or \r
4124 <tag class="element">olink</tag> element\r
4125 using an <tag class="attribute">xrefstyle</tag> attribute\r
4126 that makes use of the <literal>select:</literal> feature,\r
4127 and the selected components include both label and title,\r
4128 then the value of this parameter is inserted between\r
4129 label and title in the output.  \r
4130 </para>\r
4131 \r
4132 </refsection>\r
4133 </refentry>\r
4134 \r
4135 <refentry version="5.0" xml:id="xref.label-page.separator">\r
4136 <refmeta>\r
4137 <refentrytitle>xref.label-page.separator</refentrytitle>\r
4138 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
4139 </refmeta>\r
4140 <refnamediv>\r
4141 <refname>xref.label-page.separator</refname>\r
4142 <refpurpose>Punctuation or space separating label from page number in xref</refpurpose>\r
4143 </refnamediv>\r
4144 \r
4145 <refsynopsisdiv>\r
4146 <programlisting xml:id="xref.label-page.separator.frag">&lt;xsl:param name="xref.label-page.separator"&gt;&lt;xsl:text&gt; &lt;/xsl:text&gt;&lt;/xsl:param&gt;</programlisting>\r
4147 </refsynopsisdiv>\r
4148 \r
4149 <refsection><info><title>Description</title></info>\r
4150 \r
4151 <para>\r
4152 This parameter allows you to control the punctuation of certain\r
4153 types of generated cross reference text.\r
4154 When cross reference text is generated for an \r
4155 <tag class="element">xref</tag> or \r
4156 <tag class="element">olink</tag> element\r
4157 using an <tag class="attribute">xrefstyle</tag> attribute\r
4158 that makes use of the <literal>select:</literal> feature,\r
4159 and the selected components include both label and page\r
4160 but no title,\r
4161 then the value of this parameter is inserted between\r
4162 label and page number in the output.  \r
4163 If a title is included, then other separators are used.\r
4164 </para>\r
4165 \r
4166 </refsection>\r
4167 </refentry>\r
4168 \r
4169 <refentry version="5.0" xml:id="xref.title-page.separator">\r
4170 <refmeta>\r
4171 <refentrytitle>xref.title-page.separator</refentrytitle>\r
4172 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
4173 </refmeta>\r
4174 <refnamediv>\r
4175 <refname>xref.title-page.separator</refname>\r
4176 <refpurpose>Punctuation or space separating title from page number in xref</refpurpose>\r
4177 </refnamediv>\r
4178 \r
4179 <refsynopsisdiv>\r
4180 <programlisting xml:id="xref.title-page.separator.frag">&lt;xsl:param name="xref.title-page.separator"&gt;&lt;xsl:text&gt; &lt;/xsl:text&gt;&lt;/xsl:param&gt;</programlisting>\r
4181 </refsynopsisdiv>\r
4182 \r
4183 <refsection><info><title>Description</title></info>\r
4184 \r
4185 <para>\r
4186 This parameter allows you to control the punctuation of certain\r
4187 types of generated cross reference text.\r
4188 When cross reference text is generated for an \r
4189 <tag class="element">xref</tag> or \r
4190 <tag class="element">olink</tag> element\r
4191 using an <tag class="attribute">xrefstyle</tag> attribute\r
4192 that makes use of the <literal>select:</literal> feature,\r
4193 and the selected components include both title and page number,\r
4194 then the value of this parameter is inserted between\r
4195 title and page number in the output.  \r
4196 </para>\r
4197 \r
4198 </refsection>\r
4199 </refentry>\r
4200 \r
4201 <refentry version="5.0" xml:id="insert.link.page.number">\r
4202 <refmeta>\r
4203 <refentrytitle>insert.link.page.number</refentrytitle>\r
4204 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> \r
4205 <refmiscinfo class="other" otherclass="value">no</refmiscinfo>\r
4206 <refmiscinfo class="other" otherclass="value">yes</refmiscinfo>\r
4207 <refmiscinfo class="other" otherclass="value">maybe</refmiscinfo>\r
4208 </refmeta>\r
4209 <refnamediv>\r
4210 <refname>insert.link.page.number</refname>\r
4211 <refpurpose>Turns page numbers in link elements on and off</refpurpose>\r
4212 </refnamediv>\r
4213 \r
4214 <refsynopsisdiv>\r
4215 <programlisting xml:id="insert.link.page.number.frag">\r
4216 &lt;xsl:param name="insert.link.page.number"&gt;no&lt;/xsl:param&gt;\r
4217 </programlisting>\r
4218 </refsynopsisdiv>\r
4219 \r
4220 <refsection><info><title>Description</title></info>\r
4221 \r
4222 <para>The value of this parameter determines if\r
4223 cross references using the <tag>link</tag> element in\r
4224 printed output will\r
4225 include standard page number citations.\r
4226 It has three possible values.\r
4227 </para>\r
4228 <variablelist>\r
4229 <varlistentry>\r
4230 <term>no</term>\r
4231 <listitem><para>No page number references will be generated.\r
4232 </para></listitem>\r
4233 </varlistentry>\r
4234 <varlistentry>\r
4235 <term>yes</term>\r
4236 <listitem><para>Page number references will be generated\r
4237 for all <tag>link</tag> elements.\r
4238 The style of page reference may be changed\r
4239 if an <tag class="attribute">xrefstyle</tag>\r
4240 attribute is used.\r
4241 </para></listitem>\r
4242 </varlistentry>\r
4243 <varlistentry>\r
4244 <term>maybe</term>\r
4245 <listitem><para>Page number references will not be generated\r
4246 for a <tag>link</tag> element unless \r
4247 it has an\r
4248 <tag class="attribute">xrefstyle</tag>\r
4249 attribute whose value specifies a page reference.\r
4250 </para></listitem>\r
4251 </varlistentry>\r
4252 </variablelist>\r
4253 \r
4254 <para>Although the <tag>xrefstyle</tag> attribute\r
4255 can be used to turn the page reference on or off, it cannot be\r
4256 used to control the formatting of the page number as it\r
4257 can in <tag>xref</tag>.\r
4258 In <tag>link</tag> it will always format with\r
4259 the style established by the\r
4260 gentext template with <literal>name="page.citation"</literal>\r
4261 in the <literal>l:context name="xref"</literal>.\r
4262 </para>\r
4263 </refsection>\r
4264 </refentry>\r
4265 \r
4266 </reference>\r
4267 <reference xml:id="lists"><title>Lists</title>\r
4268 <refentry version="5.0" xml:id="compact.list.item.spacing">\r
4269 <refmeta>\r
4270 <refentrytitle>compact.list.item.spacing</refentrytitle>\r
4271 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
4272 </refmeta>  \r
4273 <refnamediv>\r
4274 <refname>compact.list.item.spacing</refname>\r
4275 <refpurpose>What space do you want between list items (when spacing="compact")?</refpurpose>\r
4276 </refnamediv>\r
4277 \r
4278 <refsynopsisdiv>\r
4279 <programlisting xml:id="compact.list.item.spacing.frag">&lt;xsl:attribute-set name="compact.list.item.spacing"&gt;\r
4280   &lt;xsl:attribute name="space-before.optimum"&gt;0em&lt;/xsl:attribute&gt;\r
4281   &lt;xsl:attribute name="space-before.minimum"&gt;0em&lt;/xsl:attribute&gt;\r
4282   &lt;xsl:attribute name="space-before.maximum"&gt;0.2em&lt;/xsl:attribute&gt;\r
4283 &lt;/xsl:attribute-set&gt;</programlisting>\r
4284 </refsynopsisdiv>\r
4285 <refsection><info><title>Description</title></info>\r
4286 <para>Specify what spacing you want between each list item when\r
4287 <tag class="attribute">spacing</tag> is\r
4288 <quote><literal>compact</literal></quote>.</para>\r
4289 </refsection>\r
4290 </refentry>\r
4291 \r
4292 <refentry version="5.0" xml:id="itemizedlist.properties">\r
4293 <refmeta>\r
4294 <refentrytitle>itemizedlist.properties</refentrytitle>\r
4295 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
4296 </refmeta>\r
4297 <refnamediv>\r
4298 <refname>itemizedlist.properties</refname>\r
4299 <refpurpose>Properties that apply to each list-block generated by itemizedlist.</refpurpose>\r
4300 </refnamediv>\r
4301 \r
4302 <refsynopsisdiv>\r
4303 <programlisting xml:id="itemizedlist.properties.frag">&lt;xsl:attribute-set name="itemizedlist.properties" use-attribute-sets="list.block.properties"&gt;\r
4304 &lt;/xsl:attribute-set&gt;</programlisting>\r
4305 </refsynopsisdiv>\r
4306 <refsection><info><title>Description</title></info>\r
4307 <para>Properties that apply to each fo:list-block generated by itemizedlist.</para>\r
4308 </refsection>\r
4309 </refentry>\r
4310 \r
4311 <refentry version="5.0" xml:id="itemizedlist.label.properties">\r
4312 <refmeta>\r
4313 <refentrytitle>itemizedlist.label.properties</refentrytitle>\r
4314 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
4315 </refmeta>\r
4316 <refnamediv>\r
4317 <refname>itemizedlist.label.properties</refname>\r
4318 <refpurpose>Properties that apply to each label inside itemized list.</refpurpose>\r
4319 </refnamediv>\r
4320 \r
4321 <refsynopsisdiv>\r
4322 <programlisting xml:id="itemizedlist.label.properties.frag">&lt;xsl:attribute-set name="itemizedlist.label.properties"&gt;\r
4323 &lt;/xsl:attribute-set&gt;</programlisting>\r
4324 </refsynopsisdiv>\r
4325 <refsection><info><title>Description</title></info>\r
4326 <para>Properties that apply to each label inside itemized list. E.g.:</para>\r
4327 <programlisting>&lt;xsl:attribute-set name="itemizedlist.label.properties"&gt;\r
4328   &lt;xsl:attribute name="text-align"&gt;right&lt;/xsl:attribute&gt;\r
4329 &lt;/xsl:attribute-set&gt;</programlisting>\r
4330 </refsection>\r
4331 </refentry>\r
4332 \r
4333 <refentry version="5.0" xml:id="itemizedlist.label.width">\r
4334 <refmeta>\r
4335 <refentrytitle>itemizedlist.label.width</refentrytitle>\r
4336 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
4337 </refmeta>\r
4338 <refnamediv>\r
4339   <refname>itemizedlist.label.width</refname>\r
4340 <refpurpose>The default width of the label (bullet) in an itemized list.</refpurpose>\r
4341 </refnamediv>\r
4342 \r
4343 <refsynopsisdiv>\r
4344   <programlisting xml:id="itemizedlist.label.width.frag">\r
4345     &lt;xsl:param name="itemizedlist.label.width"&gt;1.0em&lt;/xsl:param&gt;\r
4346   </programlisting>\r
4347 </refsynopsisdiv>\r
4348 \r
4349 <refsection><info><title>Description</title></info>\r
4350 <para>Specifies the default width of the label (usually a bullet or other\r
4351 symbol) in an itemized list. You can override the default value on any\r
4352 particular list with the &#8220;dbfo&#8221; processing instruction using the\r
4353 &#8220;label-width&#8221; pseudoattribute.</para>\r
4354 </refsection>\r
4355 </refentry>\r
4356 \r
4357 <refentry version="5.0" xml:id="list.block.properties">\r
4358 <refmeta>\r
4359 <refentrytitle>list.block.properties</refentrytitle>\r
4360 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
4361 </refmeta>\r
4362 <refnamediv>\r
4363 <refname>list.block.properties</refname>\r
4364 <refpurpose>Properties that apply to each list-block generated by list.</refpurpose>\r
4365 </refnamediv>\r
4366 \r
4367 <refsynopsisdiv>\r
4368 <programlisting xml:id="list.block.properties.frag">&lt;xsl:attribute-set name="list.block.properties"&gt;\r
4369   &lt;xsl:attribute name="provisional-label-separation"&gt;0.2em&lt;/xsl:attribute&gt;\r
4370   &lt;xsl:attribute name="provisional-distance-between-starts"&gt;1.5em&lt;/xsl:attribute&gt;\r
4371 &lt;/xsl:attribute-set&gt;</programlisting>\r
4372 </refsynopsisdiv>\r
4373 <refsection><info><title>Description</title></info>\r
4374 <para>Properties that apply to each fo:list-block generated by itemizedlist/orderedlist.</para>\r
4375 </refsection>\r
4376 </refentry>\r
4377 \r
4378 <refentry version="5.0" xml:id="list.block.spacing">\r
4379 <refmeta>\r
4380 <refentrytitle>list.block.spacing</refentrytitle>\r
4381 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
4382 </refmeta>\r
4383 <refnamediv>\r
4384 <refname>list.block.spacing</refname>\r
4385 <refpurpose>What spacing do you want before and after lists?</refpurpose>\r
4386 </refnamediv>\r
4387 \r
4388 <refsynopsisdiv>\r
4389 <programlisting xml:id="list.block.spacing.frag">&lt;xsl:attribute-set name="list.block.spacing"&gt;\r
4390   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;\r
4391   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;\r
4392   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;\r
4393   &lt;xsl:attribute name="space-after.optimum"&gt;1em&lt;/xsl:attribute&gt;\r
4394   &lt;xsl:attribute name="space-after.minimum"&gt;0.8em&lt;/xsl:attribute&gt;\r
4395   &lt;xsl:attribute name="space-after.maximum"&gt;1.2em&lt;/xsl:attribute&gt;\r
4396 &lt;/xsl:attribute-set&gt;</programlisting>\r
4397 </refsynopsisdiv>\r
4398 <refsection><info><title>Description</title></info>\r
4399 <para>Specify the spacing required before and after a list. It is necessary to specify the space after a list block because lists can come inside of paras.  </para>\r
4400 </refsection>\r
4401 </refentry>\r
4402 \r
4403 <refentry version="5.0" xml:id="list.item.spacing">\r
4404 <refmeta>\r
4405 <refentrytitle>list.item.spacing</refentrytitle>\r
4406 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
4407 </refmeta>\r
4408 <refnamediv>\r
4409 <refname>list.item.spacing</refname>\r
4410 <refpurpose>What space do you want between list items?</refpurpose>\r
4411 </refnamediv>\r
4412 \r
4413 <refsynopsisdiv>\r
4414 <programlisting xml:id="list.item.spacing.frag">&lt;xsl:attribute-set name="list.item.spacing"&gt;\r
4415   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;\r
4416   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;\r
4417   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;\r
4418 &lt;/xsl:attribute-set&gt;</programlisting>\r
4419 </refsynopsisdiv>\r
4420 <refsection><info><title>Description</title></info>\r
4421 <para>Specify what spacing you want between each list item.</para>\r
4422 </refsection>\r
4423 </refentry>\r
4424 \r
4425 <refentry version="5.0" xml:id="orderedlist.properties">\r
4426 <refmeta>\r
4427 <refentrytitle>orderedlist.properties</refentrytitle>\r
4428 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
4429 </refmeta>\r
4430 <refnamediv>\r
4431 <refname>orderedlist.properties</refname>\r
4432 <refpurpose>Properties that apply to each list-block generated by orderedlist.</refpurpose>\r
4433 </refnamediv>\r
4434 \r
4435 <refsynopsisdiv>\r
4436 <programlisting xml:id="orderedlist.properties.frag">&lt;xsl:attribute-set name="orderedlist.properties" use-attribute-sets="list.block.properties"&gt;\r
4437   &lt;xsl:attribute name="provisional-distance-between-starts"&gt;2em&lt;/xsl:attribute&gt;\r
4438 &lt;/xsl:attribute-set&gt;</programlisting>\r
4439 </refsynopsisdiv>\r
4440 <refsection><info><title>Description</title></info>\r
4441 <para>Properties that apply to each fo:list-block generated by orderedlist.</para>\r
4442 </refsection>\r
4443 </refentry>\r
4444 \r
4445 <refentry version="5.0" xml:id="orderedlist.label.properties">\r
4446 <refmeta>\r
4447 <refentrytitle>orderedlist.label.properties</refentrytitle>\r
4448 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
4449 </refmeta>\r
4450 <refnamediv>\r
4451 <refname>orderedlist.label.properties</refname>\r
4452 <refpurpose>Properties that apply to each label inside ordered list.</refpurpose>\r
4453 </refnamediv>\r
4454 \r
4455 <refsynopsisdiv>\r
4456 <programlisting xml:id="orderedlist.label.properties.frag">&lt;xsl:attribute-set name="orderedlist.label.properties"&gt;\r
4457 &lt;/xsl:attribute-set&gt;</programlisting>\r
4458 </refsynopsisdiv>\r
4459 <refsection><info><title>Description</title></info>\r
4460 <para>Properties that apply to each label inside ordered list. E.g.:</para>\r
4461 <programlisting>&lt;xsl:attribute-set name="orderedlist.label.properties"&gt;\r
4462   &lt;xsl:attribute name="text-align"&gt;right&lt;/xsl:attribute&gt;\r
4463 &lt;/xsl:attribute-set&gt;</programlisting>\r
4464 </refsection>\r
4465 </refentry>\r
4466 \r
4467 <refentry version="5.0" xml:id="orderedlist.label.width">\r
4468 <refmeta>\r
4469 <refentrytitle>orderedlist.label.width</refentrytitle>\r
4470 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
4471 </refmeta>\r
4472 <refnamediv>\r
4473 <refname>orderedlist.label.width</refname>\r
4474 <refpurpose>The default width of the label (number) in an ordered list.</refpurpose>\r
4475 </refnamediv>\r
4476 \r
4477 <refsynopsisdiv>\r
4478 <programlisting xml:id="orderedlist.label.width.frag">\r
4479 &lt;xsl:param name="orderedlist.label.width"&gt;1.2em&lt;/xsl:param&gt;\r
4480 </programlisting>\r
4481 </refsynopsisdiv>\r
4482 \r
4483 <refsection><info><title>Description</title></info>\r
4484 <para>Specifies the default width of the label (usually a number or\r
4485 sequence of numbers) in an ordered list. You can override the default\r
4486 value on any particular list with the &#8220;dbfo&#8221; processing instruction\r
4487 using the &#8220;label-width&#8221; pseudoattribute.</para>\r
4488 </refsection>\r
4489 </refentry>\r
4490 \r
4491 <refentry version="5.0" xml:id="variablelist.max.termlength">\r
4492 <refmeta>\r
4493 <refentrytitle>variablelist.max.termlength</refentrytitle>\r
4494 <refmiscinfo class="other" otherclass="datatype">number</refmiscinfo>\r
4495 </refmeta>\r
4496 <refnamediv>\r
4497 <refname>variablelist.max.termlength</refname>\r
4498 <refpurpose>Specifies the longest term in variablelists</refpurpose>\r
4499 </refnamediv>\r
4500 \r
4501 <refsynopsisdiv>\r
4502 <programlisting xml:id="variablelist.max.termlength.frag">\r
4503 &lt;xsl:param name="variablelist.max.termlength"&gt;24&lt;/xsl:param&gt;\r
4504 </programlisting>\r
4505 </refsynopsisdiv>\r
4506 \r
4507 <refsection><info><title>Description</title></info>\r
4508 \r
4509 <para>In variablelists, the <tag>listitem</tag>\r
4510 is indented to leave room for the \r
4511 <tag>term</tag> elements. That indent may be computed\r
4512 if it is not specified with a <tag class="attribute">termlength</tag>\r
4513 attribute on the <tag>variablelist</tag> element.\r
4514 </para>\r
4515 <para>\r
4516 The computation counts characters in the \r
4517 <tag>term</tag> elements in the list\r
4518 to find the longest term.  However, some terms are very long\r
4519 and would produce extreme indents.  This parameter lets you\r
4520 set a maximum character count.  Any terms longer than the maximum\r
4521 would line wrap.  The default value is 24.\r
4522 </para>\r
4523 <para>\r
4524 The character counts are converted to physical widths\r
4525 by multiplying by 0.50em. There will be some variability\r
4526 in how many actual characters fit in the space\r
4527 since some characters are wider than others.\r
4528 </para>\r
4529 \r
4530 </refsection>\r
4531 </refentry>\r
4532 \r
4533 <refentry version="5.0" xml:id="variablelist.term.separator">\r
4534 <refmeta>\r
4535 <refentrytitle>variablelist.term.separator</refentrytitle>\r
4536 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
4537 </refmeta>\r
4538 <refnamediv>\r
4539 <refname>variablelist.term.separator</refname>\r
4540 <refpurpose>Text to separate <tag>term</tag>s within a multi-term\r
4541 <tag>varlistentry</tag></refpurpose>\r
4542 </refnamediv>\r
4543 \r
4544 <refsynopsisdiv>\r
4545 <programlisting xml:id="variablelist.term.separator.frag">\r
4546 &lt;xsl:param name="variablelist.term.separator"&gt;, &lt;/xsl:param&gt;</programlisting>\r
4547 </refsynopsisdiv>\r
4548 \r
4549 <refsection><info><title>Description</title></info>\r
4550 \r
4551 <para>When a <tag>varlistentry</tag> contains multiple <tag>term</tag>\r
4552 elements, the string specified in the value of the\r
4553 <parameter>variablelist.term.separator</parameter> parameter is placed\r
4554 after each <tag>term</tag> except the last.</para>\r
4555 \r
4556 <note>\r
4557   <para>To generate a line break between multiple <tag>term</tag>s in\r
4558   a <tag>varlistentry</tag>, set a non-zero value for the\r
4559   <parameter>variablelist.term.break.after</parameter> parameter. If\r
4560   you do so, you may also want to set the value of the\r
4561   <parameter>variablelist.term.separator</parameter> parameter to an\r
4562   empty string (to suppress rendering of the default comma and space\r
4563   after each <tag>term</tag>).</para>\r
4564 </note>\r
4565 \r
4566 </refsection>\r
4567 </refentry>\r
4568 \r
4569 <refentry version="5.0" xml:id="variablelist.term.properties">\r
4570 <refmeta>\r
4571 <refentrytitle>variablelist.term.properties</refentrytitle>\r
4572 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
4573 </refmeta>\r
4574 <refnamediv>\r
4575 <refname>variablelist.term.properties</refname>\r
4576 <refpurpose>To add properties to the term elements in a variablelist.</refpurpose>\r
4577 </refnamediv>\r
4578 \r
4579 <refsynopsisdiv>\r
4580 <programlisting xml:id="variablelist.term.properties.frag">\r
4581 &lt;xsl:attribute-set name="variablelist.term.properties"&gt;\r
4582 &lt;/xsl:attribute-set&gt;\r
4583 </programlisting>\r
4584 </refsynopsisdiv>\r
4585 <refsection><info><title>Description</title></info>\r
4586 <para>These properties are added to the block containing a\r
4587 term in a variablelist.\r
4588 Use this attribute-set to set\r
4589 font properties or alignment, for example.</para>\r
4590 \r
4591 </refsection>\r
4592 </refentry>\r
4593 \r
4594 <refentry version="5.0" xml:id="variablelist.term.break.after">\r
4595 <refmeta>\r
4596 <refentrytitle>variablelist.term.break.after</refentrytitle>\r
4597 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
4598 </refmeta>\r
4599 <refnamediv>\r
4600 <refname>variablelist.term.break.after</refname>\r
4601 <refpurpose>Generate line break after each <tag>term</tag> within a\r
4602 multi-term <tag>varlistentry</tag>?</refpurpose>\r
4603 </refnamediv>\r
4604 \r
4605 <refsynopsisdiv>\r
4606 <programlisting xml:id="variablelist.term.break.after.frag">\r
4607 &lt;xsl:param name="variablelist.term.break.after"&gt;0&lt;/xsl:param&gt;</programlisting>\r
4608 </refsynopsisdiv>\r
4609 \r
4610 <refsection><info><title>Description</title></info>\r
4611 \r
4612 <para>Set a non-zero value for the\r
4613 <parameter>variablelist.term.break.after</parameter> parameter to\r
4614 generate a line break between <tag>term</tag>s in a\r
4615 multi-term <tag>varlistentry</tag>.</para>\r
4616 \r
4617 <note>\r
4618 <para>If you set a non-zero value for\r
4619 <parameter>variablelist.term.break.after</parameter>, you may also\r
4620 want to set the value of the\r
4621 <parameter>variablelist.term.separator</parameter> parameter to an\r
4622 empty string (to suppress rendering of the default comma and space\r
4623 after each <tag>term</tag>).</para>\r
4624 </note>\r
4625 \r
4626 </refsection>\r
4627 </refentry>\r
4628 \r
4629 </reference>\r
4630 <reference xml:id="qa"><title>QAndASet</title>\r
4631 <refentry version="5.0" xml:id="qandadiv.autolabel">\r
4632 <refmeta>\r
4633 <refentrytitle>qandadiv.autolabel</refentrytitle>\r
4634 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
4635 </refmeta>\r
4636 <refnamediv>\r
4637 <refname>qandadiv.autolabel</refname>\r
4638 <refpurpose>Are divisions in QAndASets enumerated?</refpurpose>\r
4639 </refnamediv>\r
4640 \r
4641 <refsynopsisdiv>\r
4642 <programlisting xml:id="qandadiv.autolabel.frag">&lt;xsl:param name="qandadiv.autolabel" select="1"&gt;&lt;/xsl:param&gt;</programlisting>\r
4643 </refsynopsisdiv>\r
4644 \r
4645 <refsection><info><title>Description</title></info>\r
4646 \r
4647 <para>If non-zero, unlabeled qandadivs will be enumerated.\r
4648 </para>\r
4649 \r
4650 </refsection>\r
4651 </refentry>\r
4652 \r
4653 <refentry version="5.0" xml:id="qanda.inherit.numeration">\r
4654 <refmeta>\r
4655 <refentrytitle>qanda.inherit.numeration</refentrytitle>\r
4656 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
4657 </refmeta>\r
4658 <refnamediv>\r
4659 <refname>qanda.inherit.numeration</refname>\r
4660 <refpurpose>Does enumeration of QandASet components inherit the numeration of parent elements?</refpurpose>\r
4661 </refnamediv>\r
4662 \r
4663 <refsynopsisdiv>\r
4664 <programlisting xml:id="qanda.inherit.numeration.frag">\r
4665 &lt;xsl:param name="qanda.inherit.numeration" select="1"&gt;&lt;/xsl:param&gt;\r
4666 </programlisting>\r
4667 </refsynopsisdiv>\r
4668 \r
4669 <refsection><info><title>Description</title></info>\r
4670 \r
4671 <para>If non-zero, numbered <tag>qandadiv</tag> elements and\r
4672 <tag>question</tag> and <tag>answer</tag> inherit the enumeration of\r
4673 the ancestors of the <tag>qandaset</tag>.\r
4674 </para>\r
4675 \r
4676 </refsection>\r
4677 </refentry>\r
4678 \r
4679 <refentry version="5.0" xml:id="qanda.defaultlabel">\r
4680 <refmeta>\r
4681 <refentrytitle>qanda.defaultlabel</refentrytitle>\r
4682 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> \r
4683 <refmiscinfo class="other" otherclass="value">number</refmiscinfo>\r
4684 <refmiscinfo class="other" otherclass="value">qanda</refmiscinfo> \r
4685 <refmiscinfo class="other" otherclass="value">none</refmiscinfo>\r
4686 </refmeta>\r
4687 <refnamediv>\r
4688 <refname>qanda.defaultlabel</refname>\r
4689 <refpurpose>Sets the default for defaultlabel on QandASet.</refpurpose>\r
4690 </refnamediv>\r
4691 \r
4692 <refsynopsisdiv>\r
4693 <programlisting xml:id="qanda.defaultlabel.frag">\r
4694 &lt;xsl:param name="qanda.defaultlabel"&gt;number&lt;/xsl:param&gt;\r
4695 </programlisting>\r
4696 </refsynopsisdiv>\r
4697 \r
4698 <refsection><info><title>Description</title></info>\r
4699 \r
4700 <para>If no <literal>defaultlabel</literal> attribute is specified on\r
4701 a <tag>qandaset</tag>, this value is used. It is generally one of the legal\r
4702 values for the defaultlabel attribute (<literal>none</literal>, \r
4703 <literal>number</literal> or\r
4704 <literal>qanda</literal>), or one of the additional stylesheet-specific values\r
4705 (<literal>qnumber</literal> or <literal>qnumberanda</literal>).\r
4706 The default value is 'number'.\r
4707 </para>\r
4708 <para>The values are rendered as follows:</para>\r
4709 <variablelist>\r
4710 <varlistentry><term><literal>qanda</literal></term>\r
4711 <listitem>\r
4712 <para><tag>question</tag>s are labeled "Q:" and\r
4713 <tag>answer</tag>s are labeled "A:". </para>\r
4714 </listitem>\r
4715 </varlistentry>\r
4716 \r
4717 <varlistentry><term><literal>number</literal></term>\r
4718 <listitem>\r
4719 <para>The questions are enumerated and the answers\r
4720 are not labeled. </para>\r
4721 </listitem>\r
4722 </varlistentry>\r
4723 \r
4724 <varlistentry><term><literal>qnumber</literal></term>\r
4725 <listitem>\r
4726 <para>The questions are labeled "Q:" followed by a number, and answers are not \r
4727 labeled. \r
4728 When sections are numbered, adding a label\r
4729 to the number distinguishes the question numbers\r
4730 from the section numbers.\r
4731 This value is not allowed in the\r
4732 <tag class="attribute">defaultlabel</tag> attribute\r
4733 of a <tag>qandaset</tag> element.</para>\r
4734 </listitem>\r
4735 </varlistentry>\r
4736 \r
4737 <varlistentry><term><literal>qnumberanda</literal></term>\r
4738 <listitem>\r
4739 <para>The questions are labeled "Q:" followed by a number, and\r
4740 the answers are labeled "A:". \r
4741 When sections are numbered, adding a label\r
4742 to the number distinguishes the question numbers\r
4743 from the section numbers.\r
4744 This value is not allowed in the\r
4745 <tag class="attribute">defaultlabel</tag> attribute\r
4746 of a <tag>qandaset</tag> element.</para>\r
4747 </listitem>\r
4748 </varlistentry>\r
4749 \r
4750 <varlistentry><term><literal>none</literal></term>\r
4751 <listitem>\r
4752 <para>No distinguishing label precedes Questions or Answers. \r
4753 </para>\r
4754 </listitem>\r
4755 </varlistentry>\r
4756 </variablelist>\r
4757 \r
4758 </refsection>\r
4759 </refentry>\r
4760 \r
4761 <refentry version="5.0" xml:id="qanda.in.toc">\r
4762 <refmeta>\r
4763 <refentrytitle>qanda.in.toc</refentrytitle>\r
4764 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
4765 </refmeta>\r
4766 <refnamediv>\r
4767 <refname>qanda.in.toc</refname>\r
4768 <refpurpose>Should qandaentry questions appear in \r
4769 the document table of contents?</refpurpose>\r
4770 </refnamediv>\r
4771 \r
4772 <refsynopsisdiv>\r
4773 <programlisting xml:id="qanda.in.toc.frag">&lt;xsl:param name="qanda.in.toc" select="0"&gt;&lt;/xsl:param&gt;</programlisting>\r
4774 </refsynopsisdiv>\r
4775 \r
4776 <refsection><info><title>Description</title></info>\r
4777 \r
4778 <para>If true (non-zero), then the generated table of contents\r
4779 for a document will include <tag>qandaset</tag> titles, \r
4780 <tag>qandadiv</tag> titles,\r
4781 and <tag>question</tag> elements.  The default value (zero) excludes\r
4782 them from the TOC.\r
4783 </para>\r
4784 <para>This parameter does not affect any tables of contents\r
4785 that may be generated inside a qandaset or qandadiv.\r
4786 </para>\r
4787 \r
4788 </refsection>\r
4789 </refentry>\r
4790 \r
4791 <refentry version="5.0" xml:id="qanda.nested.in.toc">\r
4792 <refmeta>\r
4793 <refentrytitle>qanda.nested.in.toc</refentrytitle>\r
4794 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
4795 </refmeta>\r
4796 <refnamediv>\r
4797 <refname>qanda.nested.in.toc</refname>\r
4798 <refpurpose>Should nested answer/qandaentry instances appear in TOC?</refpurpose>\r
4799 </refnamediv>\r
4800 \r
4801 <refsynopsisdiv>\r
4802 <programlisting xml:id="qanda.nested.in.toc.frag">\r
4803 &lt;xsl:param name="qanda.nested.in.toc" select="0"&gt;&lt;/xsl:param&gt;\r
4804 </programlisting>\r
4805 </refsynopsisdiv>\r
4806 \r
4807 <refsection><info><title>Description</title></info>\r
4808 \r
4809 <para>If non-zero, instances of <tag>qandaentry</tag>\r
4810 that are children of <tag>answer</tag> elements are shown in\r
4811 the TOC.</para>\r
4812 \r
4813 </refsection>\r
4814 </refentry>\r
4815 \r
4816 </reference>\r
4817 <reference xml:id="biblio"><title>Bibliography</title>\r
4818 <refentry version="5.0" xml:id="bibliography.style">\r
4819 <refmeta>\r
4820 <refentrytitle>bibliography.style</refentrytitle>\r
4821 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>\r
4822 <refmiscinfo class="other" otherclass="value">normal</refmiscinfo>\r
4823 <refmiscinfo class="other" otherclass="value">iso690</refmiscinfo>\r
4824 </refmeta>\r
4825 <refnamediv>\r
4826 <refname>bibliography.style</refname>\r
4827 <refpurpose>Style used for formatting of biblioentries.</refpurpose>\r
4828 </refnamediv>\r
4829 \r
4830 <refsynopsisdiv>\r
4831 <programlisting xml:id="bibliography.style.frag">\r
4832 &lt;xsl:param name="bibliography.style"&gt;normal&lt;/xsl:param&gt;\r
4833 </programlisting>\r
4834 </refsynopsisdiv>\r
4835 \r
4836 <refsection><info><title>Description</title></info>\r
4837 \r
4838 <para>Currently only <literal>normal</literal> and\r
4839 <literal>iso690</literal> styles are supported.</para>\r
4840 \r
4841 <para>In order to use ISO690 style to the full extent you might need\r
4842 to use additional markup described on <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://wiki.docbook.org/topic/ISO690Bibliography">the\r
4843 following WiKi page</link>.</para>\r
4844 \r
4845 </refsection>\r
4846 </refentry>\r
4847 \r
4848 <refentry version="5.0" xml:id="biblioentry.item.separator">\r
4849 <refmeta>\r
4850 <refentrytitle>biblioentry.item.separator</refentrytitle>\r
4851 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
4852 </refmeta>\r
4853 <refnamediv>\r
4854 <refname>biblioentry.item.separator</refname>\r
4855 <refpurpose>Text to separate bibliography entries</refpurpose>\r
4856 </refnamediv>\r
4857 \r
4858 <refsynopsisdiv>\r
4859 <programlisting xml:id="biblioentry.item.separator.frag">&lt;xsl:param name="biblioentry.item.separator"&gt;. &lt;/xsl:param&gt;</programlisting>\r
4860 </refsynopsisdiv>\r
4861 \r
4862 <refsection><info><title>Description</title></info>\r
4863 \r
4864 <para>Text to separate bibliography entries\r
4865 </para>\r
4866 \r
4867 </refsection>\r
4868 </refentry>\r
4869 \r
4870 <refentry version="5.0" xml:id="bibliography.collection">\r
4871 <refmeta>\r
4872 <refentrytitle>bibliography.collection</refentrytitle>\r
4873 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
4874 </refmeta>\r
4875 <refnamediv>\r
4876 <refname>bibliography.collection</refname>\r
4877 <refpurpose>Name of the bibliography collection file</refpurpose>\r
4878 </refnamediv>\r
4879 \r
4880 <refsynopsisdiv>\r
4881 <programlisting xml:id="bibliography.collection.frag">\r
4882 &lt;xsl:param name="bibliography.collection"&gt;http://docbook.sourceforge.net/release/bibliography/bibliography.xml&lt;/xsl:param&gt;\r
4883 \r
4884 </programlisting>\r
4885 </refsynopsisdiv>\r
4886 \r
4887 <refsection><info><title>Description</title></info>\r
4888 \r
4889 <para>Maintaining bibliography entries across a set of documents is tedious, time\r
4890 consuming, and error prone. It makes much more sense, usually, to store all of\r
4891 the bibliography entries in a single place and simply <quote>extract</quote>\r
4892 the ones you need in each document.</para>\r
4893 \r
4894 <para>That's the purpose of the\r
4895 <parameter>bibliography.collection</parameter> parameter. To setup a global\r
4896 bibliography <quote>database</quote>, follow these steps:</para>\r
4897 \r
4898 <para>First, create a stand-alone bibliography document that contains all of\r
4899 the documents that you wish to reference. Make sure that each bibliography\r
4900 entry (whether you use <tag>biblioentry</tag> or <tag>bibliomixed</tag>)\r
4901 has an ID.</para>\r
4902 \r
4903 <para>My global bibliography, <filename>~/bibliography.xml</filename> begins\r
4904 like this:</para>\r
4905 \r
4906 <informalexample>\r
4907 <programlisting>&lt;!DOCTYPE bibliography\r
4908   PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"\r
4909   "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"&gt;\r
4910 &lt;bibliography&gt;&lt;title&gt;References&lt;/title&gt;\r
4911 \r
4912 &lt;bibliomixed id="xml-rec"&gt;&lt;abbrev&gt;XML 1.0&lt;/abbrev&gt;Tim Bray,\r
4913 Jean Paoli, C. M. Sperberg-McQueen, and Eve Maler, editors.\r
4914 &lt;citetitle&gt;&lt;ulink url="http://www.w3.org/TR/REC-xml"&gt;Extensible Markup\r
4915 Language (XML) 1.0 Second Edition&lt;/ulink&gt;&lt;/citetitle&gt;.\r
4916 World Wide Web Consortium, 2000.\r
4917 &lt;/bibliomixed&gt;\r
4918 \r
4919 &lt;bibliomixed id="xml-names"&gt;&lt;abbrev&gt;Namespaces&lt;/abbrev&gt;Tim Bray,\r
4920 Dave Hollander,\r
4921 and Andrew Layman, editors.\r
4922 &lt;citetitle&gt;&lt;ulink url="http://www.w3.org/TR/REC-xml-names/"&gt;Namespaces in\r
4923 XML&lt;/ulink&gt;&lt;/citetitle&gt;.\r
4924 World Wide Web Consortium, 1999.\r
4925 &lt;/bibliomixed&gt;\r
4926 \r
4927 &lt;!-- ... --&gt;\r
4928 &lt;/bibliography&gt;\r
4929 </programlisting>\r
4930 </informalexample>\r
4931 \r
4932 <para>When you create a bibliography in your document, simply\r
4933 provide <emphasis>empty</emphasis> <tag>bibliomixed</tag>\r
4934 entries for each document that you wish to cite. Make sure that these\r
4935 elements have the same ID as the corresponding <quote>real</quote>\r
4936 entry in your global bibliography.</para>\r
4937 \r
4938 <para>For example:</para>\r
4939 \r
4940 <informalexample>\r
4941 <programlisting>&lt;bibliography&gt;&lt;title&gt;Bibliography&lt;/title&gt;\r
4942 \r
4943 &lt;bibliomixed id="xml-rec"/&gt;\r
4944 &lt;bibliomixed id="xml-names"/&gt;\r
4945 &lt;bibliomixed id="DKnuth86"&gt;Donald E. Knuth. &lt;citetitle&gt;Computers and\r
4946 Typesetting: Volume B, TeX: The Program&lt;/citetitle&gt;. Addison-Wesley,\r
4947 1986.  ISBN 0-201-13437-3.\r
4948 &lt;/bibliomixed&gt;\r
4949 &lt;bibliomixed id="relaxng"/&gt;\r
4950 \r
4951 &lt;/bibliography&gt;</programlisting>\r
4952 </informalexample>\r
4953 \r
4954 <para>Note that it's perfectly acceptable to mix entries from your\r
4955 global bibliography with <quote>normal</quote> entries. You can use\r
4956 <tag>xref</tag> or other elements to cross-reference your\r
4957 bibliography entries in exactly the same way you do now.</para>\r
4958 \r
4959 <para>Finally, when you are ready to format your document, simply set the\r
4960 <parameter>bibliography.collection</parameter> parameter (in either a\r
4961 customization layer or directly through your processor's interface) to\r
4962 point to your global bibliography.</para>\r
4963 \r
4964 <para>The stylesheets will format the bibliography in your document as if\r
4965 all of the entries referenced appeared there literally.</para>\r
4966 \r
4967 </refsection>\r
4968 </refentry>\r
4969 \r
4970 <refentry version="5.0" xml:id="bibliography.numbered">\r
4971 <refmeta>\r
4972 <refentrytitle>bibliography.numbered</refentrytitle>\r
4973 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
4974 </refmeta>\r
4975 <refnamediv>\r
4976 <refname>bibliography.numbered</refname>\r
4977 <refpurpose>Should bibliography entries be numbered?</refpurpose>\r
4978 </refnamediv>\r
4979 \r
4980 <refsynopsisdiv>\r
4981 <programlisting xml:id="bibliography.numbered.frag">\r
4982 &lt;xsl:param name="bibliography.numbered" select="0"&gt;&lt;/xsl:param&gt;\r
4983 </programlisting>\r
4984 </refsynopsisdiv>\r
4985 \r
4986 <refsection><info><title>Description</title></info>\r
4987 \r
4988 <para>If non-zero bibliography entries will be numbered</para>\r
4989 \r
4990 </refsection>\r
4991 </refentry>\r
4992 \r
4993 <refentry version="5.0" xml:id="biblioentry.properties">\r
4994 <refmeta>\r
4995   <refentrytitle>biblioentry.properties</refentrytitle>\r
4996   <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
4997 </refmeta>\r
4998 <refnamediv>\r
4999 <refname>biblioentry.properties</refname>\r
5000 <refpurpose>To set the style for biblioentry.</refpurpose>\r
5001 </refnamediv>\r
5002 \r
5003 <refsynopsisdiv>\r
5004 <programlisting xml:id="biblioentry.properties.frag">&lt;xsl:attribute-set name="biblioentry.properties" use-attribute-sets="normal.para.spacing"&gt;\r
5005   &lt;xsl:attribute name="start-indent"&gt;0.5in&lt;/xsl:attribute&gt;\r
5006   &lt;xsl:attribute name="text-indent"&gt;-0.5in&lt;/xsl:attribute&gt;\r
5007 &lt;/xsl:attribute-set&gt;\r
5008 </programlisting>\r
5009 </refsynopsisdiv>\r
5010 <refsection><info><title>Description</title></info>\r
5011 <para>How do you want biblioentry styled? </para>\r
5012 <para>Set the font-size, weight, space-above and space-below, indents, etc. to the style required</para>\r
5013 \r
5014 </refsection>\r
5015 </refentry>\r
5016 \r
5017 </reference>\r
5018 <reference xml:id="glossary"><title>Glossary</title>\r
5019 <refentry version="5.0" xml:id="glossterm.auto.link">\r
5020 <refmeta>\r
5021 <refentrytitle>glossterm.auto.link</refentrytitle>\r
5022 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
5023 </refmeta>\r
5024 <refnamediv>\r
5025 <refname>glossterm.auto.link</refname>\r
5026 <refpurpose>Generate links from glossterm to glossentry automatically?</refpurpose>\r
5027 </refnamediv>\r
5028 \r
5029 <refsynopsisdiv>\r
5030 <programlisting xml:id="glossterm.auto.link.frag">\r
5031 &lt;xsl:param name="glossterm.auto.link" select="0"&gt;&lt;/xsl:param&gt;\r
5032 </programlisting>\r
5033 </refsynopsisdiv>\r
5034 \r
5035 <refsection><info><title>Description</title></info>\r
5036 \r
5037 <para>If non-zero, links from inline <tag>glossterm</tag>s to the corresponding \r
5038 <tag>glossentry</tag> elements in a <tag>glossary</tag> or <tag>glosslist</tag> \r
5039 will be automatically generated. This is useful when your glossterms are consistent \r
5040 and you don't want to add links manually.</para>\r
5041 \r
5042 <para>The automatic link generation feature is not used on <tag>glossterm</tag> elements\r
5043 that have a <tag class="attribute">linkend</tag> attribute.</para>\r
5044 \r
5045 </refsection>\r
5046 </refentry>\r
5047 \r
5048 <refentry version="5.0" xml:id="firstterm.only.link">\r
5049 <refmeta>\r
5050 <refentrytitle>firstterm.only.link</refentrytitle>\r
5051 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
5052 </refmeta>\r
5053 <refnamediv>\r
5054 <refname>firstterm.only.link</refname>\r
5055 <refpurpose>Does automatic glossterm linking only apply to firstterms?</refpurpose>\r
5056 </refnamediv>\r
5057 \r
5058 <refsynopsisdiv>\r
5059 <programlisting xml:id="firstterm.only.link.frag">\r
5060 &lt;xsl:param name="firstterm.only.link" select="0"&gt;&lt;/xsl:param&gt;\r
5061 </programlisting>\r
5062 </refsynopsisdiv>\r
5063 \r
5064 <refsection><info><title>Description</title></info>\r
5065 \r
5066 <para>If non-zero, only <tag>firstterm</tag>s will be automatically linked\r
5067 to the glossary. If glossary linking is not enabled, this parameter\r
5068 has no effect.</para>\r
5069 \r
5070 </refsection>\r
5071 </refentry>\r
5072 \r
5073 <refentry version="5.0" xml:id="glossary.collection">\r
5074 <refmeta>\r
5075 <refentrytitle>glossary.collection</refentrytitle>\r
5076 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
5077 </refmeta>\r
5078 <refnamediv>\r
5079 <refname>glossary.collection</refname>\r
5080 <refpurpose>Name of the glossary collection file</refpurpose>\r
5081 </refnamediv>\r
5082 \r
5083 <refsynopsisdiv>\r
5084 <programlisting xml:id="glossary.collection.frag">\r
5085 &lt;xsl:param name="glossary.collection"&gt;&lt;/xsl:param&gt;\r
5086 </programlisting>\r
5087 </refsynopsisdiv>\r
5088 \r
5089 <refsection><info><title>Description</title></info>\r
5090 \r
5091 <para>Glossaries maintained independently across a set of documents\r
5092 are likely to become inconsistent unless considerable effort is\r
5093 expended to keep them in sync. It makes much more sense, usually, to\r
5094 store all of the glossary entries in a single place and simply\r
5095 <quote>extract</quote> the ones you need in each document.</para>\r
5096 \r
5097 <para>That's the purpose of the\r
5098 <parameter>glossary.collection</parameter> parameter. To setup a global\r
5099 glossary <quote>database</quote>, follow these steps:</para>\r
5100 \r
5101 <refsection><info><title>Setting Up the Glossary Database</title></info>\r
5102 \r
5103 <para>First, create a stand-alone glossary document that contains all of\r
5104 the entries that you wish to reference. Make sure that each glossary\r
5105 entry has an ID.</para>\r
5106 \r
5107 <para>Here's an example glossary:</para>\r
5108 \r
5109 <informalexample>\r
5110 <programlisting>\r
5111 &lt;?xml version="1.0" encoding="utf-8"?&gt;\r
5112 &lt;!DOCTYPE glossary\r
5113   PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"\r
5114   "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"&gt;\r
5115 &lt;glossary&gt;\r
5116 &lt;glossaryinfo&gt;\r
5117 &lt;editor&gt;&lt;firstname&gt;Eric&lt;/firstname&gt;&lt;surname&gt;Raymond&lt;/surname&gt;&lt;/editor&gt;\r
5118 &lt;title&gt;Jargon File 4.2.3 (abridged)&lt;/title&gt;\r
5119 &lt;releaseinfo&gt;Just some test data&lt;/releaseinfo&gt;\r
5120 &lt;/glossaryinfo&gt;\r
5121 \r
5122 &lt;glossdiv&gt;&lt;title&gt;0&lt;/title&gt;\r
5123 \r
5124 &lt;glossentry&gt;\r
5125 &lt;glossterm&gt;0&lt;/glossterm&gt;\r
5126 &lt;glossdef&gt;\r
5127 &lt;para&gt;Numeric zero, as opposed to the letter `O' (the 15th letter of\r
5128 the English alphabet). In their unmodified forms they look a lot\r
5129 alike, and various kluges invented to make them visually distinct have\r
5130 compounded the confusion. If your zero is center-dotted and letter-O\r
5131 is not, or if letter-O looks almost rectangular but zero looks more\r
5132 like an American football stood on end (or the reverse), you're\r
5133 probably looking at a modern character display (though the dotted zero\r
5134 seems to have originated as an option on IBM 3270 controllers). If\r
5135 your zero is slashed but letter-O is not, you're probably looking at\r
5136 an old-style ASCII graphic set descended from the default typewheel on\r
5137 the venerable ASR-33 Teletype (Scandinavians, for whom /O is a letter,\r
5138 curse this arrangement). (Interestingly, the slashed zero long\r
5139 predates computers; Florian Cajori's monumental "A History of\r
5140 Mathematical Notations" notes that it was used in the twelfth and\r
5141 thirteenth centuries.) If letter-O has a slash across it and the zero\r
5142 does not, your display is tuned for a very old convention used at IBM\r
5143 and a few other early mainframe makers (Scandinavians curse &lt;emphasis&gt;this&lt;/emphasis&gt;\r
5144 arrangement even more, because it means two of their letters collide).\r
5145 Some Burroughs/Unisys equipment displays a zero with a &lt;emphasis&gt;reversed&lt;/emphasis&gt;\r
5146 slash. Old CDC computers rendered letter O as an unbroken oval and 0\r
5147 as an oval broken at upper right and lower left. And yet another\r
5148 convention common on early line printers left zero unornamented but\r
5149 added a tail or hook to the letter-O so that it resembled an inverted\r
5150 Q or cursive capital letter-O (this was endorsed by a draft ANSI\r
5151 standard for how to draw ASCII characters, but the final standard\r
5152 changed the distinguisher to a tick-mark in the upper-left corner).\r
5153 Are we sufficiently confused yet?&lt;/para&gt;\r
5154 &lt;/glossdef&gt;\r
5155 &lt;/glossentry&gt;\r
5156 \r
5157 &lt;glossentry&gt;\r
5158 &lt;glossterm&gt;1TBS&lt;/glossterm&gt;\r
5159 &lt;glossdef&gt;\r
5160 &lt;para role="accidence"&gt;\r
5161 &lt;phrase role="pronounce"&gt;&lt;/phrase&gt;\r
5162 &lt;phrase role="partsofspeach"&gt;n&lt;/phrase&gt;\r
5163 &lt;/para&gt;\r
5164 &lt;para&gt;The "One True Brace Style"&lt;/para&gt;\r
5165 &lt;glossseealso&gt;indent style&lt;/glossseealso&gt;\r
5166 &lt;/glossdef&gt;\r
5167 &lt;/glossentry&gt;\r
5168 \r
5169 &lt;!-- ... --&gt;\r
5170 \r
5171 &lt;/glossdiv&gt;\r
5172 \r
5173 &lt;!-- ... --&gt;\r
5174 \r
5175 &lt;/glossary&gt;</programlisting>\r
5176 </informalexample>\r
5177 \r
5178 </refsection>\r
5179 \r
5180 <refsection><info><title>Marking Up Glossary Terms</title></info>\r
5181 \r
5182 <para>That takes care of the glossary database, now you have to get the entries\r
5183 into your document. Unlike bibliography entries, which can be empty, creating\r
5184 <quote>placeholder</quote> glossary entries would be very tedious. So instead,\r
5185 support for <parameter>glossary.collection</parameter> relies on implicit linking.</para>\r
5186 \r
5187 <para>In your source document, simply use <tag>firstterm</tag> and\r
5188 <tag>glossterm</tag> to identify the terms you wish to have included\r
5189 in the glossary. The stylesheets assume that you will either set the\r
5190 <tag class="attribute">baseform</tag> attribute correctly, or that the\r
5191 content of the element exactly matches a term in your glossary.</para>\r
5192 \r
5193 <para>If you're using a <parameter>glossary.collection</parameter>, don't\r
5194 make explicit links on the terms in your document.</para>\r
5195 \r
5196 <para>So, in your document, you might write things like this:</para>\r
5197 \r
5198 <informalexample>\r
5199 <programlisting>&lt;para&gt;This is dummy text, without any real meaning.\r
5200 The point is simply to reference glossary terms like &lt;glossterm&gt;0&lt;/glossterm&gt;\r
5201 and the &lt;firstterm baseform="1TBS"&gt;One True Brace Style (1TBS)&lt;/firstterm&gt;.\r
5202 The &lt;glossterm&gt;1TBS&lt;/glossterm&gt;, as you can probably imagine, is a nearly\r
5203 religious issue.&lt;/para&gt;</programlisting>\r
5204 </informalexample>\r
5205 \r
5206 <para>If you set the <parameter>firstterm.only.link</parameter> parameter,\r
5207 only the terms marked with <tag>firstterm</tag> will be links.\r
5208 Otherwise, all the terms will be linked.</para>\r
5209 \r
5210 </refsection>\r
5211 \r
5212 <refsection><info><title>Marking Up the Glossary</title></info>\r
5213 \r
5214 <para>The glossary itself has to be identified for the stylesheets. For lack\r
5215 of a better choice, the <tag class="attribute">role</tag> is used.\r
5216 To identify the glossary as the target for automatic processing, set\r
5217 the role to <quote><literal>auto</literal></quote>. The title of this\r
5218 glossary (and any other information from the <tag>glossaryinfo</tag>\r
5219 that's rendered by your stylesheet) will be displayed, but the entries will\r
5220 come from the database.\r
5221 </para>\r
5222 \r
5223 <para>Unfortunately, the glossary can't be empty, so you must put in\r
5224 at least one <tag>glossentry</tag>. The content of this entry\r
5225 is irrelevant, it will not be rendered:</para>\r
5226 \r
5227 <informalexample>\r
5228 <programlisting>&lt;glossary role="auto"&gt;\r
5229 &lt;glossentry&gt;\r
5230 &lt;glossterm&gt;Irrelevant&lt;/glossterm&gt;\r
5231 &lt;glossdef&gt;\r
5232 &lt;para&gt;If you can see this, the document was processed incorrectly. Use\r
5233 the &lt;parameter&gt;glossary.collection&lt;/parameter&gt; parameter.&lt;/para&gt;\r
5234 &lt;/glossdef&gt;\r
5235 &lt;/glossentry&gt;\r
5236 &lt;/glossary&gt;</programlisting>\r
5237 </informalexample>\r
5238 \r
5239 <para>What about glossary divisions? If your glossary database has glossary\r
5240 divisions <emphasis>and</emphasis> your automatic glossary contains at least\r
5241 one <tag>glossdiv</tag>, the automic glossary will have divisions.\r
5242 If the <tag>glossdiv</tag> is missing from either location, no divisions\r
5243 will be rendered.</para>\r
5244 \r
5245 <para>Glossary entries (and divisions, if appropriate) in the glossary will\r
5246 occur in precisely the order they occur in your database.</para>\r
5247 \r
5248 </refsection>\r
5249 \r
5250 <refsection><info><title>Formatting the Document</title></info>\r
5251 \r
5252 <para>Finally, when you are ready to format your document, simply set the\r
5253 <parameter>glossary.collection</parameter> parameter (in either a\r
5254 customization layer or directly through your processor's interface) to\r
5255 point to your global glossary.</para>\r
5256 \r
5257 <para>The stylesheets will format the glossary in your document as if\r
5258 all of the entries implicilty referenced appeared there literally.</para>\r
5259 </refsection>\r
5260 \r
5261 <refsection><info><title>Limitations</title></info>\r
5262 \r
5263 <para>Glossary cross-references <emphasis>within the glossary</emphasis> are\r
5264 not supported. For example, this <emphasis>will not</emphasis> work:</para>\r
5265 \r
5266 <informalexample>\r
5267 <programlisting>&lt;glossentry&gt;\r
5268 &lt;glossterm&gt;gloss-1&lt;/glossterm&gt;\r
5269 &lt;glossdef&gt;&lt;para&gt;A description that references &lt;glossterm&gt;gloss-2&lt;/glossterm&gt;.&lt;/para&gt;\r
5270 &lt;glossseealso&gt;gloss-2&lt;/glossseealso&gt;\r
5271 &lt;/glossdef&gt;\r
5272 &lt;/glossentry&gt;</programlisting>\r
5273 </informalexample>\r
5274 \r
5275 <para>If you put glossary cross-references in your glossary that way,\r
5276 you'll get the cryptic error: <computeroutput>Warning:\r
5277 glossary.collection specified, but there are 0 automatic\r
5278 glossaries</computeroutput>.</para>\r
5279 \r
5280 <para>Instead, you must do two things:</para>\r
5281 \r
5282 <orderedlist>\r
5283 <listitem>\r
5284 <para>Markup your glossary using <tag>glossseealso</tag>:</para>\r
5285 \r
5286 <informalexample>\r
5287 <programlisting>&lt;glossentry&gt;\r
5288 &lt;glossterm&gt;gloss-1&lt;/glossterm&gt;\r
5289 &lt;glossdef&gt;&lt;para&gt;A description that references &lt;glossterm&gt;gloss-2&lt;/glossterm&gt;.&lt;/para&gt;\r
5290 &lt;glossseealso&gt;gloss-2&lt;/glossseealso&gt;\r
5291 &lt;/glossdef&gt;\r
5292 &lt;/glossentry&gt;</programlisting>\r
5293 </informalexample>\r
5294 </listitem>\r
5295 \r
5296 <listitem>\r
5297 <para>Make sure there is at least one <tag>glossterm</tag> reference to\r
5298 <glossterm>gloss-2</glossterm> <emphasis>in your document</emphasis>. The\r
5299 easiest way to do that is probably within a <tag>remark</tag> in your\r
5300 automatic glossary:</para>\r
5301 \r
5302 <informalexample>\r
5303 <programlisting>&lt;glossary role="auto"&gt;\r
5304 &lt;remark&gt;Make sure there's a reference to &lt;glossterm&gt;gloss-2&lt;/glossterm&gt;.&lt;/remark&gt;\r
5305 &lt;glossentry&gt;\r
5306 &lt;glossterm&gt;Irrelevant&lt;/glossterm&gt;\r
5307 &lt;glossdef&gt;\r
5308 &lt;para&gt;If you can see this, the document was processed incorrectly. Use\r
5309 the &lt;parameter&gt;glossary.collection&lt;/parameter&gt; parameter.&lt;/para&gt;\r
5310 &lt;/glossdef&gt;\r
5311 &lt;/glossentry&gt;\r
5312 &lt;/glossary&gt;</programlisting>\r
5313 </informalexample>\r
5314 </listitem>\r
5315 </orderedlist>\r
5316 </refsection>\r
5317 \r
5318 </refsection>\r
5319 </refentry>\r
5320 \r
5321 <refentry version="5.0" xml:id="glossary.as.blocks">\r
5322 <refmeta>\r
5323 <refentrytitle>glossary.as.blocks</refentrytitle>\r
5324 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
5325 </refmeta>\r
5326 <refnamediv>\r
5327 <refname>glossary.as.blocks</refname>\r
5328 <refpurpose>Present glossarys using blocks instead of lists?</refpurpose>\r
5329 </refnamediv>\r
5330 \r
5331 <refsynopsisdiv>\r
5332 <programlisting xml:id="glossary.as.blocks.frag">\r
5333 &lt;xsl:param name="glossary.as.blocks" select="0"&gt;&lt;/xsl:param&gt;\r
5334 </programlisting>\r
5335 </refsynopsisdiv>\r
5336 \r
5337 <refsection><info><title>Description</title></info>\r
5338 \r
5339 <para>If non-zero, <tag>glossary</tag>s will be formatted as\r
5340 blocks.</para>\r
5341 \r
5342 <para>If you have long <tag>glossterm</tag>s, proper list\r
5343 markup in the FO case may produce unattractive lists. By setting this\r
5344 parameter, you can force the stylesheets to produce block markup\r
5345 instead of proper lists.</para>\r
5346 \r
5347 <para>You can override this setting with a processing instruction as the\r
5348 child of <tag>glossary</tag>: <tag class="xmlpi">dbfo\r
5349 glossary-presentation="blocks"</tag> or <tag class="xmlpi">dbfo\r
5350 glossary-presentation="list"</tag></para>\r
5351 \r
5352 </refsection>\r
5353 </refentry>\r
5354 \r
5355 <refentry version="5.0" xml:id="glosslist.as.blocks">\r
5356 <refmeta>\r
5357 <refentrytitle>glosslist.as.blocks</refentrytitle>\r
5358 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
5359 </refmeta>\r
5360 <refnamediv>\r
5361 <refname>glosslist.as.blocks</refname>\r
5362 <refpurpose>Use blocks for glosslists?</refpurpose>\r
5363 </refnamediv>\r
5364 \r
5365 <refsynopsisdiv>\r
5366 <programlisting xml:id="glosslist.as.blocks.frag">\r
5367 &lt;xsl:param name="glosslist.as.blocks" select="0"&gt;&lt;/xsl:param&gt;\r
5368 </programlisting>\r
5369 </refsynopsisdiv>\r
5370 \r
5371 <refsection><info><title>Description</title></info>\r
5372 \r
5373 <para>See <parameter>glossary.as.blocks</parameter>.</para>\r
5374 \r
5375 </refsection>\r
5376 </refentry>\r
5377 \r
5378 <refentry version="5.0" xml:id="glossentry.list.item.properties">\r
5379 <refmeta>\r
5380 <refentrytitle>glossentry.list.item.properties</refentrytitle>\r
5381 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
5382 </refmeta>\r
5383 <refnamediv>\r
5384 <refname>glossentry.list.item.properties</refname>\r
5385 <refpurpose>To add properties to each glossentry in a list.</refpurpose>\r
5386 </refnamediv>\r
5387 \r
5388 <refsynopsisdiv>\r
5389 <programlisting xml:id="glossentry.list.item.properties.frag">&lt;xsl:attribute-set name="glossentry.list.item.properties"&gt;\r
5390   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;\r
5391   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;\r
5392   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;\r
5393 &lt;/xsl:attribute-set&gt;\r
5394 </programlisting>\r
5395 </refsynopsisdiv>\r
5396 <refsection><info><title>Description</title></info>\r
5397 <para>These properties are added to the fo:list-item containing a\r
5398 glossentry in a glossary when the <parameter>glossary.as.blocks</parameter> parameter\r
5399 is zero.\r
5400 Use this attribute-set to set\r
5401 spacing between entries, for example.</para>\r
5402 \r
5403 </refsection>\r
5404 </refentry>\r
5405 \r
5406 <refentry version="5.0" xml:id="glossterm.block.properties">\r
5407 <refmeta>\r
5408 <refentrytitle>glossterm.block.properties</refentrytitle>\r
5409 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
5410 </refmeta>\r
5411 <refnamediv>\r
5412 <refname>glossterm.block.properties</refname>\r
5413 <refpurpose>To add properties to the block of a glossentry's glossterm.</refpurpose>\r
5414 </refnamediv>\r
5415 \r
5416 <refsynopsisdiv>\r
5417 <programlisting xml:id="glossterm.block.properties.frag">&lt;xsl:attribute-set name="glossterm.block.properties"&gt;\r
5418   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;\r
5419   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;\r
5420   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;\r
5421   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;\r
5422   &lt;xsl:attribute name="keep-together.within-column"&gt;always&lt;/xsl:attribute&gt;\r
5423 &lt;/xsl:attribute-set&gt;\r
5424 </programlisting>\r
5425 </refsynopsisdiv>\r
5426 <refsection><info><title>Description</title></info>\r
5427 <para>These properties are added to the block containing a\r
5428 glossary term in a glossary when the <parameter>glossary.as.blocks</parameter> parameter\r
5429 is non-zero.\r
5430 Use this attribute-set to set the space above and below,\r
5431 font properties,\r
5432 and any indent for the glossary term.</para>\r
5433 \r
5434 </refsection>\r
5435 </refentry>\r
5436 \r
5437 <refentry version="5.0" xml:id="glossdef.block.properties">\r
5438 <refmeta>\r
5439 <refentrytitle>glossdef.block.properties</refentrytitle>\r
5440 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
5441 </refmeta>\r
5442 <refnamediv>\r
5443 <refname>glossdef.block.properties</refname>\r
5444 <refpurpose>To add properties to the block of a glossary definition.</refpurpose>\r
5445 </refnamediv>\r
5446 \r
5447 <refsynopsisdiv>\r
5448 <programlisting xml:id="glossdef.block.properties.frag">&lt;xsl:attribute-set name="glossdef.block.properties"&gt;\r
5449   &lt;xsl:attribute name="margin-{$direction.align.start}"&gt;.25in&lt;/xsl:attribute&gt;\r
5450 &lt;/xsl:attribute-set&gt;\r
5451 </programlisting>\r
5452 </refsynopsisdiv>\r
5453 <refsection><info><title>Description</title></info>\r
5454 <para>These properties are added to the block containing a\r
5455 glossary definition in a glossary when\r
5456 the <parameter>glossary.as.blocks</parameter> parameter\r
5457 is non-zero.\r
5458 Use this attribute-set to set the space above and below,\r
5459 any font properties,\r
5460 and any indent for the glossary definition.</para>\r
5461 \r
5462 </refsection>\r
5463 </refentry>\r
5464 \r
5465 <refentry version="5.0" xml:id="glossterm.list.properties">\r
5466 <refmeta>\r
5467 <refentrytitle>glossterm.list.properties</refentrytitle>\r
5468 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
5469 </refmeta>\r
5470 <refnamediv>\r
5471 <refname>glossterm.list.properties</refname>\r
5472 <refpurpose>To add properties to the glossterm in a list.</refpurpose>\r
5473 </refnamediv>\r
5474 \r
5475 <refsynopsisdiv>\r
5476 <programlisting xml:id="glossterm.list.properties.frag">\r
5477 &lt;xsl:attribute-set name="glossterm.list.properties"&gt;\r
5478 &lt;/xsl:attribute-set&gt;\r
5479 </programlisting>\r
5480 </refsynopsisdiv>\r
5481 <refsection><info><title>Description</title></info>\r
5482 <para>These properties are added to the block containing a\r
5483 glossary term in a glossary when the <parameter>glossary.as.blocks</parameter> parameter\r
5484 is zero.\r
5485 Use this attribute-set to set\r
5486 font properties, for example.</para>\r
5487 \r
5488 </refsection>\r
5489 </refentry>\r
5490 \r
5491 <refentry version="5.0" xml:id="glossdef.list.properties">\r
5492 <refmeta>\r
5493 <refentrytitle>glossdef.list.properties</refentrytitle>\r
5494 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
5495 </refmeta>\r
5496 <refnamediv>\r
5497 <refname>glossdef.list.properties</refname>\r
5498 <refpurpose>To add properties to the glossary definition in a list.</refpurpose>\r
5499 </refnamediv>\r
5500 \r
5501 <refsynopsisdiv>\r
5502 <programlisting xml:id="glossdef.list.properties.frag">\r
5503 &lt;xsl:attribute-set name="glossdef.list.properties"&gt;\r
5504 &lt;/xsl:attribute-set&gt;\r
5505 </programlisting>\r
5506 </refsynopsisdiv>\r
5507 <refsection><info><title>Description</title></info>\r
5508 <para>These properties are added to the block containing a\r
5509 glossary definition in a glossary when\r
5510 the <parameter>glossary.as.blocks</parameter> parameter\r
5511 is zero.\r
5512 Use this attribute-set to set font properties, for example.</para>\r
5513 \r
5514 </refsection>\r
5515 </refentry>\r
5516 \r
5517 <refentry version="5.0" xml:id="glossterm.width">\r
5518 <refmeta>\r
5519 <refentrytitle>glossterm.width</refentrytitle>\r
5520 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
5521 </refmeta>\r
5522 <refnamediv>\r
5523 <refname>glossterm.width</refname>\r
5524 <refpurpose>Width of glossterm in list presentation mode</refpurpose>\r
5525 </refnamediv>\r
5526 \r
5527 <refsynopsisdiv>\r
5528 <programlisting xml:id="glossterm.width.frag">\r
5529 &lt;xsl:param name="glossterm.width"&gt;2in&lt;/xsl:param&gt;\r
5530 </programlisting>\r
5531 </refsynopsisdiv>\r
5532 \r
5533 <refsection><info><title>Description</title></info>\r
5534 \r
5535 <para>This parameter specifies the width reserved for glossary terms when\r
5536 a list presentation is used.</para>\r
5537 \r
5538 </refsection>\r
5539 </refentry>\r
5540 \r
5541 <refentry version="5.0" xml:id="glossterm.separation">\r
5542 <refmeta>\r
5543 <refentrytitle>glossterm.separation</refentrytitle>\r
5544 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
5545 </refmeta>\r
5546 <refnamediv>\r
5547 <refname>glossterm.separation</refname>\r
5548 <refpurpose>Separation between glossary terms and descriptions in list mode</refpurpose>\r
5549 </refnamediv>\r
5550 \r
5551 <refsynopsisdiv>\r
5552 <programlisting xml:id="glossterm.separation.frag">\r
5553 &lt;xsl:param name="glossterm.separation"&gt;0.25in&lt;/xsl:param&gt;\r
5554 </programlisting>\r
5555 </refsynopsisdiv>\r
5556 \r
5557 <refsection><info><title>Description</title></info>\r
5558 \r
5559 <para>Specifies the miminum horizontal\r
5560 separation between glossary terms and descriptions when\r
5561 they are presented side-by-side using lists\r
5562 when the <parameter>glossary.as.blocks</parameter>\r
5563 is zero.</para>\r
5564 \r
5565 </refsection>\r
5566 </refentry>\r
5567 \r
5568 <refentry version="5.0" xml:id="glossentry.show.acronym">\r
5569 <refmeta>\r
5570 <refentrytitle>glossentry.show.acronym</refentrytitle>\r
5571 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>\r
5572 <refmiscinfo class="other" otherclass="value">no</refmiscinfo> \r
5573 <refmiscinfo class="other" otherclass="value">yes</refmiscinfo>\r
5574 <refmiscinfo class="other" otherclass="value">primary</refmiscinfo>\r
5575 </refmeta>\r
5576 <refnamediv>\r
5577 <refname>glossentry.show.acronym</refname>\r
5578 <refpurpose>Display <tag>glossentry</tag> acronyms?</refpurpose>\r
5579 </refnamediv>\r
5580 \r
5581 <refsynopsisdiv>\r
5582 <programlisting xml:id="glossentry.show.acronym.frag">\r
5583 &lt;xsl:param name="glossentry.show.acronym"&gt;no&lt;/xsl:param&gt;\r
5584 </programlisting>\r
5585 </refsynopsisdiv>\r
5586 \r
5587 <refsection><info><title>Description</title></info>\r
5588 \r
5589 <para>A setting of <quote>yes</quote> means they should be displayed;\r
5590 <quote>no</quote> means they shouldn't. If <quote>primary</quote> is used,\r
5591 then they are shown as the primary text for the entry.</para>\r
5592 \r
5593 <note>\r
5594 <para>This setting controls both <tag>acronym</tag> and\r
5595 <tag>abbrev</tag> elements in the <tag>glossentry</tag>.</para>\r
5596 </note>\r
5597 \r
5598 </refsection>\r
5599 </refentry>\r
5600 \r
5601 <refentry version="5.0" xml:id="glossary.sort">\r
5602 <refmeta>\r
5603 <refentrytitle>glossary.sort</refentrytitle>\r
5604 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
5605 </refmeta>\r
5606 <refnamediv>\r
5607 <refname>glossary.sort</refname>\r
5608 <refpurpose>Sort glossentry elements?</refpurpose>\r
5609 </refnamediv>\r
5610 \r
5611 <refsynopsisdiv>\r
5612 <programlisting xml:id="glossary.sort.frag">\r
5613 &lt;xsl:param name="glossary.sort" select="0"&gt;&lt;/xsl:param&gt;\r
5614 </programlisting>\r
5615 </refsynopsisdiv>\r
5616 \r
5617 <refsection><info><title>Description</title></info>\r
5618 \r
5619 <para>If non-zero, then the glossentry elements within a\r
5620 glossary, glossdiv, or glosslist are sorted on the glossterm, using\r
5621 the current lang setting.  If zero (the default), then\r
5622 glossentry elements are not sorted and are presented\r
5623 in document order.\r
5624 </para>\r
5625 \r
5626 </refsection>\r
5627 </refentry>\r
5628 \r
5629 </reference>\r
5630 <reference xml:id="misc"><title>Miscellaneous</title>\r
5631 <refentry version="5.0" xml:id="formal.procedures">\r
5632 <refmeta>\r
5633 <refentrytitle>formal.procedures</refentrytitle>\r
5634 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
5635 </refmeta>\r
5636 <refnamediv>\r
5637 <refname>formal.procedures</refname>\r
5638 <refpurpose>Selects formal or informal procedures</refpurpose>\r
5639 </refnamediv>\r
5640 \r
5641 <refsynopsisdiv>\r
5642 <programlisting xml:id="formal.procedures.frag">\r
5643 &lt;xsl:param name="formal.procedures" select="1"&gt;&lt;/xsl:param&gt;\r
5644 </programlisting>\r
5645 </refsynopsisdiv>\r
5646 \r
5647 <refsection><info><title>Description</title></info>\r
5648 \r
5649 <para>Formal procedures are numbered and always have a title.\r
5650 </para>\r
5651 \r
5652 </refsection>\r
5653 </refentry>\r
5654 \r
5655 <refentry version="5.0" xml:id="formal.title.placement">\r
5656 <refmeta>\r
5657 <refentrytitle>formal.title.placement</refentrytitle>\r
5658 <refmiscinfo class="other" otherclass="datatype">table</refmiscinfo>\r
5659 </refmeta>\r
5660 <refnamediv>\r
5661 <refname>formal.title.placement</refname>\r
5662 <refpurpose>Specifies where formal object titles should occur</refpurpose>\r
5663 </refnamediv>\r
5664 \r
5665 <refsynopsisdiv>\r
5666 <programlisting xml:id="formal.title.placement.frag">\r
5667 &lt;xsl:param name="formal.title.placement"&gt;\r
5668 figure before\r
5669 example before\r
5670 equation before\r
5671 table before\r
5672 procedure before\r
5673 task before\r
5674 &lt;/xsl:param&gt;\r
5675 </programlisting>\r
5676 </refsynopsisdiv>\r
5677 \r
5678 <refsection><info><title>Description</title></info>\r
5679 \r
5680 <para>Specifies where formal object titles should occur. For each formal object\r
5681 type (<tag>figure</tag>,\r
5682 <tag>example</tag>,\r
5683 <tag>equation</tag>,\r
5684 <tag>table</tag>, and <tag>procedure</tag>)\r
5685 you can specify either the keyword\r
5686 <quote><literal>before</literal></quote> or\r
5687 <quote><literal>after</literal></quote>.</para>\r
5688 \r
5689 </refsection>\r
5690 </refentry>\r
5691 \r
5692 <refentry version="5.0" xml:id="runinhead.default.title.end.punct">\r
5693 <refmeta>\r
5694 <refentrytitle>runinhead.default.title.end.punct</refentrytitle>\r
5695 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
5696 </refmeta>\r
5697 <refnamediv>\r
5698 <refname>runinhead.default.title.end.punct</refname>\r
5699 <refpurpose>Default punctuation character on a run-in-head</refpurpose>\r
5700 </refnamediv>\r
5701 \r
5702 <refsynopsisdiv>\r
5703 <programlisting xml:id="runinhead.default.title.end.punct.frag">&lt;xsl:param name="runinhead.default.title.end.punct"&gt;.&lt;/xsl:param&gt;\r
5704 </programlisting>\r
5705 </refsynopsisdiv>\r
5706 \r
5707 <refsection><info><title>Description</title></info>\r
5708 \r
5709 <para>If non-zero, For a <tag>formalpara</tag>, use the specified\r
5710 string as the separator between the title and following text. The period is the default value.</para>\r
5711 \r
5712 </refsection>\r
5713 </refentry>\r
5714 \r
5715 <refentry version="5.0" xml:id="runinhead.title.end.punct">\r
5716 <refmeta>\r
5717 <refentrytitle>runinhead.title.end.punct</refentrytitle>\r
5718 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
5719 </refmeta>\r
5720 <refnamediv>\r
5721 <refname>runinhead.title.end.punct</refname>\r
5722 <refpurpose>Characters that count as punctuation on a run-in-head</refpurpose>\r
5723 </refnamediv>\r
5724 \r
5725 <refsynopsisdiv>\r
5726 <programlisting xml:id="runinhead.title.end.punct.frag">\r
5727 &lt;xsl:param name="runinhead.title.end.punct"&gt;.!?:&lt;/xsl:param&gt;\r
5728 </programlisting>\r
5729 </refsynopsisdiv>\r
5730 \r
5731 <refsection><info><title>Description</title></info>\r
5732 \r
5733 <para>Specify which characters are to be counted as punctuation. These\r
5734 characters are checked for a match with the last character of the\r
5735 title. If no match is found, the\r
5736 <parameter>runinhead.default.title.end.punct</parameter> contents are\r
5737 inserted. This is to avoid duplicated punctuation in the output.\r
5738 </para>\r
5739 \r
5740 </refsection>\r
5741 </refentry>\r
5742 \r
5743 <refentry version="5.0" xml:id="show.comments">\r
5744 <refmeta>\r
5745 <refentrytitle>show.comments</refentrytitle>\r
5746 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
5747 </refmeta>\r
5748 <refnamediv>\r
5749 <refname>show.comments</refname>\r
5750 <refpurpose>Display <tag>remark</tag> elements?</refpurpose>\r
5751 </refnamediv>\r
5752 \r
5753 <refsynopsisdiv>\r
5754 <programlisting xml:id="show.comments.frag">\r
5755 &lt;xsl:param name="show.comments" select="1"&gt;&lt;/xsl:param&gt;\r
5756 </programlisting>\r
5757 </refsynopsisdiv>\r
5758 \r
5759 <refsection><info><title>Description</title></info>\r
5760 \r
5761 <para>If non-zero, comments will be displayed, otherwise they\r
5762 are suppressed.  Comments here refers to the <tag>remark</tag> element\r
5763 (which was called <literal>comment</literal> prior to DocBook\r
5764 4.0), not XML comments (&lt;-- like this --&gt;) which are\r
5765 unavailable.\r
5766 </para>\r
5767 \r
5768 </refsection>\r
5769 </refentry>\r
5770 \r
5771 <refentry version="5.0" xml:id="punct.honorific">\r
5772 <refmeta>\r
5773 <refentrytitle>punct.honorific</refentrytitle>\r
5774 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
5775 </refmeta>\r
5776 <refnamediv>\r
5777 <refname>punct.honorific</refname>\r
5778 <refpurpose>Punctuation after an honorific in a personal name.</refpurpose>\r
5779 </refnamediv>\r
5780 \r
5781 <refsynopsisdiv>\r
5782 <programlisting xml:id="punct.honorific.frag">\r
5783 &lt;xsl:param name="punct.honorific"&gt;.&lt;/xsl:param&gt;\r
5784 </programlisting>\r
5785 </refsynopsisdiv>\r
5786 \r
5787 <refsection><info><title>Description</title></info>\r
5788 \r
5789 <para>This parameter specifies the punctuation that should be added after an\r
5790 honorific in a personal name.</para>\r
5791 \r
5792 </refsection>\r
5793 </refentry>\r
5794 \r
5795 <refentry version="5.0" xml:id="segmentedlist.as.table">\r
5796 <refmeta>\r
5797 <refentrytitle>segmentedlist.as.table</refentrytitle>\r
5798 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
5799 </refmeta>\r
5800 <refnamediv>\r
5801 <refname>segmentedlist.as.table</refname>\r
5802 <refpurpose>Format segmented lists as tables?</refpurpose>\r
5803 </refnamediv>\r
5804 \r
5805 <refsynopsisdiv>\r
5806 <programlisting xml:id="segmentedlist.as.table.frag">\r
5807 &lt;xsl:param name="segmentedlist.as.table" select="0"&gt;&lt;/xsl:param&gt;\r
5808 </programlisting>\r
5809 </refsynopsisdiv>\r
5810 \r
5811 <refsection><info><title>Description</title></info>\r
5812 \r
5813 <para>If non-zero, <tag>segmentedlist</tag>s will be formatted as\r
5814 tables.</para>\r
5815 \r
5816 </refsection>\r
5817 </refentry>\r
5818 \r
5819 <refentry version="5.0" xml:id="variablelist.as.blocks">\r
5820 <refmeta>\r
5821 <refentrytitle>variablelist.as.blocks</refentrytitle>\r
5822 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
5823 </refmeta>\r
5824 <refnamediv>\r
5825 <refname>variablelist.as.blocks</refname>\r
5826 <refpurpose>Format <tag>variablelist</tag>s lists as blocks?</refpurpose>\r
5827 </refnamediv>\r
5828 \r
5829 <refsynopsisdiv>\r
5830 <programlisting xml:id="variablelist.as.blocks.frag">\r
5831 &lt;xsl:param name="variablelist.as.blocks" select="0"&gt;&lt;/xsl:param&gt;\r
5832 </programlisting>\r
5833 </refsynopsisdiv>\r
5834 \r
5835 <refsection><info><title>Description</title></info>\r
5836 \r
5837 <para>If non-zero, <tag>variablelist</tag>s will be formatted as\r
5838 blocks.</para>\r
5839 \r
5840 <para>If you have long terms, proper list markup in the FO case may produce\r
5841 unattractive lists. By setting this parameter, you can force the stylesheets\r
5842 to produce block markup instead of proper lists.</para>\r
5843 \r
5844 <para>You can override this setting with a processing instruction as the\r
5845 child of <tag>variablelist</tag>: <tag class="xmlpi">dbfo\r
5846 list-presentation="blocks"</tag> or <tag class="xmlpi">dbfo\r
5847 list-presentation="list"</tag>.</para>\r
5848 \r
5849 <para>When using <literal>list-presentation="list"</literal>,\r
5850 you can also control the amount of space used for the <tag>term</tag>s with \r
5851 the <tag class="xmlpi">dbfo term-width=".25in"</tag> processing instruction,\r
5852 the <tag class="attribute">termlength</tag> attribute on <tag>variablelist</tag>,\r
5853 or allow the stylesheets to attempt to calculate the amount of space to leave based on the \r
5854 number of letters in the longest term.  \r
5855 </para>\r
5856 \r
5857 <programlisting>  &lt;variablelist&gt;\r
5858         &lt;?dbfo list-presentation="list"?&gt;\r
5859         &lt;?dbfo term-width="1.5in"?&gt;\r
5860         &lt;?dbhtml list-presentation="table"?&gt;\r
5861         &lt;?dbhtml term-width="1.5in"?&gt;\r
5862         &lt;varlistentry&gt;\r
5863           &lt;term&gt;list&lt;/term&gt;\r
5864           &lt;listitem&gt;\r
5865                 &lt;para&gt;\r
5866                   Formatted as a list even if variablelist.as.blocks is set to 1.\r
5867                 &lt;/para&gt;\r
5868           &lt;/listitem&gt;\r
5869         &lt;/varlistentry&gt;\r
5870   &lt;/variablelist&gt;</programlisting>\r
5871 \r
5872 \r
5873 </refsection>\r
5874 \r
5875 </refentry>\r
5876 \r
5877 <refentry version="5.0" xml:id="blockquote.properties">\r
5878 <refmeta>\r
5879   <refentrytitle>blockquote.properties</refentrytitle>\r
5880   <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
5881 </refmeta>  \r
5882 <refnamediv>\r
5883 <refname>blockquote.properties</refname>\r
5884 <refpurpose>To set the style for block quotations.</refpurpose>\r
5885 </refnamediv>\r
5886 \r
5887 <refsynopsisdiv>\r
5888 <programlisting xml:id="blockquote.properties.frag">\r
5889 &lt;xsl:attribute-set name="blockquote.properties"&gt;\r
5890 &lt;xsl:attribute name="margin-{$direction.align.start}"&gt;0.5in&lt;/xsl:attribute&gt;\r
5891 &lt;xsl:attribute name="margin-{$direction.align.end}"&gt;0.5in&lt;/xsl:attribute&gt;\r
5892 &lt;xsl:attribute name="space-after.minimum"&gt;0.5em&lt;/xsl:attribute&gt;\r
5893 &lt;xsl:attribute name="space-after.optimum"&gt;1em&lt;/xsl:attribute&gt;\r
5894 &lt;xsl:attribute name="space-after.maximum"&gt;2em&lt;/xsl:attribute&gt;\r
5895 &lt;/xsl:attribute-set&gt;\r
5896 </programlisting>\r
5897 </refsynopsisdiv>\r
5898 \r
5899 <refsection><info><title>Description</title></info>\r
5900 \r
5901 <para>The <parameter>blockquote.properties</parameter> attribute set specifies\r
5902 the formating properties of block quotations.</para>\r
5903 \r
5904 </refsection>\r
5905 </refentry>\r
5906 \r
5907 <refentry version="5.0" xml:id="ulink.show">\r
5908 <refmeta>\r
5909 <refentrytitle>ulink.show</refentrytitle>\r
5910 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
5911 </refmeta>\r
5912 <refnamediv>\r
5913 <refname>ulink.show</refname>\r
5914 <refpurpose>Display URLs after <tag>ulink</tag>s?</refpurpose>\r
5915 </refnamediv>\r
5916 \r
5917 <refsynopsisdiv>\r
5918 <programlisting xml:id="ulink.show.frag">\r
5919 &lt;xsl:param name="ulink.show" select="1"&gt;&lt;/xsl:param&gt;\r
5920 </programlisting>\r
5921 </refsynopsisdiv>\r
5922 \r
5923 <refsection><info><title>Description</title></info>\r
5924 \r
5925 <para>If non-zero, the URL of each <tag>ulink</tag> will\r
5926 appear after the text of the link. If the text of the link and the URL\r
5927 are identical, the URL is suppressed. </para>\r
5928 \r
5929 <para>See also <parameter>ulink.footnotes</parameter>.</para>\r
5930 \r
5931 <note><para>DocBook 5 does not have an <tag>ulink</tag> element. When processing \r
5932 DocBoook 5 documents, <parameter>ulink.show</parameter> applies to all inline \r
5933 elements that are marked up with <tag class="attribute">xlink:href</tag> attributes \r
5934 that point to external resources.</para>\r
5935 </note>\r
5936 \r
5937 </refsection>\r
5938 </refentry>\r
5939 \r
5940 <refentry version="5.0" xml:id="ulink.footnotes">\r
5941 <refmeta>\r
5942 <refentrytitle>ulink.footnotes</refentrytitle>\r
5943 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
5944 </refmeta>\r
5945 <refnamediv>\r
5946 <refname>ulink.footnotes</refname>\r
5947 <refpurpose>Generate footnotes for <tag>ulink</tag>s?</refpurpose>\r
5948 </refnamediv>\r
5949 \r
5950 <refsynopsisdiv>\r
5951 <programlisting xml:id="ulink.footnotes.frag">\r
5952 &lt;xsl:param name="ulink.footnotes" select="0"&gt;&lt;/xsl:param&gt;\r
5953 </programlisting>\r
5954 </refsynopsisdiv>\r
5955 \r
5956 <refsection><info><title>Description</title></info>\r
5957 \r
5958 <para>If non-zero, and if <parameter>ulink.show</parameter> also is non-zero,\r
5959 the URL of each <tag>ulink</tag> will appear as a footnote.</para>\r
5960 \r
5961 <note><para>DocBook 5 does not have an <tag>ulink</tag> element. When processing \r
5962 DocBoook 5 documents, <parameter>ulink.footnotes</parameter> applies to all inline \r
5963 elements that are marked up with <tag class="attribute">xlink:href</tag> attributes \r
5964 that point to external resources.</para>\r
5965 </note>\r
5966 \r
5967 </refsection>\r
5968 </refentry>\r
5969 \r
5970 <refentry version="5.0" xml:id="ulink.hyphenate">\r
5971 <refmeta>\r
5972 <refentrytitle>ulink.hyphenate</refentrytitle>\r
5973 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
5974 </refmeta>\r
5975 <refnamediv>\r
5976 <refname>ulink.hyphenate</refname>\r
5977 <refpurpose>Allow URLs to be automatically hyphenated</refpurpose>\r
5978 </refnamediv>\r
5979 \r
5980 <refsynopsisdiv>\r
5981 <programlisting xml:id="ulink.hyphenate.frag">\r
5982 &lt;xsl:param name="ulink.hyphenate"&gt;&lt;/xsl:param&gt;\r
5983 </programlisting>\r
5984 </refsynopsisdiv>\r
5985 \r
5986 <refsection><info><title>Description</title></info>\r
5987 \r
5988 <para>If not empty, the specified character (or more generally, content) is\r
5989 added to URLs after every character included in the string\r
5990 in the <parameter>ulink.hyphenate.chars</parameter> parameter (default\r
5991 is <quote>/</quote>). If the character in this parameter is a\r
5992 Unicode soft hyphen (0x00AD) or Unicode zero-width space (0x200B), some FO\r
5993 processors will be able to reasonably hyphenate long URLs.</para>\r
5994 \r
5995 <para>As of 28 Jan 2002, discretionary hyphens are more widely and correctly\r
5996 supported than zero-width spaces for this purpose.</para>\r
5997 \r
5998 </refsection>\r
5999 </refentry>\r
6000 \r
6001 <refentry version="5.0" xml:id="ulink.hyphenate.chars">\r
6002 <refmeta>\r
6003 <refentrytitle>ulink.hyphenate.chars</refentrytitle>\r
6004 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
6005 </refmeta>\r
6006 <refnamediv>\r
6007 <refname>ulink.hyphenate.chars</refname>\r
6008 <refpurpose>List of characters to allow ulink URLs to be automatically hyphenated on</refpurpose>\r
6009 </refnamediv>\r
6010 \r
6011 <refsynopsisdiv>\r
6012 <programlisting xml:id="ulink.hyphenate.chars.frag">\r
6013 &lt;xsl:param name="ulink.hyphenate.chars"&gt;/&lt;/xsl:param&gt;\r
6014 </programlisting>\r
6015 </refsynopsisdiv>\r
6016 \r
6017 <refsection><info><title>Description</title></info>\r
6018 \r
6019 <para>If the <parameter>ulink.hyphenate</parameter> is not empty, then \r
6020 hyphenation of ulinks is turned on, and any\r
6021 character contained in this parameter is treated as an allowable\r
6022 hyphenation point.</para>\r
6023 \r
6024 <para>The default value is <quote>/</quote>, but the parameter\r
6025 could be customized\r
6026 to contain other URL characters, as for example:</para>\r
6027 <programlisting>\r
6028 &lt;xsl:param name="ulink.hyphenate.chars"&gt;:/@&amp;?.#&lt;/xsl:param&gt;\r
6029 </programlisting>\r
6030 \r
6031 </refsection>\r
6032 </refentry>\r
6033 \r
6034 <refentry version="5.0" xml:id="shade.verbatim">\r
6035 <refmeta>\r
6036 <refentrytitle>shade.verbatim</refentrytitle>\r
6037 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
6038 </refmeta>\r
6039 <refnamediv>\r
6040 <refname>shade.verbatim</refname>\r
6041 <refpurpose>Should verbatim environments be shaded?</refpurpose>\r
6042 </refnamediv>\r
6043 \r
6044 <refsynopsisdiv>\r
6045 <programlisting xml:id="shade.verbatim.frag">&lt;xsl:param name="shade.verbatim" select="0"&gt;&lt;/xsl:param&gt;</programlisting>\r
6046 </refsynopsisdiv>\r
6047 \r
6048 <refsection><info><title>Description</title></info>\r
6049 \r
6050 <para>In the FO stylesheet, if this parameter is non-zero then the\r
6051 <property>shade.verbatim.style</property> properties will be applied\r
6052 to verbatim environments.</para>\r
6053 \r
6054 <para>In the HTML stylesheet, this parameter is now deprecated. Use\r
6055 CSS instead.</para>\r
6056 \r
6057 </refsection>\r
6058 </refentry>\r
6059 \r
6060 <refentry version="5.0" xml:id="shade.verbatim.style">\r
6061 <refmeta>\r
6062 <refentrytitle>shade.verbatim.style</refentrytitle>\r
6063 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
6064 </refmeta>\r
6065 <refnamediv>\r
6066 <refname>shade.verbatim.style</refname>\r
6067 <refpurpose>Properties that specify the style of shaded verbatim listings</refpurpose>\r
6068 </refnamediv>\r
6069 \r
6070 <refsynopsisdiv>\r
6071 <programlisting xml:id="shade.verbatim.style.frag">\r
6072 \r
6073 &lt;xsl:attribute-set name="shade.verbatim.style"&gt;\r
6074   &lt;xsl:attribute name="background-color"&gt;#E0E0E0&lt;/xsl:attribute&gt;\r
6075 &lt;/xsl:attribute-set&gt;\r
6076 </programlisting>\r
6077 </refsynopsisdiv>\r
6078 \r
6079 <refsection><info><title>Description</title></info>\r
6080 \r
6081 <para>Properties that specify the style of shaded verbatim listings. The\r
6082 parameters specified (the border and background color) are added to\r
6083 the styling of the xsl-fo output. A border might be specified as "thin\r
6084 black solid" for example. See <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.w3.org/TR/2004/WD-xsl11-20041216/#border">xsl-fo</link></para>\r
6085 \r
6086 </refsection>\r
6087 </refentry>\r
6088 \r
6089 <refentry version="5.0" xml:id="hyphenate.verbatim">\r
6090 <refmeta>\r
6091 <refentrytitle>hyphenate.verbatim</refentrytitle>\r
6092 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
6093 </refmeta>\r
6094 <refnamediv>\r
6095 <refname>hyphenate.verbatim</refname>\r
6096 <refpurpose>Should verbatim environments be hyphenated on space characters?</refpurpose>\r
6097 </refnamediv>\r
6098 \r
6099 <refsynopsisdiv>\r
6100 <programlisting xml:id="hyphenate.verbatim.frag">&lt;xsl:param name="hyphenate.verbatim" select="0"&gt;&lt;/xsl:param&gt;</programlisting>\r
6101 </refsynopsisdiv>\r
6102 \r
6103 <refsection><info><title>Description</title></info>\r
6104 \r
6105 <para>If the lines of program listing are too long to fit into one\r
6106 line it is quite common to split them at space and indicite by hook\r
6107 arrow that code continues on the next line. You can turn on this\r
6108 behaviour for <tag>programlisting</tag>,\r
6109 <tag>screen</tag> and <tag>synopsis</tag> elements by\r
6110 using this parameter.</para>\r
6111 \r
6112 <para>Note that you must also enable line wrapping for verbatim environments and\r
6113 select appropriate hyphenation character (e.g. hook arrow). This can\r
6114 be done using <parameter>monospace.verbatim.properties</parameter>\r
6115 attribute set:</para>\r
6116 \r
6117 <programlisting>&lt;xsl:attribute-set name="monospace.verbatim.properties" \r
6118                    use-attribute-sets="verbatim.properties monospace.properties"&gt;\r
6119   &lt;xsl:attribute name="wrap-option"&gt;wrap&lt;/xsl:attribute&gt;\r
6120   &lt;xsl:attribute name="hyphenation-character"&gt;&amp;#x25BA;&lt;/xsl:attribute&gt;\r
6121 &lt;/xsl:attribute-set&gt;</programlisting>\r
6122 \r
6123 <para>For a list of arrows available in Unicode see <uri xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.unicode.org/charts/PDF/U2190.pdf">http://www.unicode.org/charts/PDF/U2190.pdf</uri> and <uri xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.unicode.org/charts/PDF/U2900.pdf">http://www.unicode.org/charts/PDF/U2900.pdf</uri> and make sure that\r
6124 selected character is available in the font you are using for verbatim\r
6125 environments.</para>\r
6126 \r
6127 </refsection>\r
6128 </refentry>\r
6129 \r
6130 <refentry version="5.0" xml:id="hyphenate.verbatim.characters">\r
6131 <refmeta>\r
6132 <refentrytitle>hyphenate.verbatim.characters</refentrytitle>\r
6133 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
6134 </refmeta>\r
6135 <refnamediv>\r
6136 <refname>hyphenate.verbatim.characters</refname>\r
6137 <refpurpose>List of characters after which a line break can occur in listings</refpurpose>\r
6138 </refnamediv>\r
6139 \r
6140 <refsynopsisdiv>\r
6141 <programlisting xml:id="hyphenate.verbatim.characters.frag">\r
6142 &lt;xsl:param name="hyphenate.verbatim.characters"&gt;&lt;/xsl:param&gt;\r
6143 </programlisting>\r
6144 </refsynopsisdiv>\r
6145 \r
6146 <refsection><info><title>Description</title></info>\r
6147 \r
6148 <para>If you enable <parameter>hyphenate.verbatim</parameter> line\r
6149 breaks are allowed only on space characters. If this is not enough for\r
6150 your document, you can specify list of additional characters after\r
6151 which line break is allowed in this parameter.</para>\r
6152 \r
6153 </refsection>\r
6154 </refentry>\r
6155 \r
6156 <refentry version="5.0" xml:id="use.svg">\r
6157 <refmeta>\r
6158 <refentrytitle>use.svg</refentrytitle>\r
6159 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
6160 </refmeta>\r
6161 <refnamediv>\r
6162 <refname>use.svg</refname>\r
6163 <refpurpose>Allow SVG in the result tree?</refpurpose>\r
6164 </refnamediv>\r
6165 \r
6166 <refsynopsisdiv>\r
6167 <programlisting xml:id="use.svg.frag">\r
6168 &lt;xsl:param name="use.svg" select="1"&gt;&lt;/xsl:param&gt;\r
6169 </programlisting>\r
6170 </refsynopsisdiv>\r
6171 \r
6172 <refsection><info><title>Description</title></info>\r
6173 \r
6174 <para>If non-zero, SVG will be considered an acceptable image format. SVG\r
6175 is passed through to the result tree, so correct rendering of the resulting\r
6176 diagram depends on the formatter (FO processor or web browser) that is used\r
6177 to process the output from the stylesheet.</para>\r
6178 \r
6179 </refsection>\r
6180 </refentry>\r
6181 \r
6182 <refentry version="5.0" xml:id="use.role.as.xrefstyle">\r
6183 <refmeta>\r
6184 <refentrytitle>use.role.as.xrefstyle</refentrytitle>\r
6185 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
6186 </refmeta>\r
6187 <refnamediv>\r
6188 <refname>use.role.as.xrefstyle</refname>\r
6189 <refpurpose>Use <tag class="attribute">role</tag> attribute for\r
6190 <tag class="attribute">xrefstyle</tag> on <tag>xref</tag>?</refpurpose>\r
6191 </refnamediv>\r
6192 \r
6193 <refsynopsisdiv>\r
6194 <programlisting xml:id="use.role.as.xrefstyle.frag">\r
6195 &lt;xsl:param name="use.role.as.xrefstyle" select="1"&gt;&lt;/xsl:param&gt;\r
6196 </programlisting>\r
6197 </refsynopsisdiv>\r
6198 \r
6199 <refsection><info><title>Description</title></info>\r
6200 \r
6201 <para>In DocBook documents that conform to a schema older than V4.3, this parameter allows \r
6202 <tag class="attribute">role</tag> to serve the purpose of specifying the cross reference style.</para>\r
6203 \r
6204 <para>If non-zero, the <tag class="attribute">role</tag> attribute on\r
6205 <tag>xref</tag> will be used to select the cross reference style.\r
6206 In DocBook V4.3, the <tag class="attribute">xrefstyle</tag> attribute was added for this purpose.\r
6207 If the <tag class="attribute">xrefstyle</tag> attribute is present, \r
6208 <tag class="attribute">role</tag> will be ignored, regardless of the setting\r
6209 of this parameter.</para>\r
6210 \r
6211 </refsection>\r
6212 \r
6213 <refsection><info><title>Example</title></info>\r
6214 \r
6215 <para>The following small stylesheet shows how to configure the\r
6216 stylesheets to make use of the cross reference style:</para>\r
6217 \r
6218 <programlisting>&lt;?xml version="1.0"?&gt;\r
6219 &lt;xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"\r
6220                 version="1.0"&gt;\r
6221 \r
6222 &lt;xsl:import href="../xsl/html/docbook.xsl"/&gt;\r
6223 \r
6224 &lt;xsl:output method="html"/&gt;\r
6225 \r
6226 &lt;xsl:param name="local.l10n.xml" select="document('')"/&gt;\r
6227 &lt;l:i18n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0"&gt;\r
6228   &lt;l:l10n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0" language="en"&gt;\r
6229    &lt;l:context name="xref"&gt;\r
6230       &lt;l:template name="chapter" style="title" text="Chapter %n, %t"/&gt;\r
6231       &lt;l:template name="chapter" text="Chapter %n"/&gt;\r
6232     &lt;/l:context&gt;\r
6233   &lt;/l:l10n&gt;\r
6234 &lt;/l:i18n&gt;\r
6235 \r
6236 &lt;/xsl:stylesheet&gt;</programlisting>\r
6237 \r
6238 <para>With this stylesheet, the cross references in the following document:</para>\r
6239 \r
6240 <programlisting>&lt;?xml version="1.0" encoding="utf-8"?&gt;\r
6241 &lt;!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"\r
6242                   "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"&gt;\r
6243 &lt;book id="book"&gt;&lt;title&gt;Book&lt;/title&gt;\r
6244 \r
6245 &lt;preface&gt;\r
6246 &lt;title&gt;Preface&lt;/title&gt;\r
6247 \r
6248 &lt;para&gt;Normal: &lt;xref linkend="ch1"/&gt;.&lt;/para&gt;\r
6249 &lt;para&gt;Title: &lt;xref xrefstyle="title" linkend="ch1"/&gt;.&lt;/para&gt;\r
6250 \r
6251 &lt;/preface&gt;\r
6252 \r
6253 &lt;chapter id="ch1"&gt;\r
6254 &lt;title&gt;First Chapter&lt;/title&gt;\r
6255 \r
6256 &lt;para&gt;Irrelevant.&lt;/para&gt;\r
6257 \r
6258 &lt;/chapter&gt;\r
6259 &lt;/book&gt;</programlisting>\r
6260 \r
6261 <para>will appear as:</para>\r
6262 \r
6263 <informalexample>\r
6264 <para>Normal: Chapter 1.</para>\r
6265 <para>Title: Chapter 1, <emphasis>First Chapter</emphasis>.</para>\r
6266 </informalexample>\r
6267 </refsection>\r
6268 \r
6269 </refentry>\r
6270 \r
6271 <refentry version="5.0" xml:id="menuchoice.separator">\r
6272 <refmeta>\r
6273 <refentrytitle>menuchoice.separator</refentrytitle>\r
6274 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
6275 </refmeta>\r
6276 <refnamediv>\r
6277 <refname>menuchoice.separator</refname>\r
6278 <refpurpose>Separator between items of a <tag>menuchoice</tag>\r
6279 other than <tag>guimenuitem</tag> and\r
6280 <tag>guisubmenu</tag></refpurpose>\r
6281 </refnamediv>\r
6282 \r
6283 <refsynopsisdiv>\r
6284 <programlisting xml:id="menuchoice.separator.frag">\r
6285 &lt;xsl:param name="menuchoice.separator"&gt;+&lt;/xsl:param&gt;\r
6286 </programlisting>\r
6287 </refsynopsisdiv>\r
6288 \r
6289 <refsection><info><title>Description</title></info>\r
6290 \r
6291 <para>Separator used to connect items of a <tag>menuchoice</tag> other\r
6292 than <tag>guimenuitem</tag> and <tag>guisubmenu</tag>. The latter\r
6293 elements are linked with <parameter>menuchoice.menu.separator</parameter>.\r
6294 </para>\r
6295 \r
6296 </refsection>\r
6297 </refentry>\r
6298 \r
6299 <refentry version="5.0" xml:id="menuchoice.menu.separator">\r
6300 <refmeta>\r
6301 <refentrytitle>menuchoice.menu.separator</refentrytitle>\r
6302 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
6303 </refmeta>\r
6304 <refnamediv>\r
6305 <refname>menuchoice.menu.separator</refname>\r
6306 <refpurpose>Separator between items of a <tag>menuchoice</tag>\r
6307 with <tag>guimenuitem</tag> or\r
6308 <tag>guisubmenu</tag></refpurpose>\r
6309 </refnamediv>\r
6310 \r
6311 <refsynopsisdiv>\r
6312 <programlisting xml:id="menuchoice.menu.separator.frag">\r
6313 &lt;xsl:param name="menuchoice.menu.separator"&gt; &#8594; &lt;/xsl:param&gt;\r
6314 </programlisting>\r
6315 </refsynopsisdiv>\r
6316 \r
6317 <refsection><info><title>Description</title></info>\r
6318 \r
6319 <para>Separator used to connect items of a <tag>menuchoice</tag> with\r
6320 <tag>guimenuitem</tag> or <tag>guisubmenu</tag>. Other elements\r
6321 are linked with <parameter>menuchoice.separator</parameter>.\r
6322 </para>\r
6323 <para>The default value is &amp;#x2192;, which is the\r
6324 &amp;rarr; (right arrow) character entity.  \r
6325 The current FOP (0.20.5) requires setting the font-family\r
6326 explicitly.\r
6327 </para>\r
6328 <para>The default value also includes spaces around the arrow,\r
6329 which will allow a line to break.  Replace the spaces with\r
6330 &amp;#xA0; (nonbreaking space) if you don't want those\r
6331 spaces to break.\r
6332 </para>\r
6333 \r
6334 </refsection>\r
6335 </refentry>\r
6336 \r
6337 <refentry version="5.0" xml:id="default.float.class">\r
6338 <refmeta>\r
6339 <refentrytitle>default.float.class</refentrytitle>\r
6340 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
6341 </refmeta>\r
6342 <refnamediv>\r
6343 <refname>default.float.class</refname>\r
6344 <refpurpose>Specifies the default float class</refpurpose>\r
6345 </refnamediv>\r
6346 \r
6347 <refsynopsisdiv>\r
6348 <programlisting xml:id="default.float.class.frag">\r
6349 &lt;xsl:param name="default.float.class"&gt;\r
6350   &lt;xsl:choose&gt;\r
6351     &lt;xsl:when test="contains($stylesheet.result.type,'html')"&gt;left&lt;/xsl:when&gt;\r
6352     &lt;xsl:otherwise&gt;before&lt;/xsl:otherwise&gt;\r
6353   &lt;/xsl:choose&gt;\r
6354 &lt;/xsl:param&gt;\r
6355 </programlisting>\r
6356 </refsynopsisdiv>\r
6357 \r
6358 <refsection><info><title>Description</title></info>\r
6359 \r
6360 <para>Selects the direction in which a float should be placed. for\r
6361 xsl-fo this is before, for html it is left. For Western texts, the\r
6362 before direction is the top of the page.</para>\r
6363 \r
6364 </refsection>\r
6365 </refentry>\r
6366 \r
6367 <refentry version="5.0" xml:id="footnote.number.format">\r
6368 <refmeta>\r
6369 <refentrytitle>footnote.number.format</refentrytitle>\r
6370 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> \r
6371 <refmiscinfo class="other" otherclass="value">1<alt>1,2,3...</alt></refmiscinfo>\r
6372 <refmiscinfo class="other" otherclass="value">A<alt>A,B,C...</alt></refmiscinfo>\r
6373 <refmiscinfo class="other" otherclass="value">a<alt>a,b,c...</alt></refmiscinfo>\r
6374 <refmiscinfo class="other" otherclass="value">i<alt>i,ii,iii...</alt></refmiscinfo>\r
6375 <refmiscinfo class="other" otherclass="value">I<alt>I,II,III...</alt></refmiscinfo>\r
6376 </refmeta>\r
6377 <refnamediv>\r
6378 <refname>footnote.number.format</refname>\r
6379 <refpurpose>Identifies the format used for footnote numbers</refpurpose>\r
6380 </refnamediv>\r
6381 \r
6382 <refsynopsisdiv>\r
6383 <programlisting xml:id="footnote.number.format.frag">\r
6384 &lt;xsl:param name="footnote.number.format"&gt;1&lt;/xsl:param&gt;\r
6385 </programlisting>\r
6386 </refsynopsisdiv>\r
6387 \r
6388 <refsection><info><title>Description</title></info>\r
6389 \r
6390 <para>The <parameter>footnote.number.format</parameter> specifies the format\r
6391 to use for footnote numeration (1, i, I, a, or A).</para>\r
6392 \r
6393 </refsection>\r
6394 </refentry>\r
6395 \r
6396 <refentry version="5.0" xml:id="table.footnote.number.format">\r
6397 <refmeta>\r
6398 <refentrytitle>table.footnote.number.format</refentrytitle>\r
6399 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo> \r
6400 <refmiscinfo class="other" otherclass="value">1<alt>1,2,3...</alt></refmiscinfo>\r
6401 <refmiscinfo class="other" otherclass="value">A<alt>A,B,C...</alt></refmiscinfo>\r
6402 <refmiscinfo class="other" otherclass="value">a<alt>a,b,c...</alt></refmiscinfo>\r
6403 <refmiscinfo class="other" otherclass="value">i<alt>i,ii,iii...</alt></refmiscinfo>\r
6404 <refmiscinfo class="other" otherclass="value">I<alt>I,II,III...</alt></refmiscinfo>\r
6405 </refmeta>\r
6406 <refnamediv>\r
6407 <refname>table.footnote.number.format</refname>\r
6408 <refpurpose>Identifies the format used for footnote numbers in tables</refpurpose>\r
6409 </refnamediv>\r
6410 \r
6411 <refsynopsisdiv>\r
6412 <programlisting xml:id="table.footnote.number.format.frag">\r
6413 &lt;xsl:param name="table.footnote.number.format"&gt;a&lt;/xsl:param&gt;\r
6414 </programlisting>\r
6415 </refsynopsisdiv>\r
6416 \r
6417 <refsection><info><title>Description</title></info>\r
6418 \r
6419 <para>The <parameter>table.footnote.number.format</parameter> specifies the format\r
6420 to use for footnote numeration (1, i, I, a, or A) in tables.</para>\r
6421 \r
6422 </refsection>\r
6423 </refentry>\r
6424 \r
6425 <refentry version="5.0" xml:id="footnote.number.symbols">\r
6426 <refmeta>\r
6427 <refentrytitle>footnote.number.symbols</refentrytitle>\r
6428 <refmiscinfo class="other" otherclass="datatype"/>\r
6429 </refmeta>\r
6430 <refnamediv>\r
6431 <refname>footnote.number.symbols</refname>\r
6432 <refpurpose>Special characters to use as footnote markers</refpurpose>\r
6433 </refnamediv>\r
6434 \r
6435 <refsynopsisdiv>\r
6436 <programlisting xml:id="footnote.number.symbols.frag">\r
6437 &lt;xsl:param name="footnote.number.symbols"&gt;&lt;/xsl:param&gt;\r
6438 </programlisting>\r
6439 </refsynopsisdiv>\r
6440 \r
6441 <refsection><info><title>Description</title></info>\r
6442 \r
6443 <para>If <parameter>footnote.number.symbols</parameter> is not the empty string,\r
6444 footnotes will use the characters it contains as footnote symbols. For example,\r
6445 <quote>*&amp;#x2020;&amp;#x2021;&amp;#x25CA;&amp;#x2720;</quote> will identify\r
6446 footnotes with <quote>*</quote>, <quote>&#8224;</quote>, <quote>&#8225;</quote>,\r
6447 <quote>&#9674;</quote>, and <quote>&#10016;</quote>. If there are more footnotes\r
6448 than symbols, the stylesheets will fall back to numbered footnotes using\r
6449 <parameter>footnote.number.format</parameter>.</para>\r
6450 \r
6451 <para>The use of symbols for footnotes depends on the ability of your\r
6452 processor (or browser) to render the symbols you select. Not all systems are\r
6453 capable of displaying the full range of Unicode characters. If the quoted characters\r
6454 in the preceding paragraph are not displayed properly, that's a good indicator\r
6455 that you may have trouble using those symbols for footnotes.</para>\r
6456 \r
6457 </refsection>\r
6458 </refentry>\r
6459 \r
6460 <refentry version="5.0" xml:id="table.footnote.number.symbols">\r
6461 <refmeta>\r
6462 <refentrytitle>table.footnote.number.symbols</refentrytitle>\r
6463 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
6464 </refmeta>\r
6465 <refnamediv>\r
6466 <refname>table.footnote.number.symbols</refname>\r
6467 <refpurpose>Special characters to use a footnote markers in tables</refpurpose>\r
6468 </refnamediv>\r
6469 \r
6470 <refsynopsisdiv>\r
6471 <programlisting xml:id="table.footnote.number.symbols.frag">\r
6472 &lt;xsl:param name="table.footnote.number.symbols"&gt;&lt;/xsl:param&gt;\r
6473 </programlisting>\r
6474 </refsynopsisdiv>\r
6475 \r
6476 <refsection><info><title>Description</title></info>\r
6477 \r
6478 <para>If <parameter>table.footnote.number.symbols</parameter> is not the empty string,\r
6479 table footnotes will use the characters it contains as footnote symbols. For example,\r
6480 <quote>*&amp;#x2020;&amp;#x2021;&amp;#x25CA;&amp;#x2720;</quote> will identify\r
6481 footnotes with <quote>*</quote>, <quote>&#8224;</quote>, <quote>&#8225;</quote>,\r
6482 <quote>&#9674;</quote>, and <quote>&#10016;</quote>. If there are more footnotes\r
6483 than symbols, the stylesheets will fall back to numbered footnotes using\r
6484 <parameter>table.footnote.number.format</parameter>.</para>\r
6485 \r
6486 <para>The use of symbols for footnotes depends on the ability of your\r
6487 processor (or browser) to render the symbols you select. Not all systems are\r
6488 capable of displaying the full range of Unicode characters. If the quoted characters\r
6489 in the preceding paragraph are not displayed properly, that's a good indicator\r
6490 that you may have trouble using those symbols for footnotes.</para>\r
6491 \r
6492 </refsection>\r
6493 </refentry>\r
6494 \r
6495 <refentry version="5.0" xml:id="footnote.properties">\r
6496 <refmeta>\r
6497 <refentrytitle>footnote.properties</refentrytitle>\r
6498 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
6499 </refmeta>  \r
6500 <refnamediv>\r
6501 <refname>footnote.properties</refname>\r
6502 <refpurpose>Properties applied to each footnote body\r
6503 </refpurpose>\r
6504 </refnamediv>\r
6505 \r
6506 <refsynopsisdiv>\r
6507 <programlisting xml:id="footnote.properties.frag">\r
6508 &lt;xsl:attribute-set name="footnote.properties"&gt;\r
6509   &lt;xsl:attribute name="font-family"&gt;&lt;xsl:value-of select="$body.fontset"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;\r
6510   &lt;xsl:attribute name="font-size"&gt;&lt;xsl:value-of select="$footnote.font.size"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;\r
6511   &lt;xsl:attribute name="font-weight"&gt;normal&lt;/xsl:attribute&gt;\r
6512   &lt;xsl:attribute name="font-style"&gt;normal&lt;/xsl:attribute&gt;\r
6513   &lt;xsl:attribute name="text-align"&gt;&lt;xsl:value-of select="$alignment"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;\r
6514   &lt;xsl:attribute name="start-indent"&gt;0pt&lt;/xsl:attribute&gt;\r
6515   &lt;xsl:attribute name="text-indent"&gt;0pt&lt;/xsl:attribute&gt;\r
6516   &lt;xsl:attribute name="hyphenate"&gt;&lt;xsl:value-of select="$hyphenate"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;\r
6517   &lt;xsl:attribute name="wrap-option"&gt;wrap&lt;/xsl:attribute&gt;\r
6518   &lt;xsl:attribute name="linefeed-treatment"&gt;treat-as-space&lt;/xsl:attribute&gt;\r
6519 &lt;/xsl:attribute-set&gt;\r
6520 </programlisting>\r
6521 </refsynopsisdiv>\r
6522 \r
6523 <refsection><info><title>Description</title></info>\r
6524 \r
6525 <para>This attribute set is applied to the footnote-block \r
6526 for each footnote.\r
6527 It can be used to set the\r
6528 font-size, font-family, and other inheritable properties that will be\r
6529 applied to all footnotes.</para>\r
6530 \r
6531 </refsection>\r
6532 </refentry>\r
6533 \r
6534 <refentry version="5.0" xml:id="table.footnote.properties">\r
6535 <refmeta>\r
6536 <refentrytitle>table.footnote.properties</refentrytitle>\r
6537 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
6538 </refmeta>\r
6539 <refnamediv>\r
6540 <refname>table.footnote.properties</refname>\r
6541 <refpurpose>Properties applied to each table footnote body\r
6542 </refpurpose>\r
6543 </refnamediv>\r
6544 \r
6545 <refsynopsisdiv>\r
6546 <programlisting xml:id="table.footnote.properties.frag">\r
6547 &lt;xsl:attribute-set name="table.footnote.properties"&gt;\r
6548   &lt;xsl:attribute name="font-family"&gt;&lt;xsl:value-of select="$body.fontset"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;\r
6549   &lt;xsl:attribute name="font-size"&gt;&lt;xsl:value-of select="$footnote.font.size"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;\r
6550   &lt;xsl:attribute name="font-weight"&gt;normal&lt;/xsl:attribute&gt;\r
6551   &lt;xsl:attribute name="font-style"&gt;normal&lt;/xsl:attribute&gt;\r
6552   &lt;xsl:attribute name="space-before"&gt;2pt&lt;/xsl:attribute&gt;\r
6553   &lt;xsl:attribute name="text-align"&gt;&lt;xsl:value-of select="$alignment"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;\r
6554 &lt;/xsl:attribute-set&gt;\r
6555 </programlisting>\r
6556 </refsynopsisdiv>\r
6557 \r
6558 <refsection><info><title>Description</title></info>\r
6559 \r
6560 <para>This attribute set is applied to the footnote-block \r
6561 for each table footnote.\r
6562 It can be used to set the\r
6563 font-size, font-family, and other inheritable properties that will be\r
6564 applied to all table footnotes.</para>\r
6565 \r
6566 </refsection>\r
6567 </refentry>\r
6568 \r
6569 <refentry version="5.0" xml:id="footnote.mark.properties">\r
6570 <refmeta>\r
6571 <refentrytitle>footnote.mark.properties</refentrytitle>\r
6572 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
6573 </refmeta>  \r
6574 <refnamediv>\r
6575 <refname>footnote.mark.properties</refname>\r
6576 <refpurpose>Properties applied to each footnote mark\r
6577 </refpurpose>\r
6578 </refnamediv>\r
6579 \r
6580 <refsynopsisdiv>\r
6581 <programlisting xml:id="footnote.mark.properties.frag">\r
6582 &lt;xsl:attribute-set name="footnote.mark.properties"&gt;\r
6583   &lt;xsl:attribute name="font-family"&gt;&lt;xsl:value-of select="$body.fontset"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;\r
6584   &lt;xsl:attribute name="font-size"&gt;75%&lt;/xsl:attribute&gt;\r
6585   &lt;xsl:attribute name="font-weight"&gt;normal&lt;/xsl:attribute&gt;\r
6586   &lt;xsl:attribute name="font-style"&gt;normal&lt;/xsl:attribute&gt;\r
6587 &lt;/xsl:attribute-set&gt;\r
6588 </programlisting>\r
6589 </refsynopsisdiv>\r
6590 \r
6591 <refsection><info><title>Description</title></info>\r
6592 \r
6593 <para>This attribute set is applied to the footnote mark used\r
6594 for each footnote.\r
6595 It should contain only inline properties.\r
6596 </para>\r
6597 \r
6598 <para>The property to make the mark a superscript is contained in the\r
6599 footnote template itself, because the current version of FOP reports\r
6600 an error if baseline-shift is used.\r
6601 </para>\r
6602 \r
6603 </refsection>\r
6604 </refentry>\r
6605 \r
6606 <refentry version="5.0" xml:id="footnote.sep.leader.properties">\r
6607 <refmeta>\r
6608 <refentrytitle>footnote.sep.leader.properties</refentrytitle>\r
6609 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
6610 </refmeta>\r
6611 <refnamediv>\r
6612 <refname>footnote.sep.leader.properties</refname>\r
6613 <refpurpose>Properties associated with footnote separators</refpurpose>\r
6614 </refnamediv>\r
6615 \r
6616 <refsynopsisdiv>\r
6617 <programlisting xml:id="footnote.sep.leader.properties.frag">\r
6618 &lt;xsl:attribute-set name="footnote.sep.leader.properties"&gt;\r
6619   &lt;xsl:attribute name="color"&gt;black&lt;/xsl:attribute&gt;\r
6620   &lt;xsl:attribute name="leader-pattern"&gt;rule&lt;/xsl:attribute&gt;\r
6621   &lt;xsl:attribute name="leader-length"&gt;1in&lt;/xsl:attribute&gt;\r
6622 &lt;/xsl:attribute-set&gt;\r
6623 </programlisting>\r
6624 </refsynopsisdiv>\r
6625 \r
6626 <refsection><info><title>Description</title></info>\r
6627 \r
6628 <para>The styling for the rule line that separates the\r
6629 footnotes from the body text.\r
6630 These are properties applied to the fo:leader used as\r
6631 the separator.\r
6632 </para>\r
6633 <para>If you want to do more than just set properties on\r
6634 the leader element, then you can customize the template\r
6635 named <literal>footnote.separator</literal> in \r
6636 <filename>fo/pagesetup.xsl</filename>.</para>\r
6637 \r
6638 </refsection>\r
6639 </refentry>\r
6640 \r
6641 <refentry version="5.0" xml:id="xref.with.number.and.title">\r
6642 <refmeta>\r
6643 <refentrytitle>xref.with.number.and.title</refentrytitle>\r
6644 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
6645 </refmeta>\r
6646 <refnamediv>\r
6647 <refname>xref.with.number.and.title</refname>\r
6648 <refpurpose>Use number and title in cross references</refpurpose>\r
6649 </refnamediv>\r
6650 \r
6651 <refsynopsisdiv>\r
6652 <programlisting xml:id="xref.with.number.and.title.frag">\r
6653 &lt;xsl:param name="xref.with.number.and.title" select="1"&gt;&lt;/xsl:param&gt;\r
6654 </programlisting>\r
6655 </refsynopsisdiv>\r
6656 \r
6657 <refsection><info><title>Description</title></info>\r
6658 \r
6659 <para>A cross reference may include the number (for example, the number of\r
6660 an example or figure) and the <tag>title</tag> which is a required child of some\r
6661 targets. This parameter inserts both the relevant number as well as\r
6662 the title into the link. </para>\r
6663 \r
6664 </refsection>\r
6665 </refentry>\r
6666 \r
6667 <refentry version="5.0" xml:id="superscript.properties">\r
6668 <refmeta>\r
6669 <refentrytitle>superscript.properties</refentrytitle>\r
6670 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
6671 </refmeta>\r
6672 <refnamediv>\r
6673 <refname>superscript.properties</refname>\r
6674 <refpurpose>Properties associated with superscripts</refpurpose>\r
6675 </refnamediv>\r
6676 \r
6677 <refsynopsisdiv>\r
6678 <programlisting xml:id="superscript.properties.frag">\r
6679 &lt;xsl:attribute-set name="superscript.properties"&gt;\r
6680   &lt;xsl:attribute name="font-size"&gt;75%&lt;/xsl:attribute&gt;\r
6681 &lt;/xsl:attribute-set&gt;\r
6682 </programlisting>\r
6683 </refsynopsisdiv>\r
6684 \r
6685 <refsection><info><title>Description</title></info>\r
6686 \r
6687 <para>Specifies styling properties for superscripts.</para>\r
6688 \r
6689 </refsection>\r
6690 </refentry>\r
6691 \r
6692 <refentry version="5.0" xml:id="subscript.properties">\r
6693 <refmeta>\r
6694 <refentrytitle>subscript.properties</refentrytitle>\r
6695 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
6696 </refmeta>\r
6697 <refnamediv>\r
6698 <refname>subscript.properties</refname>\r
6699 <refpurpose>Properties associated with subscripts</refpurpose>\r
6700 </refnamediv>\r
6701 \r
6702 <refsynopsisdiv>\r
6703 <programlisting xml:id="subscript.properties.frag">\r
6704 &lt;xsl:attribute-set name="subscript.properties"&gt;\r
6705   &lt;xsl:attribute name="font-size"&gt;75%&lt;/xsl:attribute&gt;\r
6706 &lt;/xsl:attribute-set&gt;\r
6707 </programlisting>\r
6708 </refsynopsisdiv>\r
6709 \r
6710 <refsection><info><title>Description</title></info>\r
6711 \r
6712 <para>Specifies styling properties for subscripts.</para>\r
6713 \r
6714 </refsection>\r
6715 </refentry>\r
6716 \r
6717 <refentry version="5.0" xml:id="pgwide.properties">\r
6718 <refmeta>\r
6719 <refentrytitle>pgwide.properties</refentrytitle>\r
6720 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
6721 </refmeta>\r
6722 <refnamediv>\r
6723 <refname>pgwide.properties</refname>\r
6724 <refpurpose>Properties to make a figure or table page wide.\r
6725 </refpurpose>\r
6726 </refnamediv>\r
6727 \r
6728 <refsynopsisdiv>\r
6729 <programlisting xml:id="pgwide.properties.frag">\r
6730 &lt;xsl:attribute-set name="pgwide.properties"&gt;\r
6731   &lt;xsl:attribute name="start-indent"&gt;0pt&lt;/xsl:attribute&gt;\r
6732 &lt;/xsl:attribute-set&gt;\r
6733 </programlisting>\r
6734 </refsynopsisdiv>\r
6735 \r
6736 <refsection><info><title>Description</title></info>\r
6737 \r
6738 <para>This attribute set is used to set the properties\r
6739 that make a figure or table "page wide" in fo output.\r
6740 It comes into effect when an attribute <literal>pgwide="1"</literal>\r
6741 is used.\r
6742 </para>\r
6743 \r
6744 <para>\r
6745 By default, it sets <parameter>start-indent</parameter>\r
6746 to <literal>0pt</literal>.\r
6747 In a stylesheet that sets the parameter\r
6748 <parameter>body.start.indent</parameter>\r
6749 to a non-zero value in order to indent body text,\r
6750 this attribute set can be used to outdent pgwide\r
6751 figures to the start margin.\r
6752 </para>\r
6753 \r
6754 <para>If a document uses a multi-column page layout,\r
6755 then this attribute set could try setting <parameter>span</parameter>\r
6756 to a value of <literal>all</literal>.  However, this may\r
6757 not work with some processors because a span property must be on an\r
6758 fo:block that is a direct child of fo:flow.  It may work in\r
6759 some processors anyway.\r
6760 </para>\r
6761 \r
6762 </refsection>\r
6763 </refentry>\r
6764 \r
6765 <refentry version="5.0" xml:id="highlight.source">\r
6766 <refmeta>\r
6767 <refentrytitle>highlight.source</refentrytitle>\r
6768 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
6769 </refmeta>\r
6770 <refnamediv>\r
6771 <refname>highlight.source</refname>\r
6772 <refpurpose>Should the content of <tag>programlisting</tag>\r
6773 be syntactically highlighted?</refpurpose>\r
6774 </refnamediv>\r
6775 \r
6776 <refsynopsisdiv>\r
6777 <programlisting xml:id="highlight.source.frag">\r
6778 &lt;xsl:param name="highlight.source" select="0"&gt;&lt;/xsl:param&gt;\r
6779 </programlisting>\r
6780 </refsynopsisdiv>\r
6781 \r
6782 <refsection><info><title>Description</title></info>\r
6783 \r
6784 <para>When this parameter is non-zero, the stylesheets will try to do syntax highlighting of the \r
6785 content of <tag>programlisting</tag> elements. You specify the language for each programlisting \r
6786 by using the <tag class="attribute">language</tag> attribute. The <parameter>highlight.default.language</parameter> \r
6787 parameter can be used to specify the language for programlistings without a <tag class="attribute">language</tag> \r
6788 attribute. Syntax highlighting also works for <tag>screen</tag> and <tag>synopsis</tag> elements.</para>\r
6789 \r
6790 <para>The actual highlighting work is done by the XSLTHL extension module. This is an external Java library that has to be \r
6791 downloaded separately (see below).</para>\r
6792 \r
6793 <itemizedlist>\r
6794 <para>In order to use this extension, you must</para> \r
6795 \r
6796 <listitem><para>add <filename>xslthl-2.x.x.jar</filename> to your Java classpath. The latest version is available\r
6797 from <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://sourceforge.net/projects/xslthl">the XSLT syntax highlighting project</link> \r
6798 at SourceForge.</para>\r
6799 </listitem>\r
6800 <listitem>\r
6801 <para>use a customization layer in which you import one of the following stylesheet modules: \r
6802 <itemizedlist>\r
6803   <listitem>\r
6804     <para><filename>html/highlight.xsl</filename>\r
6805     </para>\r
6806   </listitem>\r
6807 <listitem>\r
6808     <para><filename>xhtml/highlight.xsl</filename>\r
6809     </para>\r
6810   </listitem>\r
6811 <listitem>\r
6812     <para><filename>xhtml-1_1/highlight.xsl</filename>\r
6813     </para>\r
6814   </listitem>\r
6815 <listitem>\r
6816     <para><filename>fo/highlight.xsl</filename>\r
6817     </para>\r
6818 </listitem>\r
6819 </itemizedlist>\r
6820 </para>\r
6821 </listitem>\r
6822 <listitem><para>let either the <literal>xslthl.config</literal> Java system property or the\r
6823 <parameter>highlight.xslthl.config</parameter> parameter point to the configuration file for syntax \r
6824 highlighting (using URL syntax). DocBook XSL comes with a ready-to-use configuration file, \r
6825 <filename>highlighting/xslthl-config.xml</filename>.</para>\r
6826 </listitem>\r
6827 </itemizedlist>\r
6828 \r
6829 <para>The extension works with Saxon 6.5.x and Xalan-J. (Saxon 8.5 or later is also supported, but since it is \r
6830 an XSLT 2.0 processor it is not guaranteed to work with DocBook XSL in all circumstances.)</para>\r
6831 \r
6832 <para>The following is an example of a Saxon 6 command adapted for syntax highlighting, to be used on Windows:</para>\r
6833 \r
6834 <informalexample>\r
6835 <para><command>java -cp c:/Java/saxon.jar;c:/Java/xslthl-2.0.1.jar \r
6836 -Dxslthl.config=file:///c:/docbook-xsl/highlighting/xslthl-config.xml com.icl.saxon.StyleSheet \r
6837 -o test.html test.xml myhtml.xsl</command></para>\r
6838 </informalexample>\r
6839 \r
6840 </refsection>\r
6841 </refentry>\r
6842 \r
6843 <refentry version="5.0" xml:id="highlight.xslthl.config">\r
6844 <refmeta>\r
6845 <refentrytitle>highlight.xslthl.config</refentrytitle>\r
6846 <refmiscinfo class="other" otherclass="datatype">uri</refmiscinfo>\r
6847 </refmeta>\r
6848 <refnamediv>\r
6849 <refname>highlight.xslthl.config</refname>\r
6850 <refpurpose>Location of XSLTHL configuration file</refpurpose>\r
6851 </refnamediv>\r
6852 \r
6853 <refsynopsisdiv>\r
6854 <programlisting xml:id="highlight.xslthl.config.frag">\r
6855 &lt;xsl:param name="highlight.xslthl.config"&gt;&lt;/xsl:param&gt;\r
6856 </programlisting>\r
6857 </refsynopsisdiv>\r
6858 \r
6859 <refsection><info><title>Description</title></info>\r
6860 \r
6861 <para>This location has precedence over the corresponding Java property.</para>\r
6862 \r
6863 </refsection>\r
6864 </refentry>\r
6865 \r
6866 <refentry version="5.0" xml:id="highlight.default.language">\r
6867 <refmeta>\r
6868 <refentrytitle>highlight.default.language</refentrytitle>\r
6869 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
6870 </refmeta>\r
6871 <refnamediv>\r
6872 <refname>highlight.default.language</refname>\r
6873 <refpurpose>Default language of programlisting</refpurpose>\r
6874 </refnamediv>\r
6875 \r
6876 <refsynopsisdiv>\r
6877 <programlisting xml:id="highlight.default.language.frag">\r
6878 &lt;xsl:param name="highlight.default.language"&gt;&lt;/xsl:param&gt;\r
6879 </programlisting>\r
6880 </refsynopsisdiv>\r
6881 \r
6882 <refsection><info><title>Description</title></info>\r
6883 \r
6884 <para>This language is used when there is no language attribute on programlisting.</para>\r
6885 \r
6886 </refsection>\r
6887 </refentry>\r
6888 \r
6889 <refentry version="5.0" xml:id="email.delimiters.enabled">\r
6890 <refmeta>\r
6891 <refentrytitle>email.delimiters.enabled</refentrytitle>\r
6892 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
6893 </refmeta>\r
6894 <refnamediv>\r
6895 <refname>email.delimiters.enabled</refname>\r
6896 <refpurpose>Generate delimiters around email addresses?</refpurpose>\r
6897 </refnamediv>\r
6898 \r
6899 <refsynopsisdiv>\r
6900 <programlisting xml:id="email.delimiters.enabled.frag">\r
6901 &lt;xsl:param name="email.delimiters.enabled" select="1"&gt;&lt;/xsl:param&gt;\r
6902 </programlisting>\r
6903 </refsynopsisdiv>\r
6904 \r
6905 <refsection><info><title>Description</title></info>\r
6906 \r
6907 <para>If non-zero, delimiters\r
6908 \r
6909 <footnote><para>For delimiters, the\r
6910 stylesheets are currently hard-coded to output angle\r
6911 brackets.</para></footnote> \r
6912 \r
6913 are generated around e-mail addresses\r
6914 (the output of the <tag>email</tag> element).</para>\r
6915 \r
6916 </refsection>\r
6917 </refentry>\r
6918 \r
6919 <refentry version="5.0" xml:id="email.mailto.enabled">\r
6920 <refmeta>\r
6921 <refentrytitle>email.mailto.enabled</refentrytitle>\r
6922 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
6923 </refmeta>\r
6924 <refnamediv>\r
6925 <refname>email.mailto.enabled</refname>\r
6926 <refpurpose>Generate mailto: links for email addresses?</refpurpose>\r
6927 </refnamediv>\r
6928 \r
6929 <refsynopsisdiv>\r
6930 <programlisting xml:id="email.mailto.enabled.frag">\r
6931 &lt;xsl:param name="email.mailto.enabled" select="0"&gt;&lt;/xsl:param&gt;\r
6932 </programlisting>\r
6933 </refsynopsisdiv>\r
6934 \r
6935 <refsection><info><title>Description</title></info>\r
6936 \r
6937 <para>If non-zero the generated output for the <tag>email</tag> element\r
6938 will be a clickable mailto: link that brings up the default mail client\r
6939 on the system.</para>\r
6940 \r
6941 </refsection>\r
6942 </refentry>\r
6943 \r
6944 <refentry version="5.0" xml:id="section.container.element">\r
6945 <refmeta>\r
6946 <refentrytitle>section.container.element</refentrytitle>\r
6947 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>\r
6948 <refmiscinfo class="other" otherclass="value">block</refmiscinfo>\r
6949 <refmiscinfo class="other" otherclass="value">wrapper</refmiscinfo>\r
6950 </refmeta>\r
6951 <refnamediv>\r
6952 <refname>section.container.element</refname>\r
6953 <refpurpose>Select XSL-FO element name to contain sections</refpurpose>\r
6954 </refnamediv>\r
6955 \r
6956 <refsynopsisdiv>\r
6957 <programlisting xml:id="section.container.element.frag">\r
6958 &lt;xsl:param name="section.container.element"&gt;block&lt;/xsl:param&gt;\r
6959 </programlisting>\r
6960 </refsynopsisdiv>\r
6961 \r
6962 <refsection><info><title>Description</title></info>\r
6963 \r
6964 <para>Selects the element name for outer container of\r
6965 each section. The choices are <literal>block</literal> (default)\r
6966 or <literal>wrapper</literal>.\r
6967 The <literal>fo:</literal> namespace prefix is added\r
6968 by the stylesheet to form the full element name.\r
6969 </para>\r
6970 \r
6971 <para>This element receives the section <literal>id</literal>\r
6972 attribute and the appropriate section level attribute-set.\r
6973 </para>\r
6974 \r
6975 <para>Changing this parameter to <literal>wrapper</literal>\r
6976 is only necessary when producing multi-column output\r
6977 that contains page-wide spans.  Using <literal>fo:wrapper</literal>\r
6978 avoids the nesting of <literal>fo:block</literal>\r
6979 elements that prevents spans from working (the standard says\r
6980 a span must be on a block that is a direct child of \r
6981 <literal>fo:flow</literal>).\r
6982 </para>\r
6983 \r
6984 <para>If set to <literal>wrapper</literal>, the\r
6985 section attribute-sets only support properties\r
6986 that are inheritable.  That's because there is no\r
6987 block to apply them to.  Properties such as\r
6988 font-family are inheritable, but properties such as\r
6989 border are not.\r
6990 </para>\r
6991 \r
6992 <para>Only some XSL-FO processors need to use this parameter.\r
6993 The Antenna House processor, for example, will handle \r
6994 spans in nested blocks without changing the element name.\r
6995 The RenderX XEP product and FOP follow the XSL-FO standard \r
6996 and need to use <literal>wrapper</literal>.\r
6997 </para>\r
6998 \r
6999 </refsection>\r
7000 </refentry>\r
7001 \r
7002 <refentry version="5.0" xml:id="monospace.verbatim.font.width">\r
7003 <refmeta>\r
7004 <refentrytitle>monospace.verbatim.font.width</refentrytitle>\r
7005 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
7006 </refmeta>\r
7007 <refnamediv>\r
7008 <refname>monospace.verbatim.font.width</refname>\r
7009 <refpurpose>Width of a single monospace font character</refpurpose>\r
7010 </refnamediv>\r
7011 \r
7012 <refsynopsisdiv>\r
7013 <programlisting xml:id="monospace.verbatim.font.width.frag">\r
7014 &lt;xsl:param name="monospace.verbatim.font.width"&gt;0.60em&lt;/xsl:param&gt;\r
7015 </programlisting>\r
7016 </refsynopsisdiv>\r
7017 \r
7018 <refsection><info><title>Description</title></info>\r
7019 \r
7020 <para>Specifies with em units the width of a single character\r
7021 of the monospace font. The default value is <literal>0.6em</literal>.</para>\r
7022 \r
7023 <para>This parameter is only used when a <tag>screen</tag>\r
7024 or <tag>programlisting</tag> element has a \r
7025 <tag class="attribute">width</tag> attribute, which is\r
7026 expressed as a plain integer to indicate the maximum character count\r
7027 of each line.\r
7028 To convert this character count to an actual maximum width\r
7029 measurement, the width of the font characters must be provided.\r
7030 Different monospace fonts have different character width,\r
7031 so this parameter should be adjusted to fit the \r
7032 monospace font being used.\r
7033 </para>\r
7034 \r
7035 </refsection>\r
7036 </refentry>\r
7037 \r
7038 <refentry version="5.0" xml:id="exsl.node.set.available">\r
7039 <refmeta>\r
7040 <refentrytitle>exsl.node.set.available</refentrytitle>\r
7041 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
7042 </refmeta>\r
7043 <refnamediv>\r
7044 <refname>exsl.node.set.available</refname>\r
7045 <refpurpose>Is the test function-available('exsl:node-set') true?</refpurpose>\r
7046 </refnamediv>\r
7047 \r
7048 <refsynopsisdiv>\r
7049 <programlisting xml:id="exsl.node.set.available.frag">&lt;xsl:param name="exsl.node.set.available"&gt; \r
7050   &lt;xsl:choose&gt;\r
7051     &lt;xsl:when exsl:foo="" test="function-available('exsl:node-set') or                        contains(system-property('xsl:vendor'),                          'Apache Software Foundation')"&gt;1&lt;/xsl:when&gt;\r
7052     &lt;xsl:otherwise&gt;0&lt;/xsl:otherwise&gt;\r
7053   &lt;/xsl:choose&gt;\r
7054 &lt;/xsl:param&gt;\r
7055 </programlisting>\r
7056 </refsynopsisdiv>\r
7057 \r
7058 <refsection><info><title>Description</title></info>\r
7059 \r
7060 <para>If non-zero,\r
7061 then the exsl:node-set() function is available to be used in\r
7062 the stylesheet.\r
7063 If zero, then the function is not available.\r
7064 This param automatically detects the presence of\r
7065 the function and does not normally need to be set manually.</para>\r
7066 \r
7067 <para>This param was created to handle a long-standing\r
7068 bug in the Xalan processor that fails to detect the\r
7069 function even though it is available.</para>\r
7070 \r
7071 </refsection>\r
7072 </refentry>\r
7073 \r
7074 <refentry version="5.0" xml:id="bookmarks.collapse">\r
7075 <refmeta>\r
7076 <refentrytitle>bookmarks.collapse</refentrytitle>\r
7077 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo> \r
7078 </refmeta>\r
7079 <refnamediv>\r
7080 <refname>bookmarks.collapse</refname>\r
7081 <refpurpose>Specifies the initial state of bookmarks</refpurpose>\r
7082 </refnamediv>\r
7083 \r
7084 <refsynopsisdiv>\r
7085 <programlisting xml:id="bookmarks.collapse.frag">\r
7086 &lt;xsl:param name="bookmarks.collapse" select="1"&gt;&lt;/xsl:param&gt;\r
7087 </programlisting>\r
7088 </refsynopsisdiv>\r
7089 \r
7090 <refsection><info><title>Description</title></info>\r
7091 \r
7092 <para>If non-zero, the bookmark tree is collapsed so that only the \r
7093 top-level bookmarks are displayed initially. Otherwise, the whole tree \r
7094 of bookmarks is displayed.</para>\r
7095 \r
7096 <para>This parameter currently works with FOP 0.93 or later.</para>\r
7097 \r
7098 </refsection>\r
7099 </refentry>\r
7100 \r
7101 </reference>\r
7102 <reference xml:id="graphics"><title>Graphics</title>\r
7103 <refentry version="5.0" xml:id="graphic.default.extension">\r
7104 <refmeta>\r
7105 <refentrytitle>graphic.default.extension</refentrytitle>\r
7106 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
7107 </refmeta>\r
7108 <refnamediv>\r
7109 <refname>graphic.default.extension</refname>\r
7110 <refpurpose>Default extension for graphic filenames</refpurpose>\r
7111 </refnamediv>\r
7112 \r
7113 <refsynopsisdiv>\r
7114 <programlisting xml:id="graphic.default.extension.frag">&lt;xsl:param name="graphic.default.extension"&gt;&lt;/xsl:param&gt;</programlisting>\r
7115 </refsynopsisdiv>\r
7116 \r
7117 <refsection><info><title>Description</title></info>\r
7118 \r
7119 <para>If a <tag>graphic</tag> or <tag>mediaobject</tag>\r
7120 includes a reference to a filename that does not include an extension,\r
7121 and the <tag class="attribute">format</tag> attribute is\r
7122 <emphasis>unspecified</emphasis>, the default extension will be used.\r
7123 </para>\r
7124 \r
7125 </refsection>\r
7126 </refentry>\r
7127 \r
7128 <refentry version="5.0" xml:id="default.image.width">\r
7129 <refmeta>\r
7130 <refentrytitle>default.image.width</refentrytitle>\r
7131 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
7132 </refmeta>\r
7133 <refnamediv>\r
7134 <refname>default.image.width</refname>\r
7135 <refpurpose>The default width of images</refpurpose>\r
7136 </refnamediv>\r
7137 \r
7138 <refsynopsisdiv>\r
7139 <programlisting xml:id="default.image.width.frag">\r
7140 &lt;xsl:param name="default.image.width"&gt;&lt;/xsl:param&gt;\r
7141 </programlisting>\r
7142 </refsynopsisdiv>\r
7143 \r
7144 <refsection><info><title>Description</title></info>\r
7145 \r
7146 <para>If specified, this value will be used for the\r
7147 <tag class="attribute">width</tag> attribute on\r
7148 images that do not specify any\r
7149 <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://docbook.org/tdg/en/html/imagedata.html#viewport.area">viewport\r
7150 dimensions</link>.</para>\r
7151 \r
7152 </refsection>\r
7153 </refentry>\r
7154 \r
7155 <refentry version="5.0" xml:id="preferred.mediaobject.role">\r
7156 <refmeta>\r
7157 <refentrytitle>preferred.mediaobject.role</refentrytitle>\r
7158 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
7159 </refmeta>\r
7160 <refnamediv>\r
7161 <refname>preferred.mediaobject.role</refname>\r
7162 <refpurpose>Select which mediaobject to use based on\r
7163 this value of an object's <tag class="attribute">role</tag> attribute.\r
7164 </refpurpose>\r
7165 </refnamediv>\r
7166 \r
7167 <refsynopsisdiv>\r
7168 <programlisting xml:id="preferred.mediaobject.role.frag">\r
7169 &lt;xsl:param name="preferred.mediaobject.role"&gt;&lt;/xsl:param&gt;\r
7170 </programlisting>\r
7171 </refsynopsisdiv>\r
7172 \r
7173 <refsection><info><title>Description</title></info>\r
7174 \r
7175 <para>A mediaobject may contain several objects such as imageobjects.\r
7176 If the parameter <parameter>use.role.for.mediaobject</parameter> is\r
7177 non-zero, then the <literal>role</literal> attribute on\r
7178 <tag>imageobject</tag>s and other objects within a\r
7179 <tag>mediaobject</tag> container will be used to select which object\r
7180 will be used.  If one of the objects has a role value that matches the\r
7181 <parameter>preferred.mediaobject.role</parameter> parameter, then it\r
7182 has first priority for selection.  If more than one has such a role\r
7183 value, the first one is used.\r
7184 </para>\r
7185 <para>\r
7186 See the <parameter>use.role.for.mediaobject</parameter> parameter\r
7187 for the sequence of selection.</para>\r
7188 </refsection>\r
7189 </refentry>\r
7190 \r
7191 <refentry version="5.0" xml:id="use.role.for.mediaobject">\r
7192 <refmeta>\r
7193 <refentrytitle>use.role.for.mediaobject</refentrytitle>\r
7194 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
7195 </refmeta>\r
7196 <refnamediv>\r
7197 <refname>use.role.for.mediaobject</refname>\r
7198 <refpurpose>Use <tag class="attribute">role</tag> attribute \r
7199 value for selecting which of several objects within a mediaobject to use.\r
7200 </refpurpose>\r
7201 </refnamediv>\r
7202 \r
7203 <refsynopsisdiv>\r
7204 <programlisting xml:id="use.role.for.mediaobject.frag">\r
7205 &lt;xsl:param name="use.role.for.mediaobject" select="1"&gt;&lt;/xsl:param&gt;\r
7206 </programlisting>\r
7207 </refsynopsisdiv>\r
7208 \r
7209 <refsection><info><title>Description</title></info>\r
7210 \r
7211 <para>If non-zero, the <tag class="attribute">role</tag> attribute on\r
7212 <tag>imageobject</tag>s or other objects within a <tag>mediaobject</tag> container will be used to select which object will be\r
7213 used.\r
7214 </para>\r
7215 <para>\r
7216 The order of selection when then parameter is non-zero is:\r
7217 </para>\r
7218 <orderedlist>\r
7219 <listitem>\r
7220     <para>If the stylesheet parameter <parameter>preferred.mediaobject.role</parameter> has a value, then the object whose role equals that value is selected.</para>\r
7221 </listitem>\r
7222 <listitem>\r
7223 <para>Else if an object's role attribute has a value of\r
7224 <literal>html</literal> for HTML processing or\r
7225 <literal>fo</literal> for FO output, then the first\r
7226 of such objects is selected.\r
7227 </para>\r
7228 </listitem>\r
7229 <listitem>\r
7230 <para>Else the first suitable object is selected.</para>\r
7231 </listitem>\r
7232 </orderedlist>\r
7233 <para>\r
7234 If the value of \r
7235 <parameter>use.role.for.mediaobject</parameter>\r
7236 is zero, then role attributes are not considered\r
7237 and the first suitable object\r
7238 with or without a role value is used.\r
7239 </para>\r
7240 </refsection>\r
7241 </refentry>\r
7242 \r
7243 <refentry version="5.0" xml:id="ignore.image.scaling">\r
7244 <refmeta>\r
7245 <refentrytitle>ignore.image.scaling</refentrytitle>\r
7246 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
7247 </refmeta>\r
7248 <refnamediv>\r
7249 <refname>ignore.image.scaling</refname>\r
7250 <refpurpose>Tell the stylesheets to ignore the author's image scaling attributes</refpurpose>\r
7251 </refnamediv>\r
7252 \r
7253 <refsynopsisdiv>\r
7254 <programlisting xml:id="ignore.image.scaling.frag">\r
7255 &lt;xsl:param name="ignore.image.scaling" select="0"&gt;&lt;/xsl:param&gt;\r
7256 </programlisting>\r
7257 </refsynopsisdiv>\r
7258 \r
7259 <refsection><info><title>Description</title></info>\r
7260 \r
7261 <para>If non-zero, the scaling attributes on graphics and media objects are\r
7262 ignored.</para>\r
7263 \r
7264 </refsection>\r
7265 </refentry>\r
7266 \r
7267 <refentry version="5.0" xml:id="img.src.path">\r
7268 <refmeta>\r
7269 <refentrytitle>img.src.path</refentrytitle>\r
7270 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
7271 </refmeta>\r
7272 <refnamediv>\r
7273 <refname>img.src.path</refname>\r
7274 <refpurpose>Path to HTML/FO image files</refpurpose>\r
7275 </refnamediv>\r
7276 \r
7277 <refsynopsisdiv>\r
7278 <programlisting xml:id="img.src.path.frag">&lt;xsl:param name="img.src.path"&gt;&lt;/xsl:param&gt;</programlisting>\r
7279 </refsynopsisdiv>\r
7280 \r
7281 <refsection><info><title>Description</title></info>\r
7282 \r
7283 <para>Add a path prefix to the value of the <tag class="attribute">fileref</tag> \r
7284 attribute of <tag>graphic</tag>, <tag>inlinegraphic</tag>, and <tag>imagedata</tag> elements. The resulting \r
7285 compound path is used in the output as the value of the <tag class="attribute">src</tag> \r
7286 attribute of <tag class="element">img</tag> (HTML) or <tag class="element">external-graphic</tag> (FO).\r
7287 </para>\r
7288 \r
7289 <para>\r
7290 The path given by <literal>img.src.path</literal> could be relative to the directory where the HTML/FO\r
7291 files are created, or it could be an absolute URI.\r
7292 The default value is empty.\r
7293 Be sure to include a trailing slash if needed.\r
7294 </para>\r
7295 \r
7296 <para>This prefix is not applied to any filerefs that start\r
7297 with "/" or contain "//:".\r
7298 </para>\r
7299 \r
7300 </refsection>\r
7301 </refentry>\r
7302 \r
7303 <refentry version="5.0" xml:id="keep.relative.image.uris">\r
7304 <refmeta>\r
7305 <refentrytitle>keep.relative.image.uris</refentrytitle>\r
7306 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
7307 </refmeta>\r
7308 <refnamediv>\r
7309 <refname>keep.relative.image.uris</refname>\r
7310 <refpurpose>Should image URIs be resolved against xml:base?</refpurpose>\r
7311 </refnamediv>\r
7312 \r
7313 <refsynopsisdiv>\r
7314 <programlisting xml:id="keep.relative.image.uris.frag">\r
7315 \r
7316 &lt;xsl:param name="keep.relative.image.uris" select="0"&gt;&lt;/xsl:param&gt;\r
7317 </programlisting>\r
7318 </refsynopsisdiv>\r
7319 \r
7320 <refsection><info><title>Description</title></info>\r
7321 \r
7322 <para>If non-zero, relative URIs (in, for example\r
7323 <literal>fileref</literal> attributes) will be used in the generated\r
7324 output. Otherwise, the URIs will be made absolute with respect to the\r
7325 base URI.</para>\r
7326 \r
7327 <para>Note that the stylesheets calculate (and use) the absolute form\r
7328 for some purposes, this only applies to the resulting output.</para>\r
7329 \r
7330 </refsection>\r
7331 </refentry>\r
7332 \r
7333 </reference>\r
7334 <reference xml:id="general"><title>Pagination and General Styles</title>\r
7335 <partintro xml:id="margins_partintro">\r
7336 <section xml:id="margins_intro"><title>Understanding XSL FO Margins</title>\r
7337 \r
7338 <para>To make sense of the parameters in this section, it's useful to\r
7339 consider <xref linkend="fig.pagemodel"/>.</para>\r
7340 \r
7341 <figure xml:id="fig.pagemodel">\r
7342   <title>Page Model</title>\r
7343   <mediaobject xml:id="fo-pageregions-image">\r
7344     <imageobject role="html">\r
7345       <imagedata fileref="page.png"/>\r
7346     </imageobject>\r
7347     <imageobject role="fo">\r
7348       <imagedata fileref="fo/page.png"/>\r
7349     </imageobject>\r
7350     <textobject><phrase>Figure showing page margins</phrase></textobject>\r
7351     <textobject>\r
7352       <para>This figure shows the physical page with the various FO page regions\r
7353       identified.</para>\r
7354     </textobject>\r
7355   </mediaobject>\r
7356 </figure>\r
7357 \r
7358 <para>First, let's consider the regions on the page.</para>\r
7359 \r
7360 <para>The white region is the physical page. Its dimensions are determined by\r
7361 the <parameter>page.height</parameter> and <parameter>page.width</parameter>\r
7362 parameters.</para>\r
7363 \r
7364 <para>The yellow region is the region-body. The size and placement of\r
7365 the region body is constrained by the dimensions labelled in the\r
7366 figure.</para>\r
7367 \r
7368 <para>The pink region at the top of the page is the region-before. The\r
7369 darker area inside the region-before is the header text. In XSL, the default\r
7370 display alignment for a region is <literal>before</literal>, but the\r
7371 DocBook stylesheets still explicitly make it <literal>before</literal>. That's\r
7372 why the darker area is at the top.</para>\r
7373 \r
7374 <para>The pink region at the bottom of the page is the region-after.\r
7375 The darker area is the footer text. In XSL, the default display\r
7376 alignment for a region is <literal>before</literal>,\r
7377 but the DocBook stylesheets explicitly make it\r
7378 <literal>after</literal>. That's why the darker area is at the bottom.</para>\r
7379 \r
7380 <para>The dimensions in the figure are:</para>\r
7381 \r
7382 <orderedlist numeration="upperalpha">\r
7383 <listitem><para>The page-master margin-top.\r
7384 </para></listitem>\r
7385 <listitem><para>The region-before extent.\r
7386 </para></listitem>\r
7387 <listitem><para>The region-body margin-top.\r
7388 </para></listitem>\r
7389 <listitem><para>The region-after extent.\r
7390 </para></listitem>\r
7391 <listitem><para>The page-master margin-bottom.\r
7392 </para></listitem>\r
7393 <listitem><para>The region-body margin-bottom.\r
7394 </para></listitem>\r
7395 <listitem><para>The sum of the page-master margin-left and the\r
7396 region-body margin-left. In DocBook, the region-body margin-left is\r
7397 zero by default, so this is simply the page-master margin-left.\r
7398 </para></listitem>\r
7399 <listitem><para>The sum of the page-master margin-right and the\r
7400 region-body margin-right. In DocBook, the region-body margin-right is\r
7401 zero by default, so this is simply the page-master margin-right.\r
7402 </para></listitem>\r
7403 </orderedlist>\r
7404 \r
7405 </section>\r
7406 </partintro>\r
7407 \r
7408 <refentry version="5.0" xml:id="page.height">\r
7409 <refmeta>\r
7410 <refentrytitle>page.height</refentrytitle>\r
7411 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
7412 </refmeta>\r
7413 <refnamediv>\r
7414 <refname>page.height</refname>\r
7415 <refpurpose>The height of the physical page</refpurpose>\r
7416 </refnamediv>\r
7417 \r
7418 <refsynopsisdiv>\r
7419 <programlisting xml:id="page.height.frag">&lt;xsl:param name="page.height"&gt;\r
7420   &lt;xsl:choose&gt;\r
7421     &lt;xsl:when test="$page.orientation = 'portrait'"&gt;\r
7422       &lt;xsl:value-of select="$page.height.portrait"&gt;&lt;/xsl:value-of&gt;\r
7423     &lt;/xsl:when&gt;\r
7424     &lt;xsl:otherwise&gt;\r
7425       &lt;xsl:value-of select="$page.width.portrait"&gt;&lt;/xsl:value-of&gt;\r
7426     &lt;/xsl:otherwise&gt;\r
7427   &lt;/xsl:choose&gt;\r
7428 &lt;/xsl:param&gt;</programlisting>\r
7429 </refsynopsisdiv>\r
7430 \r
7431 <refsection><info><title>Description</title></info>\r
7432 \r
7433 <para>The page height is generally calculated from the\r
7434 <parameter>paper.type</parameter> and\r
7435 <parameter>page.orientation</parameter> parameters.\r
7436 </para>\r
7437 \r
7438 </refsection>\r
7439 </refentry>\r
7440 \r
7441 <refentry version="5.0" xml:id="page.height.portrait">\r
7442 <refmeta>\r
7443 <refentrytitle>page.height.portrait</refentrytitle>\r
7444 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
7445 </refmeta>\r
7446 <refnamediv>\r
7447 <refname>page.height.portrait</refname>\r
7448 <refpurpose>Specify the physical size of the long edge of the page</refpurpose>\r
7449 </refnamediv>\r
7450 \r
7451 <refsynopsisdiv>\r
7452 <programlisting xml:id="page.height.portrait.frag">&lt;xsl:param name="page.height.portrait"&gt;\r
7453   &lt;xsl:choose&gt;\r
7454     &lt;xsl:when test="$paper.type = 'A4landscape'"&gt;210mm&lt;/xsl:when&gt;\r
7455     &lt;xsl:when test="$paper.type = 'USletter'"&gt;11in&lt;/xsl:when&gt;\r
7456     &lt;xsl:when test="$paper.type = 'USlandscape'"&gt;8.5in&lt;/xsl:when&gt;\r
7457     &lt;xsl:when test="$paper.type = '4A0'"&gt;2378mm&lt;/xsl:when&gt;\r
7458     &lt;xsl:when test="$paper.type = '2A0'"&gt;1682mm&lt;/xsl:when&gt;\r
7459     &lt;xsl:when test="$paper.type = 'A0'"&gt;1189mm&lt;/xsl:when&gt;\r
7460     &lt;xsl:when test="$paper.type = 'A1'"&gt;841mm&lt;/xsl:when&gt;\r
7461     &lt;xsl:when test="$paper.type = 'A2'"&gt;594mm&lt;/xsl:when&gt;\r
7462     &lt;xsl:when test="$paper.type = 'A3'"&gt;420mm&lt;/xsl:when&gt;\r
7463     &lt;xsl:when test="$paper.type = 'A4'"&gt;297mm&lt;/xsl:when&gt;\r
7464     &lt;xsl:when test="$paper.type = 'A5'"&gt;210mm&lt;/xsl:when&gt;\r
7465     &lt;xsl:when test="$paper.type = 'A6'"&gt;148mm&lt;/xsl:when&gt;\r
7466     &lt;xsl:when test="$paper.type = 'A7'"&gt;105mm&lt;/xsl:when&gt;\r
7467     &lt;xsl:when test="$paper.type = 'A8'"&gt;74mm&lt;/xsl:when&gt;\r
7468     &lt;xsl:when test="$paper.type = 'A9'"&gt;52mm&lt;/xsl:when&gt;\r
7469     &lt;xsl:when test="$paper.type = 'A10'"&gt;37mm&lt;/xsl:when&gt;\r
7470     &lt;xsl:when test="$paper.type = 'B0'"&gt;1414mm&lt;/xsl:when&gt;\r
7471     &lt;xsl:when test="$paper.type = 'B1'"&gt;1000mm&lt;/xsl:when&gt;\r
7472     &lt;xsl:when test="$paper.type = 'B2'"&gt;707mm&lt;/xsl:when&gt;\r
7473     &lt;xsl:when test="$paper.type = 'B3'"&gt;500mm&lt;/xsl:when&gt;\r
7474     &lt;xsl:when test="$paper.type = 'B4'"&gt;353mm&lt;/xsl:when&gt;\r
7475     &lt;xsl:when test="$paper.type = 'B5'"&gt;250mm&lt;/xsl:when&gt;\r
7476     &lt;xsl:when test="$paper.type = 'B6'"&gt;176mm&lt;/xsl:when&gt;\r
7477     &lt;xsl:when test="$paper.type = 'B7'"&gt;125mm&lt;/xsl:when&gt;\r
7478     &lt;xsl:when test="$paper.type = 'B8'"&gt;88mm&lt;/xsl:when&gt;\r
7479     &lt;xsl:when test="$paper.type = 'B9'"&gt;62mm&lt;/xsl:when&gt;\r
7480     &lt;xsl:when test="$paper.type = 'B10'"&gt;44mm&lt;/xsl:when&gt;\r
7481     &lt;xsl:when test="$paper.type = 'C0'"&gt;1297mm&lt;/xsl:when&gt;\r
7482     &lt;xsl:when test="$paper.type = 'C1'"&gt;917mm&lt;/xsl:when&gt;\r
7483     &lt;xsl:when test="$paper.type = 'C2'"&gt;648mm&lt;/xsl:when&gt;\r
7484     &lt;xsl:when test="$paper.type = 'C3'"&gt;458mm&lt;/xsl:when&gt;\r
7485     &lt;xsl:when test="$paper.type = 'C4'"&gt;324mm&lt;/xsl:when&gt;\r
7486     &lt;xsl:when test="$paper.type = 'C5'"&gt;229mm&lt;/xsl:when&gt;\r
7487     &lt;xsl:when test="$paper.type = 'C6'"&gt;162mm&lt;/xsl:when&gt;\r
7488     &lt;xsl:when test="$paper.type = 'C7'"&gt;114mm&lt;/xsl:when&gt;\r
7489     &lt;xsl:when test="$paper.type = 'C8'"&gt;81mm&lt;/xsl:when&gt;\r
7490     &lt;xsl:when test="$paper.type = 'C9'"&gt;57mm&lt;/xsl:when&gt;\r
7491     &lt;xsl:when test="$paper.type = 'C10'"&gt;40mm&lt;/xsl:when&gt;\r
7492     &lt;xsl:otherwise&gt;11in&lt;/xsl:otherwise&gt;\r
7493   &lt;/xsl:choose&gt;\r
7494 &lt;/xsl:param&gt;</programlisting>\r
7495 </refsynopsisdiv>\r
7496 \r
7497 <refsection><info><title>Description</title></info>\r
7498 \r
7499 <para>The portrait page height is the length of the long\r
7500 edge of the physical page.\r
7501 </para>\r
7502 \r
7503 </refsection>\r
7504 </refentry>\r
7505 \r
7506 <refentry version="5.0" xml:id="page.margin.bottom">\r
7507 <refmeta>\r
7508 <refentrytitle>page.margin.bottom</refentrytitle>\r
7509 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
7510 </refmeta>\r
7511 <refnamediv>\r
7512 <refname>page.margin.bottom</refname>\r
7513 <refpurpose>The bottom margin of the page</refpurpose>\r
7514 </refnamediv>\r
7515 \r
7516 <refsynopsisdiv>\r
7517 <programlisting xml:id="page.margin.bottom.frag">\r
7518 &lt;xsl:param name="page.margin.bottom"&gt;0.5in&lt;/xsl:param&gt;\r
7519 </programlisting>\r
7520 </refsynopsisdiv>\r
7521 \r
7522 <refsection><info><title>Description</title></info>\r
7523 \r
7524 <para>The bottom page margin is the distance from the bottom of the region-after\r
7525 to the physical bottom of the page.\r
7526 </para>\r
7527 \r
7528 </refsection>\r
7529 </refentry>\r
7530 \r
7531 <refentry version="5.0" xml:id="page.margin.inner">\r
7532 <refmeta>\r
7533 <refentrytitle>page.margin.inner</refentrytitle>\r
7534 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
7535 </refmeta>\r
7536 <refnamediv>\r
7537 <refname>page.margin.inner</refname>\r
7538 <refpurpose>The inner page margin</refpurpose>\r
7539 </refnamediv>\r
7540 \r
7541 <refsynopsisdiv>\r
7542 <programlisting xml:id="page.margin.inner.frag">&lt;xsl:param name="page.margin.inner"&gt;\r
7543   &lt;xsl:choose&gt;\r
7544     &lt;xsl:when test="$double.sided != 0"&gt;1.25in&lt;/xsl:when&gt;\r
7545     &lt;xsl:otherwise&gt;1in&lt;/xsl:otherwise&gt;\r
7546   &lt;/xsl:choose&gt;\r
7547 &lt;/xsl:param&gt;</programlisting>\r
7548 </refsynopsisdiv>\r
7549 \r
7550 <refsection><info><title>Description</title></info>\r
7551 \r
7552 <para>The inner page margin is the distance from bound edge of the\r
7553 page to the first column of text. </para>\r
7554 \r
7555 <para>The inner page margin is the distance from bound edge of the\r
7556 page to the outer edge of the first column of text.</para>\r
7557 \r
7558 <para>In left-to-right text direction,\r
7559 this is the left margin of recto (front side) pages.\r
7560 For single-sided output, it is the left margin\r
7561 of all pages.</para>\r
7562 \r
7563 <para>In right-to-left text direction,\r
7564 this is the right margin of recto pages.\r
7565 For single-sided output, this is the\r
7566 right margin of all pages.</para>\r
7567 \r
7568 <note>\r
7569 <para>Current versions (at least as of version 4.13)\r
7570 of the XEP XSL-FO processor do not\r
7571 correctly handle these margin settings for documents\r
7572 with right-to-left text direction.\r
7573 The workaround in that situation is to reverse\r
7574 the values for <parameter>page.margin.inner</parameter>\r
7575 and <parameter>page.margin.outer</parameter>, until\r
7576 this bug is fixed by RenderX.  It does not affect documents\r
7577 with left-to-right text direction.</para>\r
7578 </note>\r
7579 \r
7580 </refsection>\r
7581 </refentry>\r
7582 \r
7583 <refentry version="5.0" xml:id="page.margin.outer">\r
7584 <refmeta>\r
7585 <refentrytitle>page.margin.outer</refentrytitle>\r
7586 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
7587 </refmeta>\r
7588 <refnamediv>\r
7589 <refname>page.margin.outer</refname>\r
7590 <refpurpose>The outer page margin</refpurpose>\r
7591 </refnamediv>\r
7592 \r
7593 <refsynopsisdiv>\r
7594 <programlisting xml:id="page.margin.outer.frag">&lt;xsl:param name="page.margin.outer"&gt;\r
7595   &lt;xsl:choose&gt;\r
7596     &lt;xsl:when test="$double.sided != 0"&gt;0.75in&lt;/xsl:when&gt;\r
7597     &lt;xsl:otherwise&gt;1in&lt;/xsl:otherwise&gt;\r
7598   &lt;/xsl:choose&gt;\r
7599 &lt;/xsl:param&gt;</programlisting>\r
7600 </refsynopsisdiv>\r
7601 \r
7602 <refsection><info><title>Description</title></info>\r
7603 \r
7604 <para>The outer page margin is the distance from non-bound edge of the\r
7605 page to the outer edge of the last column of text.</para>\r
7606 \r
7607 <para>In left-to-right text direction,\r
7608 this is the right margin of recto (front side) pages.\r
7609 For single-sided output, it is the right margin\r
7610 of all pages.</para>\r
7611 \r
7612 <para>In right-to-left text direction,\r
7613 this is the left margin of recto pages.\r
7614 For single-sided output, this is the\r
7615 left margin of all pages.</para>\r
7616 \r
7617 <note>\r
7618 <para>Current versions (at least as of version 4.13)\r
7619 of the XEP XSL-FO processor do not\r
7620 correctly handle these margin settings for documents\r
7621 with right-to-left text direction.\r
7622 The workaround in that situation is to reverse\r
7623 the values for <parameter>page.margin.inner</parameter>\r
7624 and <parameter>page.margin.outer</parameter>, until\r
7625 this bug is fixed by RenderX.  It does not affect documents\r
7626 with left-to-right text direction.</para>\r
7627 </note>\r
7628 \r
7629 </refsection>\r
7630 </refentry>\r
7631 \r
7632 <refentry version="5.0" xml:id="page.margin.top">\r
7633 <refmeta>\r
7634 <refentrytitle>page.margin.top</refentrytitle>\r
7635 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
7636 </refmeta>\r
7637 <refnamediv>\r
7638 <refname>page.margin.top</refname>\r
7639 <refpurpose>The top margin of the page</refpurpose>\r
7640 </refnamediv>\r
7641 \r
7642 <refsynopsisdiv>\r
7643 <programlisting xml:id="page.margin.top.frag">\r
7644 &lt;xsl:param name="page.margin.top"&gt;0.5in&lt;/xsl:param&gt;\r
7645 </programlisting>\r
7646 </refsynopsisdiv>\r
7647 \r
7648 <refsection><info><title>Description</title></info>\r
7649 \r
7650 <para>The top page margin is the distance from the physical top of the\r
7651 page to the top of the region-before.</para>\r
7652 \r
7653 </refsection>\r
7654 </refentry>\r
7655 \r
7656 <refentry version="5.0" xml:id="page.orientation">\r
7657 <refmeta>\r
7658 <refentrytitle>page.orientation</refentrytitle>\r
7659 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>\r
7660 <refmiscinfo class="other" otherclass="value">portrait</refmiscinfo>\r
7661 <refmiscinfo class="other" otherclass="value">landscape</refmiscinfo>\r
7662 </refmeta>\r
7663 <refnamediv>\r
7664 <refname>page.orientation</refname>\r
7665 <refpurpose>Select the page orientation</refpurpose>\r
7666 </refnamediv>\r
7667 \r
7668 <refsynopsisdiv>\r
7669 <programlisting xml:id="page.orientation.frag">\r
7670 &lt;xsl:param name="page.orientation"&gt;portrait&lt;/xsl:param&gt;\r
7671 </programlisting>\r
7672 </refsynopsisdiv>\r
7673 \r
7674 <refsection><info><title>Description</title></info>\r
7675 \r
7676 <para> Select one from portrait or landscape.\r
7677 In portrait orientation, the short edge is horizontal; in\r
7678 landscape orientation, it is vertical.\r
7679 </para>\r
7680 \r
7681 </refsection>\r
7682 </refentry>\r
7683 \r
7684 <refentry version="5.0" xml:id="page.width">\r
7685 <refmeta>\r
7686 <refentrytitle>page.width</refentrytitle>\r
7687 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
7688 </refmeta>\r
7689 <refnamediv>\r
7690 <refname>page.width</refname>\r
7691 <refpurpose>The width of the physical page</refpurpose>\r
7692 </refnamediv>\r
7693 \r
7694 <refsynopsisdiv>\r
7695 <programlisting xml:id="page.width.frag">&lt;xsl:param name="page.width"&gt;\r
7696   &lt;xsl:choose&gt;\r
7697     &lt;xsl:when test="$page.orientation = 'portrait'"&gt;\r
7698       &lt;xsl:value-of select="$page.width.portrait"&gt;&lt;/xsl:value-of&gt;\r
7699     &lt;/xsl:when&gt;\r
7700     &lt;xsl:otherwise&gt;\r
7701       &lt;xsl:value-of select="$page.height.portrait"&gt;&lt;/xsl:value-of&gt;\r
7702     &lt;/xsl:otherwise&gt;\r
7703   &lt;/xsl:choose&gt;\r
7704 &lt;/xsl:param&gt;</programlisting>\r
7705 </refsynopsisdiv>\r
7706 \r
7707 <refsection><info><title>Description</title></info>\r
7708 \r
7709 <para>The page width is generally calculated from the\r
7710 <parameter>paper.type</parameter> and \r
7711 <parameter>page.orientation</parameter> parameters.</para>\r
7712 \r
7713 </refsection>\r
7714 </refentry>\r
7715 \r
7716 <refentry version="5.0" xml:id="page.width.portrait">\r
7717 <refmeta>\r
7718 <refentrytitle>page.width.portrait</refentrytitle>\r
7719 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
7720 </refmeta>\r
7721 <refnamediv>\r
7722 <refname>page.width.portrait</refname>\r
7723 <refpurpose>Specify the physical size of the short edge of the page</refpurpose>\r
7724 </refnamediv>\r
7725 \r
7726 <refsynopsisdiv>\r
7727 <programlisting xml:id="page.width.portrait.frag">&lt;xsl:param name="page.width.portrait"&gt;\r
7728   &lt;xsl:choose&gt;\r
7729     &lt;xsl:when test="$paper.type = 'USletter'"&gt;8.5in&lt;/xsl:when&gt;\r
7730     &lt;xsl:when test="$paper.type = '4A0'"&gt;1682mm&lt;/xsl:when&gt;\r
7731     &lt;xsl:when test="$paper.type = '2A0'"&gt;1189mm&lt;/xsl:when&gt;\r
7732     &lt;xsl:when test="$paper.type = 'A0'"&gt;841mm&lt;/xsl:when&gt;\r
7733     &lt;xsl:when test="$paper.type = 'A1'"&gt;594mm&lt;/xsl:when&gt;\r
7734     &lt;xsl:when test="$paper.type = 'A2'"&gt;420mm&lt;/xsl:when&gt;\r
7735     &lt;xsl:when test="$paper.type = 'A3'"&gt;297mm&lt;/xsl:when&gt;\r
7736     &lt;xsl:when test="$paper.type = 'A4'"&gt;210mm&lt;/xsl:when&gt;\r
7737     &lt;xsl:when test="$paper.type = 'A5'"&gt;148mm&lt;/xsl:when&gt;\r
7738     &lt;xsl:when test="$paper.type = 'A6'"&gt;105mm&lt;/xsl:when&gt;\r
7739     &lt;xsl:when test="$paper.type = 'A7'"&gt;74mm&lt;/xsl:when&gt;\r
7740     &lt;xsl:when test="$paper.type = 'A8'"&gt;52mm&lt;/xsl:when&gt;\r
7741     &lt;xsl:when test="$paper.type = 'A9'"&gt;37mm&lt;/xsl:when&gt;\r
7742     &lt;xsl:when test="$paper.type = 'A10'"&gt;26mm&lt;/xsl:when&gt;\r
7743     &lt;xsl:when test="$paper.type = 'B0'"&gt;1000mm&lt;/xsl:when&gt;\r
7744     &lt;xsl:when test="$paper.type = 'B1'"&gt;707mm&lt;/xsl:when&gt;\r
7745     &lt;xsl:when test="$paper.type = 'B2'"&gt;500mm&lt;/xsl:when&gt;\r
7746     &lt;xsl:when test="$paper.type = 'B3'"&gt;353mm&lt;/xsl:when&gt;\r
7747     &lt;xsl:when test="$paper.type = 'B4'"&gt;250mm&lt;/xsl:when&gt;\r
7748     &lt;xsl:when test="$paper.type = 'B5'"&gt;176mm&lt;/xsl:when&gt;\r
7749     &lt;xsl:when test="$paper.type = 'B6'"&gt;125mm&lt;/xsl:when&gt;\r
7750     &lt;xsl:when test="$paper.type = 'B7'"&gt;88mm&lt;/xsl:when&gt;\r
7751     &lt;xsl:when test="$paper.type = 'B8'"&gt;62mm&lt;/xsl:when&gt;\r
7752     &lt;xsl:when test="$paper.type = 'B9'"&gt;44mm&lt;/xsl:when&gt;\r
7753     &lt;xsl:when test="$paper.type = 'B10'"&gt;31mm&lt;/xsl:when&gt;\r
7754     &lt;xsl:when test="$paper.type = 'C0'"&gt;917mm&lt;/xsl:when&gt;\r
7755     &lt;xsl:when test="$paper.type = 'C1'"&gt;648mm&lt;/xsl:when&gt;\r
7756     &lt;xsl:when test="$paper.type = 'C2'"&gt;458mm&lt;/xsl:when&gt;\r
7757     &lt;xsl:when test="$paper.type = 'C3'"&gt;324mm&lt;/xsl:when&gt;\r
7758     &lt;xsl:when test="$paper.type = 'C4'"&gt;229mm&lt;/xsl:when&gt;\r
7759     &lt;xsl:when test="$paper.type = 'C5'"&gt;162mm&lt;/xsl:when&gt;\r
7760     &lt;xsl:when test="$paper.type = 'C6'"&gt;114mm&lt;/xsl:when&gt;\r
7761     &lt;xsl:when test="$paper.type = 'C7'"&gt;81mm&lt;/xsl:when&gt;\r
7762     &lt;xsl:when test="$paper.type = 'C8'"&gt;57mm&lt;/xsl:when&gt;\r
7763     &lt;xsl:when test="$paper.type = 'C9'"&gt;40mm&lt;/xsl:when&gt;\r
7764     &lt;xsl:when test="$paper.type = 'C10'"&gt;28mm&lt;/xsl:when&gt;\r
7765     &lt;xsl:otherwise&gt;8.5in&lt;/xsl:otherwise&gt;\r
7766   &lt;/xsl:choose&gt;\r
7767 &lt;/xsl:param&gt;</programlisting>\r
7768 </refsynopsisdiv>\r
7769 \r
7770 <refsection><info><title>Description</title></info>\r
7771 \r
7772 <para>The portrait page width is the length of the short\r
7773 edge of the physical page.\r
7774 </para>\r
7775 \r
7776 </refsection>\r
7777 </refentry>\r
7778 \r
7779 <refentry version="5.0" xml:id="paper.type">\r
7780 <refmeta>\r
7781 <refentrytitle>paper.type</refentrytitle>\r
7782 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>\r
7783 <refmiscinfo class="other" otherclass="list-type">open</refmiscinfo>\r
7784 <refmiscinfo class="other" otherclass="list-type">open</refmiscinfo>\r
7785 <refmiscinfo class="other" otherclass="value">USletter<alt>8.5x11in</alt></refmiscinfo>\r
7786 <refmiscinfo class="other" otherclass="value">USlandscape<alt>11x8.5in</alt></refmiscinfo>\r
7787 <refmiscinfo class="other" otherclass="value">4A0<alt>2378x1682mm</alt></refmiscinfo>\r
7788 <refmiscinfo class="other" otherclass="value">2A0<alt>1682x1189mm</alt></refmiscinfo>\r
7789 <refmiscinfo class="other" otherclass="value">A0<alt>1189x841mm</alt></refmiscinfo>\r
7790 <refmiscinfo class="other" otherclass="value">A1<alt>841x594mm</alt></refmiscinfo>\r
7791 <refmiscinfo class="other" otherclass="value">A2<alt>594x420mm</alt></refmiscinfo>\r
7792 <refmiscinfo class="other" otherclass="value">A3<alt>420x297mm</alt></refmiscinfo>\r
7793 <refmiscinfo class="other" otherclass="value">A4<alt>297x210mm</alt></refmiscinfo>\r
7794 <refmiscinfo class="other" otherclass="value">A5<alt>210x148mm</alt></refmiscinfo>\r
7795 <refmiscinfo class="other" otherclass="value">A6<alt>148x105mm</alt></refmiscinfo>\r
7796 <refmiscinfo class="other" otherclass="value">A7<alt>105x74mm</alt></refmiscinfo>\r
7797 <refmiscinfo class="other" otherclass="value">A8<alt>74x52mm</alt></refmiscinfo>\r
7798 <refmiscinfo class="other" otherclass="value">A9<alt>52x37mm</alt></refmiscinfo>\r
7799 <refmiscinfo class="other" otherclass="value">A10<alt>37x26mm</alt></refmiscinfo>\r
7800 <refmiscinfo class="other" otherclass="value">B0<alt>1414x1000mm</alt></refmiscinfo>\r
7801 <refmiscinfo class="other" otherclass="value">B1<alt>1000x707mm</alt></refmiscinfo>\r
7802 <refmiscinfo class="other" otherclass="value">B2<alt>707x500mm</alt></refmiscinfo>\r
7803 <refmiscinfo class="other" otherclass="value">B3<alt>500x353mm</alt></refmiscinfo>\r
7804 <refmiscinfo class="other" otherclass="value">B4<alt>353x250mm</alt></refmiscinfo>\r
7805 <refmiscinfo class="other" otherclass="value">B5<alt>250x176mm</alt></refmiscinfo>\r
7806 <refmiscinfo class="other" otherclass="value">B6<alt>176x125mm</alt></refmiscinfo>\r
7807 <refmiscinfo class="other" otherclass="value">B7<alt>125x88mm</alt></refmiscinfo>\r
7808 <refmiscinfo class="other" otherclass="value">B8<alt>88x62mm</alt></refmiscinfo>\r
7809 <refmiscinfo class="other" otherclass="value">B9<alt>62x44mm</alt></refmiscinfo>\r
7810 <refmiscinfo class="other" otherclass="value">B10<alt>44x31mm</alt></refmiscinfo>\r
7811 <refmiscinfo class="other" otherclass="value">C0<alt>1297x917mm</alt></refmiscinfo>\r
7812 <refmiscinfo class="other" otherclass="value">C1<alt>917x648mm</alt></refmiscinfo>\r
7813 <refmiscinfo class="other" otherclass="value">C2<alt>648x458mm</alt></refmiscinfo>\r
7814 <refmiscinfo class="other" otherclass="value">C3<alt>458x324mm</alt></refmiscinfo>\r
7815 <refmiscinfo class="other" otherclass="value">C4<alt>324x229mm</alt></refmiscinfo>\r
7816 <refmiscinfo class="other" otherclass="value">C5<alt>229x162mm</alt></refmiscinfo>\r
7817 <refmiscinfo class="other" otherclass="value">C6<alt>162x114mm</alt></refmiscinfo>\r
7818 <refmiscinfo class="other" otherclass="value">C7<alt>114x81mm</alt></refmiscinfo>\r
7819 <refmiscinfo class="other" otherclass="value">C8<alt>81x57mm</alt></refmiscinfo>\r
7820 <refmiscinfo class="other" otherclass="value">C9<alt>57x40mm</alt></refmiscinfo>\r
7821 <refmiscinfo class="other" otherclass="value">C10<alt>40x28mm</alt></refmiscinfo>\r
7822 </refmeta>\r
7823 <refnamediv>\r
7824 <refname>paper.type</refname>\r
7825 <refpurpose>Select the paper type</refpurpose>\r
7826 </refnamediv>\r
7827 \r
7828 <refsynopsisdiv>\r
7829 <programlisting xml:id="paper.type.frag">\r
7830 &lt;xsl:param name="paper.type"&gt;USletter&lt;/xsl:param&gt;\r
7831 </programlisting>\r
7832 </refsynopsisdiv>\r
7833 \r
7834 <refsection><info><title>Description</title></info>\r
7835 \r
7836 <para>The paper type is a convenient way to specify the paper size.\r
7837 The list of known paper sizes includes USletter and most of the A,\r
7838 B, and C sizes. See <parameter>page.width.portrait</parameter>, for example.\r
7839 \r
7840 \r
7841 </para>\r
7842 \r
7843 </refsection>\r
7844 </refentry>\r
7845 \r
7846 <refentry version="5.0" xml:id="double.sided">\r
7847 <refmeta>\r
7848 <refentrytitle>double.sided</refentrytitle>\r
7849 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
7850 </refmeta>\r
7851 <refnamediv>\r
7852 <refname>double.sided</refname>\r
7853 <refpurpose>Is the document to be printed double sided?</refpurpose>\r
7854 </refnamediv>\r
7855 \r
7856 <refsynopsisdiv>\r
7857 <programlisting xml:id="double.sided.frag">\r
7858 &lt;xsl:param name="double.sided" select="0"&gt;&lt;/xsl:param&gt;\r
7859 </programlisting>\r
7860 </refsynopsisdiv>\r
7861 \r
7862 <refsection><info><title>Description</title></info>\r
7863 \r
7864 <para>Double-sided documents are printed with a slightly wider margin\r
7865 on the binding edge of the page.\r
7866 </para>\r
7867 <para>FIXME: The current set of parameters does not take writing direction\r
7868 into account.</para>\r
7869 \r
7870 </refsection>\r
7871 </refentry>\r
7872 \r
7873 <refentry version="5.0" xml:id="body.margin.bottom">\r
7874 <refmeta>\r
7875 <refentrytitle>body.margin.bottom</refentrytitle>\r
7876 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
7877 </refmeta>\r
7878 <refnamediv>\r
7879 <refname>body.margin.bottom</refname>\r
7880 <refpurpose>The bottom margin of the body text</refpurpose>\r
7881 </refnamediv>\r
7882 \r
7883 <refsynopsisdiv>\r
7884 <programlisting xml:id="body.margin.bottom.frag">\r
7885 &lt;xsl:param name="body.margin.bottom"&gt;0.5in&lt;/xsl:param&gt;\r
7886 </programlisting>\r
7887 </refsynopsisdiv>\r
7888 \r
7889 <refsection><info><title>Description</title></info>\r
7890 \r
7891 <para>The body bottom margin is the distance from the last line of text\r
7892 in the page body to the bottom of the region-after.\r
7893 </para>\r
7894 \r
7895 </refsection>\r
7896 </refentry>\r
7897 \r
7898 <refentry version="5.0" xml:id="body.margin.top">\r
7899 <refmeta>\r
7900 <refentrytitle>body.margin.top</refentrytitle>\r
7901 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
7902 </refmeta>\r
7903 <refnamediv>\r
7904 <refname>body.margin.top</refname>\r
7905 <refpurpose>To specify the size of the top margin of a page</refpurpose>\r
7906 </refnamediv>\r
7907 \r
7908 <refsynopsisdiv>\r
7909 <programlisting xml:id="body.margin.top.frag">\r
7910 &lt;xsl:param name="body.margin.top"&gt;0.5in&lt;/xsl:param&gt;\r
7911 </programlisting>\r
7912 </refsynopsisdiv>\r
7913 \r
7914 <refsection><info><title>Description</title></info>\r
7915 \r
7916 <para>The body top margin is the distance from the top of the\r
7917 region-before to the first line of text in the page body.</para>\r
7918 \r
7919 </refsection>\r
7920 </refentry>\r
7921 \r
7922 <refentry version="5.0" xml:id="body.start.indent">\r
7923 <refmeta>\r
7924 <refentrytitle>body.start.indent</refentrytitle>\r
7925 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
7926 </refmeta>\r
7927 <refnamediv>\r
7928 <refname>body.start.indent</refname>\r
7929 <refpurpose>The start-indent for the body text</refpurpose>\r
7930 </refnamediv>\r
7931 \r
7932 <refsynopsisdiv>\r
7933 <programlisting xml:id="body.start.indent.frag">\r
7934 &lt;xsl:param name="body.start.indent"&gt;\r
7935   &lt;xsl:choose&gt;\r
7936     &lt;xsl:when test="$fop.extensions != 0"&gt;0pt&lt;/xsl:when&gt;\r
7937     &lt;xsl:when test="$passivetex.extensions != 0"&gt;0pt&lt;/xsl:when&gt;\r
7938     &lt;xsl:otherwise&gt;4pc&lt;/xsl:otherwise&gt;\r
7939   &lt;/xsl:choose&gt;\r
7940 &lt;/xsl:param&gt;\r
7941 </programlisting>\r
7942 </refsynopsisdiv>\r
7943 \r
7944 <refsection><info><title>Description</title></info>\r
7945 \r
7946 <para>This parameter provides\r
7947 the means of indenting the body text relative to\r
7948 section titles.\r
7949 For left-to-right text direction, it indents the left side.\r
7950 For right-to-left text direction, it indents the right side.\r
7951 It is used in place of the \r
7952 <parameter>title.margin.left</parameter> for\r
7953 all XSL-FO processors except FOP 0.25.\r
7954 It enables support for side floats to appear\r
7955 in the indented margin area.\r
7956 </para>\r
7957 <para>This start-indent property is added to the fo:flow\r
7958 for certain page sequences.  Which page-sequences it is \r
7959 applied to is determined by the template named\r
7960 <literal>set.flow.properties</literal>.\r
7961 By default, that template adds it to the flow\r
7962 for page-sequences using the <quote>body</quote>\r
7963 master-reference, as well as appendixes and prefaces.\r
7964 </para>\r
7965 <para>If this parameter is used, section titles should have\r
7966 a start-indent value of 0pt if they are to be\r
7967 outdented relative to the body text.\r
7968 </para>\r
7969 \r
7970 <para>If you are using FOP, then set this parameter to a zero\r
7971 width value and set the <parameter>title.margin.left</parameter>\r
7972 parameter to the negative value of the desired indent.\r
7973 </para>\r
7974 \r
7975 <para>See also <parameter>body.end.indent</parameter> and\r
7976 <parameter>title.margin.left</parameter>.\r
7977 </para>\r
7978 \r
7979 </refsection>\r
7980 </refentry>\r
7981 \r
7982 <refentry version="5.0" xml:id="body.end.indent">\r
7983 <refmeta>\r
7984 <refentrytitle>body.end.indent</refentrytitle>\r
7985 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
7986 </refmeta>\r
7987 <refnamediv>\r
7988 <refname>body.end.indent</refname>\r
7989 <refpurpose>The end-indent for the body text</refpurpose>\r
7990 </refnamediv>\r
7991 \r
7992 <refsynopsisdiv>\r
7993 <programlisting xml:id="body.end.indent.frag">\r
7994 &lt;xsl:param name="body.end.indent"&gt;0pt&lt;/xsl:param&gt;\r
7995 </programlisting>\r
7996 </refsynopsisdiv>\r
7997 \r
7998 <refsection><info><title>Description</title></info>\r
7999 \r
8000 <para>This end-indent property is added to the fo:flow\r
8001 for certain page sequences.  Which page-sequences it is \r
8002 applied to is determined by the template named\r
8003 <literal>set.flow.properties</literal>.\r
8004 By default, that template adds it to the flow\r
8005 for page-sequences using the <quote>body</quote>\r
8006 master-reference, as well as appendixes and prefaces.\r
8007 </para>\r
8008 \r
8009 <para>See also <parameter>body.start.indent</parameter>.\r
8010 </para>\r
8011 \r
8012 </refsection>\r
8013 </refentry>\r
8014 \r
8015 <refentry version="5.0" xml:id="alignment">\r
8016 <refmeta>\r
8017 <refentrytitle>alignment</refentrytitle>\r
8018   <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>\r
8019   <refmiscinfo class="other" otherclass="list-type">open</refmiscinfo>\r
8020   <refmiscinfo class="other" otherclass="value">left</refmiscinfo>\r
8021   <refmiscinfo class="other" otherclass="value">start</refmiscinfo>\r
8022   <refmiscinfo class="other" otherclass="value">right</refmiscinfo>\r
8023   <refmiscinfo class="other" otherclass="value">end</refmiscinfo>\r
8024   <refmiscinfo class="other" otherclass="value">center</refmiscinfo>\r
8025   <refmiscinfo class="other" otherclass="value">justify</refmiscinfo>\r
8026 </refmeta>\r
8027 <refnamediv>\r
8028 <refname>alignment</refname>\r
8029 <refpurpose>Specify the default text alignment</refpurpose>\r
8030 </refnamediv>\r
8031 \r
8032 <refsynopsisdiv>\r
8033 <programlisting xml:id="alignment.frag">&lt;xsl:param name="alignment"&gt;justify&lt;/xsl:param&gt;</programlisting>\r
8034 </refsynopsisdiv>\r
8035 \r
8036 <refsection><info><title>Description</title></info>\r
8037 \r
8038 <para>The default text alignment is used for most body text.\r
8039 Allowed values are \r
8040 <literal>left</literal>,\r
8041 <literal>right</literal>,\r
8042 <literal>start</literal>,\r
8043 <literal>end</literal>,\r
8044 <literal>center</literal>,\r
8045 <literal>justify</literal>.\r
8046 The default value is <literal>justify</literal>.\r
8047 </para>\r
8048 \r
8049 </refsection>\r
8050 </refentry>\r
8051 \r
8052 <refentry version="5.0" xml:id="hyphenate">\r
8053 <refmeta>\r
8054 <refentrytitle>hyphenate</refentrytitle>\r
8055 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>\r
8056 <refmiscinfo class="other" otherclass="list-type">closed</refmiscinfo>\r
8057 <refmiscinfo class="other" otherclass="value">true</refmiscinfo>\r
8058 <refmiscinfo class="other" otherclass="value">false</refmiscinfo>\r
8059 </refmeta>\r
8060 <refnamediv>\r
8061 <refname>hyphenate</refname>\r
8062 <refpurpose>Specify hyphenation behavior</refpurpose>\r
8063 </refnamediv>\r
8064 \r
8065 <refsynopsisdiv>\r
8066 <programlisting xml:id="hyphenate.frag">&lt;xsl:param name="hyphenate"&gt;true&lt;/xsl:param&gt;</programlisting>\r
8067 </refsynopsisdiv>\r
8068 \r
8069 <refsection><info><title>Description</title></info>\r
8070 \r
8071 <para>If true, words may be hyphenated. Otherwise, they may not.\r
8072 </para>\r
8073 \r
8074 </refsection>\r
8075 </refentry>\r
8076 \r
8077 <refentry version="5.0" xml:id="line-height">\r
8078 <refmeta>\r
8079 <refentrytitle>line-height</refentrytitle>\r
8080 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
8081 </refmeta>\r
8082 <refnamediv>\r
8083 <refname>line-height</refname>\r
8084 <refpurpose>Specify the line-height property</refpurpose>\r
8085 </refnamediv>\r
8086 \r
8087 <refsynopsisdiv>\r
8088 <programlisting xml:id="line-height.frag">\r
8089 &lt;xsl:param name="line-height"&gt;normal&lt;/xsl:param&gt;\r
8090 </programlisting>\r
8091 </refsynopsisdiv>\r
8092 \r
8093 <refsection><info><title>Description</title></info>\r
8094 \r
8095 <para>Sets the line-height property.</para>\r
8096 \r
8097 </refsection>\r
8098 </refentry>\r
8099 \r
8100 <refentry version="5.0" xml:id="column.count.back">\r
8101 <refmeta>\r
8102 <refentrytitle>column.count.back</refentrytitle>\r
8103 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>\r
8104 </refmeta>\r
8105 <refnamediv>\r
8106 <refname>column.count.back</refname>\r
8107 <refpurpose>Number of columns on back matter pages</refpurpose>\r
8108 </refnamediv>\r
8109 \r
8110 <refsynopsisdiv>\r
8111 <programlisting xml:id="column.count.back.frag">\r
8112 &lt;xsl:param name="column.count.back" select="1"&gt;&lt;/xsl:param&gt;\r
8113 </programlisting>\r
8114 </refsynopsisdiv>\r
8115 \r
8116 <refsection><info><title>Description</title></info>\r
8117 \r
8118 <para>Number of columns on back matter (appendix, glossary, etc.) pages.</para>\r
8119 \r
8120 </refsection>\r
8121 </refentry>\r
8122 \r
8123 <refentry version="5.0" xml:id="column.count.body">\r
8124 <refmeta>\r
8125 <refentrytitle>column.count.body</refentrytitle>\r
8126 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>\r
8127 </refmeta>\r
8128 <refnamediv>\r
8129 <refname>column.count.body</refname>\r
8130 <refpurpose>Number of columns on body pages</refpurpose>\r
8131 </refnamediv>\r
8132 \r
8133 <refsynopsisdiv>\r
8134 <programlisting xml:id="column.count.body.frag">\r
8135 &lt;xsl:param name="column.count.body" select="1"&gt;&lt;/xsl:param&gt;\r
8136 </programlisting>\r
8137 </refsynopsisdiv>\r
8138 \r
8139 <refsection><info><title>Description</title></info>\r
8140 \r
8141 <para>Number of columns on body pages.</para>\r
8142 \r
8143 </refsection>\r
8144 </refentry>\r
8145 \r
8146 <refentry version="5.0" xml:id="column.count.front">\r
8147 <refmeta>\r
8148 <refentrytitle>column.count.front</refentrytitle>\r
8149 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>\r
8150 </refmeta>\r
8151 <refnamediv>\r
8152 <refname>column.count.front</refname>\r
8153 <refpurpose>Number of columns on front matter pages</refpurpose>\r
8154 </refnamediv>\r
8155 \r
8156 <refsynopsisdiv>\r
8157 <programlisting xml:id="column.count.front.frag">\r
8158 &lt;xsl:param name="column.count.front" select="1"&gt;&lt;/xsl:param&gt;\r
8159 </programlisting>\r
8160 </refsynopsisdiv>\r
8161 \r
8162 <refsection><info><title>Description</title></info>\r
8163 \r
8164 <para>Number of columns on front matter (dedication, preface, etc.) pages.</para>\r
8165 \r
8166 </refsection>\r
8167 </refentry>\r
8168 \r
8169 <refentry version="5.0" xml:id="column.count.index">\r
8170 <refmeta>\r
8171 <refentrytitle>column.count.index</refentrytitle>\r
8172 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>\r
8173 </refmeta>\r
8174 <refnamediv>\r
8175 <refname>column.count.index</refname>\r
8176 <refpurpose>Number of columns on index pages</refpurpose>\r
8177 </refnamediv>\r
8178 \r
8179 <refsynopsisdiv>\r
8180 <programlisting xml:id="column.count.index.frag">\r
8181 &lt;xsl:param name="column.count.index"&gt;2&lt;/xsl:param&gt;\r
8182 </programlisting>\r
8183 </refsynopsisdiv>\r
8184 \r
8185 <refsection><info><title>Description</title></info>\r
8186 \r
8187 <para>Number of columns on index pages.</para>\r
8188 \r
8189 </refsection>\r
8190 </refentry>\r
8191 \r
8192 <refentry version="5.0" xml:id="column.count.lot">\r
8193 <refmeta>\r
8194 <refentrytitle>column.count.lot</refentrytitle>\r
8195 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>\r
8196 </refmeta>\r
8197 <refnamediv>\r
8198 <refname>column.count.lot</refname>\r
8199 <refpurpose>Number of columns on a 'List-of-Titles' page</refpurpose>\r
8200 </refnamediv>\r
8201 \r
8202 <refsynopsisdiv>\r
8203 <programlisting xml:id="column.count.lot.frag">\r
8204 &lt;xsl:param name="column.count.lot" select="1"&gt;&lt;/xsl:param&gt;\r
8205 </programlisting>\r
8206 </refsynopsisdiv>\r
8207 \r
8208 <refsection><info><title>Description</title></info>\r
8209 \r
8210 <para>Number of columns on a page sequence containing the Table of Contents,\r
8211 List of Figures, etc.</para>\r
8212 \r
8213 </refsection>\r
8214 </refentry>\r
8215 \r
8216 <refentry version="5.0" xml:id="column.count.titlepage">\r
8217 <refmeta>\r
8218 <refentrytitle>column.count.titlepage</refentrytitle>\r
8219 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>\r
8220 </refmeta>\r
8221 <refnamediv>\r
8222 <refname>column.count.titlepage</refname>\r
8223 <refpurpose>Number of columns on a title page</refpurpose>\r
8224 </refnamediv>\r
8225 \r
8226 <refsynopsisdiv>\r
8227 <programlisting xml:id="column.count.titlepage.frag">\r
8228 &lt;xsl:param name="column.count.titlepage" select="1"&gt;&lt;/xsl:param&gt;\r
8229 </programlisting>\r
8230 </refsynopsisdiv>\r
8231 \r
8232 <refsection><info><title>Description</title></info>\r
8233 \r
8234 <para>Number of columns on a title page</para>\r
8235 \r
8236 </refsection>\r
8237 </refentry>\r
8238 \r
8239 <refentry version="5.0" xml:id="column.gap.back">\r
8240 <refmeta>\r
8241 <refentrytitle>column.gap.back</refentrytitle>\r
8242 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
8243 </refmeta>\r
8244 <refnamediv>\r
8245 <refname>column.gap.back</refname>\r
8246 <refpurpose>Gap between columns in back matter</refpurpose>\r
8247 </refnamediv>\r
8248 \r
8249 <refsynopsisdiv>\r
8250 <programlisting xml:id="column.gap.back.frag">\r
8251 &lt;xsl:param name="column.gap.back"&gt;12pt&lt;/xsl:param&gt;\r
8252 </programlisting>\r
8253 </refsynopsisdiv>\r
8254 \r
8255 <refsection><info><title>Description</title></info>\r
8256 \r
8257 <para>Specifies the gap between columns in back matter (if\r
8258 <parameter>column.count.back</parameter> is greater than one).</para>\r
8259 \r
8260 </refsection>\r
8261 </refentry>\r
8262 \r
8263 <refentry version="5.0" xml:id="column.gap.body">\r
8264 <refmeta>\r
8265 <refentrytitle>column.gap.body</refentrytitle>\r
8266 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
8267 </refmeta>\r
8268 <refnamediv>\r
8269 <refname>column.gap.body</refname>\r
8270 <refpurpose>Gap between columns in the body</refpurpose>\r
8271 </refnamediv>\r
8272 \r
8273 <refsynopsisdiv>\r
8274 <programlisting xml:id="column.gap.body.frag">\r
8275 &lt;xsl:param name="column.gap.body"&gt;12pt&lt;/xsl:param&gt;\r
8276 </programlisting>\r
8277 </refsynopsisdiv>\r
8278 \r
8279 <refsection><info><title>Description</title></info>\r
8280 \r
8281 <para>Specifies the gap between columns in body matter (if\r
8282 <parameter>column.count.body</parameter> is greater than one).</para>\r
8283 \r
8284 </refsection>\r
8285 </refentry>\r
8286 \r
8287 <refentry version="5.0" xml:id="column.gap.front">\r
8288 <refmeta>\r
8289 <refentrytitle>column.gap.front</refentrytitle>\r
8290 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
8291 </refmeta>\r
8292 <refnamediv>\r
8293 <refname>column.gap.front</refname>\r
8294 <refpurpose>Gap between columns in the front matter</refpurpose>\r
8295 </refnamediv>\r
8296 \r
8297 <refsynopsisdiv>\r
8298 <programlisting xml:id="column.gap.front.frag">\r
8299 &lt;xsl:param name="column.gap.front"&gt;12pt&lt;/xsl:param&gt;\r
8300 </programlisting>\r
8301 </refsynopsisdiv>\r
8302 \r
8303 <refsection><info><title>Description</title></info>\r
8304 \r
8305 <para>Specifies the gap between columns in front matter (if\r
8306 <parameter>column.count.front</parameter> is greater than one).</para>\r
8307 \r
8308 </refsection>\r
8309 </refentry>\r
8310 \r
8311 <refentry version="5.0" xml:id="column.gap.index">\r
8312 <refmeta>\r
8313 <refentrytitle>column.gap.index</refentrytitle>\r
8314 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
8315 </refmeta>\r
8316 <refnamediv>\r
8317 <refname>column.gap.index</refname>\r
8318 <refpurpose>Gap between columns in the index</refpurpose>\r
8319 </refnamediv>\r
8320 \r
8321 <refsynopsisdiv>\r
8322 <programlisting xml:id="column.gap.index.frag">\r
8323 &lt;xsl:param name="column.gap.index"&gt;12pt&lt;/xsl:param&gt;\r
8324 </programlisting>\r
8325 </refsynopsisdiv>\r
8326 \r
8327 <refsection><info><title>Description</title></info>\r
8328 \r
8329 <para>Specifies the gap between columns in indexes (if\r
8330 <parameter>column.count.index</parameter> is greater than one).</para>\r
8331 \r
8332 </refsection>\r
8333 </refentry>\r
8334 \r
8335 <refentry version="5.0" xml:id="column.gap.lot">\r
8336 <refmeta>\r
8337 <refentrytitle>column.gap.lot</refentrytitle>\r
8338 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
8339 </refmeta>\r
8340 <refnamediv>\r
8341 <refname>column.gap.lot</refname>\r
8342 <refpurpose>Gap between columns on a 'List-of-Titles' page</refpurpose>\r
8343 </refnamediv>\r
8344 \r
8345 <refsynopsisdiv>\r
8346 <programlisting xml:id="column.gap.lot.frag">\r
8347 &lt;xsl:param name="column.gap.lot"&gt;12pt&lt;/xsl:param&gt;\r
8348 </programlisting>\r
8349 </refsynopsisdiv>\r
8350 \r
8351 <refsection><info><title>Description</title></info>\r
8352 \r
8353 <para>Specifies the gap between columns on 'List-of-Titles' pages (if\r
8354 <parameter>column.count.lot</parameter> is greater than one).</para>\r
8355 \r
8356 </refsection>\r
8357 </refentry>\r
8358 \r
8359 <refentry version="5.0" xml:id="column.gap.titlepage">\r
8360 <refmeta>\r
8361 <refentrytitle>column.gap.titlepage</refentrytitle>\r
8362 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
8363 </refmeta>\r
8364 <refnamediv>\r
8365 <refname>column.gap.titlepage</refname>\r
8366 <refpurpose>Gap between columns on title pages</refpurpose>\r
8367 </refnamediv>\r
8368 \r
8369 <refsynopsisdiv>\r
8370 <programlisting xml:id="column.gap.titlepage.frag">\r
8371 &lt;xsl:param name="column.gap.titlepage"&gt;12pt&lt;/xsl:param&gt;\r
8372 </programlisting>\r
8373 </refsynopsisdiv>\r
8374 \r
8375 <refsection><info><title>Description</title></info>\r
8376 \r
8377 <para>Specifies the gap between columns on title pages (if\r
8378 <parameter>column.count.titlepage</parameter> is greater than one).</para>\r
8379 \r
8380 \r
8381 </refsection>\r
8382 </refentry>\r
8383 \r
8384 <refentry version="5.0" xml:id="region.after.extent">\r
8385 <refmeta>\r
8386 <refentrytitle>region.after.extent</refentrytitle>\r
8387 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
8388 </refmeta>\r
8389 <refnamediv>\r
8390 <refname>region.after.extent</refname>\r
8391 <refpurpose>Specifies the height of the footer.</refpurpose>\r
8392 </refnamediv>\r
8393 \r
8394 <refsynopsisdiv>\r
8395 <programlisting xml:id="region.after.extent.frag">\r
8396 &lt;xsl:param name="region.after.extent"&gt;0.4in&lt;/xsl:param&gt;\r
8397 </programlisting>\r
8398 </refsynopsisdiv>\r
8399 \r
8400 <refsection><info><title>Description</title></info>\r
8401 \r
8402 <para>The region after extent is the height of the area where footers\r
8403 are printed.\r
8404 </para>\r
8405 \r
8406 </refsection>\r
8407 </refentry>\r
8408 \r
8409 <refentry version="5.0" xml:id="region.before.extent">\r
8410 <refmeta>\r
8411 <refentrytitle>region.before.extent</refentrytitle>\r
8412 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
8413 </refmeta>\r
8414 <refnamediv>\r
8415 <refname>region.before.extent</refname>\r
8416 <refpurpose>Specifies the height of the header</refpurpose>\r
8417 </refnamediv>\r
8418 \r
8419 <refsynopsisdiv>\r
8420 <programlisting xml:id="region.before.extent.frag">\r
8421 &lt;xsl:param name="region.before.extent"&gt;0.4in&lt;/xsl:param&gt;\r
8422 </programlisting>\r
8423 </refsynopsisdiv>\r
8424 \r
8425 <refsection><info><title>Description</title></info>\r
8426 \r
8427 <para>The region before extent is the height of the area where headers\r
8428 are printed.\r
8429 </para>\r
8430 \r
8431 </refsection>\r
8432 </refentry>\r
8433 \r
8434 <refentry version="5.0" xml:id="default.units">\r
8435 <refmeta>\r
8436 <refentrytitle>default.units</refentrytitle>\r
8437 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>\r
8438 <refmiscinfo class="other" otherclass="value">cm</refmiscinfo>\r
8439 <refmiscinfo class="other" otherclass="value">mm</refmiscinfo>\r
8440 <refmiscinfo class="other" otherclass="value">in</refmiscinfo>\r
8441 <refmiscinfo class="other" otherclass="value">pt</refmiscinfo>\r
8442 <refmiscinfo class="other" otherclass="value">pc</refmiscinfo>\r
8443 <refmiscinfo class="other" otherclass="value">px</refmiscinfo>\r
8444 <refmiscinfo class="other" otherclass="value">em</refmiscinfo>\r
8445 </refmeta>\r
8446 <refnamediv>\r
8447 <refname>default.units</refname>\r
8448 <refpurpose>Default units for an unqualified dimension</refpurpose>\r
8449 </refnamediv>\r
8450 \r
8451 <refsynopsisdiv>\r
8452 <programlisting xml:id="default.units.frag">\r
8453 &lt;xsl:param name="default.units"&gt;pt&lt;/xsl:param&gt;\r
8454 </programlisting>\r
8455 </refsynopsisdiv>\r
8456 \r
8457 <refsection><info><title>Description</title></info>\r
8458 \r
8459 <para>If an unqualified dimension is encountered (for example, in a\r
8460 graphic width), the <parameter>default.units</parameter> will be used for the\r
8461 units. Unqualified dimensions are not allowed in XSL Formatting Objects.\r
8462 </para>\r
8463 \r
8464 </refsection>\r
8465 </refentry>\r
8466 \r
8467 <refentry version="5.0" xml:id="normal.para.spacing">\r
8468 <refmeta>\r
8469 <refentrytitle>normal.para.spacing</refentrytitle>\r
8470 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
8471 </refmeta>\r
8472 <refnamediv>\r
8473 <refname>normal.para.spacing</refname>\r
8474 <refpurpose>What space do you want between normal paragraphs</refpurpose>\r
8475 </refnamediv>\r
8476 \r
8477 <refsynopsisdiv>\r
8478 <programlisting xml:id="normal.para.spacing.frag">&lt;xsl:attribute-set name="normal.para.spacing"&gt;\r
8479   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;\r
8480   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;\r
8481   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;\r
8482 &lt;/xsl:attribute-set&gt;</programlisting>\r
8483 </refsynopsisdiv>\r
8484 <refsection><info><title>Description</title></info>\r
8485 <para>Specify the spacing required between normal paragraphs</para>\r
8486 </refsection>\r
8487 </refentry>\r
8488 \r
8489 <refentry version="5.0" xml:id="body.font.master">\r
8490 <refmeta>\r
8491 <refentrytitle>body.font.master</refentrytitle>\r
8492   <refmiscinfo class="other" otherclass="datatype">number</refmiscinfo>\r
8493 </refmeta>\r
8494 <refnamediv>\r
8495 <refname>body.font.master</refname>\r
8496 <refpurpose>Specifies the default point size for body text</refpurpose>\r
8497 </refnamediv>\r
8498 \r
8499 <refsynopsisdiv>\r
8500 <programlisting xml:id="body.font.master.frag">\r
8501 &lt;xsl:param name="body.font.master"&gt;10&lt;/xsl:param&gt;\r
8502 </programlisting>\r
8503 </refsynopsisdiv>\r
8504 \r
8505 <refsection><info><title>Description</title></info>\r
8506 \r
8507 <para>The body font size is specified in two parameters\r
8508 (<parameter>body.font.master</parameter> and <parameter>body.font.size</parameter>)\r
8509 so that math can be performed on the font size by XSLT.\r
8510 </para>\r
8511 \r
8512 </refsection>\r
8513 </refentry>\r
8514 \r
8515 <refentry version="5.0" xml:id="body.font.size">\r
8516 <refmeta>\r
8517 <refentrytitle>body.font.size</refentrytitle>\r
8518 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
8519 </refmeta>\r
8520 <refnamediv>\r
8521 <refname>body.font.size</refname>\r
8522 <refpurpose>Specifies the default font size for body text</refpurpose>\r
8523 </refnamediv>\r
8524 \r
8525 <refsynopsisdiv>\r
8526 <programlisting xml:id="body.font.size.frag">\r
8527 &lt;xsl:param name="body.font.size"&gt;\r
8528  &lt;xsl:value-of select="$body.font.master"&gt;&lt;/xsl:value-of&gt;&lt;xsl:text&gt;pt&lt;/xsl:text&gt;\r
8529 &lt;/xsl:param&gt;</programlisting>\r
8530 </refsynopsisdiv>\r
8531 \r
8532 <refsection><info><title>Description</title></info>\r
8533 \r
8534 <para>The body font size is specified in two parameters\r
8535 (<parameter>body.font.master</parameter> and <parameter>body.font.size</parameter>)\r
8536 so that math can be performed on the font size by XSLT.\r
8537 </para>\r
8538 \r
8539 </refsection>\r
8540 </refentry>\r
8541 \r
8542 <refentry version="5.0" xml:id="footnote.font.size">\r
8543 <refmeta>\r
8544 <refentrytitle>footnote.font.size</refentrytitle>\r
8545 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
8546 </refmeta>\r
8547 <refnamediv>\r
8548 <refname>footnote.font.size</refname>\r
8549 <refpurpose>The font size for footnotes</refpurpose>\r
8550 </refnamediv>\r
8551 \r
8552 <refsynopsisdiv>\r
8553 <programlisting xml:id="footnote.font.size.frag">&lt;xsl:param name="footnote.font.size"&gt;\r
8554  &lt;xsl:value-of select="$body.font.master * 0.8"&gt;&lt;/xsl:value-of&gt;&lt;xsl:text&gt;pt&lt;/xsl:text&gt;\r
8555 &lt;/xsl:param&gt;</programlisting>\r
8556 </refsynopsisdiv>\r
8557 \r
8558 <refsection><info><title>Description</title></info>\r
8559 \r
8560 <para>The footnote font size is used for...footnotes!\r
8561 </para>\r
8562 \r
8563 </refsection>\r
8564 </refentry>\r
8565 \r
8566 <refentry version="5.0" xml:id="title.margin.left">\r
8567 <refmeta>\r
8568 <refentrytitle>title.margin.left</refentrytitle>\r
8569 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
8570 </refmeta>\r
8571 <refnamediv>\r
8572 <refname>title.margin.left</refname>\r
8573 <refpurpose>Adjust the left margin for titles</refpurpose>\r
8574 </refnamediv>\r
8575 \r
8576 <refsynopsisdiv>\r
8577 <programlisting xml:id="title.margin.left.frag">\r
8578 &lt;xsl:param name="title.margin.left"&gt;\r
8579   &lt;xsl:choose&gt;\r
8580     &lt;xsl:when test="$fop.extensions != 0"&gt;-4pc&lt;/xsl:when&gt;\r
8581     &lt;xsl:when test="$passivetex.extensions != 0"&gt;0pt&lt;/xsl:when&gt;\r
8582     &lt;xsl:otherwise&gt;0pt&lt;/xsl:otherwise&gt;\r
8583   &lt;/xsl:choose&gt;\r
8584 &lt;/xsl:param&gt;\r
8585 </programlisting>\r
8586 </refsynopsisdiv>\r
8587 \r
8588 <refsection><info><title>Description</title></info>\r
8589 \r
8590 <para>This parameter provides\r
8591 the means of adjusting the left margin for titles\r
8592 when the XSL-FO processor being used is\r
8593 an old version of FOP (0.25 and earlier).\r
8594 It is only useful when the <parameter>fop.extensions</parameter>\r
8595 is nonzero.</para>\r
8596 \r
8597 <para>The left margin of the body region\r
8598 is calculated to include this space,\r
8599 and titles are outdented to the left outside\r
8600 the body region by this amount,\r
8601 effectively leaving titles at the intended left margin\r
8602 and the body text indented.\r
8603 Currently this method is only used for old FOP because\r
8604 it cannot properly use the <parameter>body.start.indent</parameter>\r
8605 parameter.\r
8606 </para>\r
8607 <para>\r
8608 The default value when the <parameter>fop.extensions</parameter>\r
8609 parameter is nonzero is -4pc, which means the\r
8610 body text is indented 4 picas relative to\r
8611 the titles.\r
8612 The default value when the <parameter>fop.extensions</parameter>\r
8613 parameter equals zero is 0pt, and\r
8614 the body indent should instead be specified\r
8615 using the <parameter>body.start.indent</parameter>\r
8616 parameter.\r
8617 </para>\r
8618 <para>\r
8619 If you set the value to zero, be sure to still include\r
8620 a unit indicator such as <literal>0pt</literal>, or\r
8621 the FO processor will report errors.\r
8622 </para>\r
8623 \r
8624 </refsection>\r
8625 </refentry>\r
8626 \r
8627 <refentry version="5.0" xml:id="draft.mode">\r
8628 <refmeta>\r
8629 <refentrytitle>draft.mode</refentrytitle>\r
8630 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>\r
8631 <refmiscinfo class="other" otherclass="value">no</refmiscinfo> \r
8632 <refmiscinfo class="other" otherclass="value">yes</refmiscinfo>\r
8633 <refmiscinfo class="other" otherclass="value">maybe</refmiscinfo>\r
8634 </refmeta>\r
8635 <refnamediv>\r
8636 <refname>draft.mode</refname>\r
8637 <refpurpose>Select draft mode</refpurpose>\r
8638 </refnamediv>\r
8639 \r
8640 <refsynopsisdiv>\r
8641 <programlisting xml:id="draft.mode.frag">\r
8642 &lt;xsl:param name="draft.mode"&gt;maybe&lt;/xsl:param&gt;\r
8643 </programlisting>\r
8644 </refsynopsisdiv>\r
8645 \r
8646 <refsection><info><title>Description</title></info>\r
8647 \r
8648 <para>Selects draft mode. If <parameter>draft.mode</parameter> is\r
8649 <quote><literal>yes</literal></quote>, the entire document will be treated\r
8650 as a draft. If it is <quote><literal>no</literal></quote>, the entire document\r
8651 will be treated as a final copy. If it is <quote><literal>maybe</literal></quote>,\r
8652 individual sections will be treated as draft or final independently, depending\r
8653 on how their <literal>status</literal> attribute is set.\r
8654 </para>\r
8655 \r
8656 </refsection>\r
8657 </refentry>\r
8658 \r
8659 <refentry version="5.0" xml:id="draft.watermark.image">\r
8660 <refmeta>\r
8661 <refentrytitle>draft.watermark.image</refentrytitle>\r
8662 <refmiscinfo class="other" otherclass="datatype">uri</refmiscinfo>\r
8663 </refmeta>\r
8664 <refnamediv>\r
8665 <refname>draft.watermark.image</refname>\r
8666 <refpurpose>The URI of the image to be used for draft watermarks</refpurpose>\r
8667 </refnamediv>\r
8668 \r
8669 <refsynopsisdiv>\r
8670 <programlisting xml:id="draft.watermark.image.frag">\r
8671 &lt;xsl:param name="draft.watermark.image"&gt;http://docbook.sourceforge.net/release/images/draft.png&lt;/xsl:param&gt;\r
8672 </programlisting>\r
8673 </refsynopsisdiv>\r
8674 \r
8675 <refsection><info><title>Description</title></info>\r
8676 \r
8677 <para>The image to be used for draft watermarks.</para>\r
8678 \r
8679 </refsection>\r
8680 </refentry>\r
8681 \r
8682 <refentry version="5.0" xml:id="headers.on.blank.pages">\r
8683 <refmeta>\r
8684 <refentrytitle>headers.on.blank.pages</refentrytitle>\r
8685 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
8686 </refmeta>\r
8687 <refnamediv>\r
8688 <refname>headers.on.blank.pages</refname>\r
8689 <refpurpose>Put headers on blank pages?</refpurpose>\r
8690 </refnamediv>\r
8691 \r
8692 <refsynopsisdiv>\r
8693 <programlisting xml:id="headers.on.blank.pages.frag">\r
8694 &lt;xsl:param name="headers.on.blank.pages" select="1"&gt;&lt;/xsl:param&gt;\r
8695 </programlisting>\r
8696 </refsynopsisdiv>\r
8697 \r
8698 <refsection><info><title>Description</title></info>\r
8699 \r
8700 <para>If non-zero, headers will be placed on blank pages.</para>\r
8701 \r
8702 </refsection>\r
8703 </refentry>\r
8704 \r
8705 <refentry version="5.0" xml:id="footers.on.blank.pages">\r
8706 <refmeta>\r
8707 <refentrytitle>footers.on.blank.pages</refentrytitle>\r
8708 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
8709 </refmeta>\r
8710 <refnamediv>\r
8711 <refname>footers.on.blank.pages</refname>\r
8712 <refpurpose>Put footers on blank pages?</refpurpose>\r
8713 </refnamediv>\r
8714 \r
8715 <refsynopsisdiv>\r
8716 <programlisting xml:id="footers.on.blank.pages.frag">\r
8717 &lt;xsl:param name="footers.on.blank.pages" select="1"&gt;&lt;/xsl:param&gt;\r
8718 </programlisting>\r
8719 </refsynopsisdiv>\r
8720 \r
8721 <refsection><info><title>Description</title></info>\r
8722 \r
8723 <para>If non-zero, footers will be placed on blank pages.</para>\r
8724 \r
8725 </refsection>\r
8726 </refentry>\r
8727 \r
8728 <refentry version="5.0" xml:id="header.rule">\r
8729 <refmeta>\r
8730 <refentrytitle>header.rule</refentrytitle>\r
8731 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
8732 </refmeta>\r
8733 <refnamediv>\r
8734 <refname>header.rule</refname>\r
8735 <refpurpose>Rule under headers?</refpurpose>\r
8736 </refnamediv>\r
8737 \r
8738 <refsynopsisdiv>\r
8739 <programlisting xml:id="header.rule.frag">\r
8740 &lt;xsl:param name="header.rule" select="1"&gt;&lt;/xsl:param&gt;\r
8741 </programlisting>\r
8742 </refsynopsisdiv>\r
8743 \r
8744 <refsection><info><title>Description</title></info>\r
8745 \r
8746 <para>If non-zero, a rule will be drawn below the page headers.</para>\r
8747 \r
8748 </refsection>\r
8749 </refentry>\r
8750 \r
8751 <refentry version="5.0" xml:id="footer.rule">\r
8752 <refmeta>\r
8753 <refentrytitle>footer.rule</refentrytitle>\r
8754 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
8755 </refmeta>\r
8756 <refnamediv>\r
8757 <refname>footer.rule</refname>\r
8758 <refpurpose>Rule over footers?</refpurpose>\r
8759 </refnamediv>\r
8760 \r
8761 <refsynopsisdiv>\r
8762 <programlisting xml:id="footer.rule.frag">\r
8763 &lt;xsl:param name="footer.rule" select="1"&gt;&lt;/xsl:param&gt;\r
8764 </programlisting>\r
8765 </refsynopsisdiv>\r
8766 \r
8767 <refsection><info><title>Description</title></info>\r
8768 \r
8769 <para>If non-zero, a rule will be drawn above the page footers.</para>\r
8770 \r
8771 </refsection>\r
8772 </refentry>\r
8773 \r
8774 <refentry version="5.0" xml:id="header.column.widths">\r
8775 <refmeta>\r
8776 <refentrytitle>header.column.widths</refentrytitle>\r
8777 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
8778 </refmeta>\r
8779 <refnamediv>\r
8780 <refname>header.column.widths</refname>\r
8781 <refpurpose>Specify relative widths of header areas</refpurpose>\r
8782 </refnamediv>\r
8783 \r
8784 <refsynopsisdiv><programlisting xml:id="header.column.widths.frag">\r
8785 &lt;xsl:param name="header.column.widths"&gt;1 1 1&lt;/xsl:param&gt;\r
8786 </programlisting></refsynopsisdiv>\r
8787 \r
8788 <refsection><info><title>Description</title></info>\r
8789 \r
8790 <para>Page headers in print output use a three column table\r
8791 to position text at the left, center, and right side of\r
8792 the header on the page.\r
8793 This parameter lets you specify the relative sizes of the\r
8794 three columns.  The default value is\r
8795 "1 1 1".</para>\r
8796 \r
8797 <para>The parameter value must be three numbers, separated\r
8798 by white space. The first number represents the relative\r
8799 width of the inside header for\r
8800 double-sided output.  The second number is the relative\r
8801 width of the center header.  The third number is the\r
8802 relative width of the outside header for\r
8803 double-sided output.\r
8804 </para>\r
8805 <para>For single-sided output, the first number is the\r
8806 relative width of left header for left-to-right\r
8807 text direction, or the right header for right-to-left\r
8808 text direction.  \r
8809 The third number is the\r
8810 relative width of right header for left-to-right\r
8811 text direction, or the left header for right-to-left\r
8812 text direction.</para>\r
8813 \r
8814 <para>The numbers are used to specify the column widths\r
8815 for the table that makes up the header area.\r
8816 In the FO output, this looks like:\r
8817 </para>\r
8818 \r
8819 <programlisting>\r
8820 &lt;fo:table-column column-number="1" \r
8821     column-width="proportional-column-width(1)"/&gt;\r
8822 </programlisting>\r
8823 \r
8824 <para>\r
8825 The <literal>proportional-column-width()</literal>\r
8826 function computes a column width by dividing its\r
8827 argument by the total of the arguments for all the columns, and\r
8828 then multiplying the result by the width of the whole table\r
8829 (assuming all the column specs use the function).\r
8830 Its argument can be any positive integer or floating point number.\r
8831 Zero is an acceptable value, although some FO processors\r
8832 may warn about it, in which case using a very small number might\r
8833 be more satisfactory.\r
8834 </para>\r
8835 \r
8836 <para>For example, the value "1 2 1" means the center\r
8837 header should have twice the width of the other areas.\r
8838 A value of "0 0 1" means the entire header area\r
8839 is reserved for the right (or outside) header text.\r
8840 Note that to keep the center area centered on\r
8841 the page, the left and right values must be\r
8842 the same. A specification like "1 2 3" means the\r
8843 center area is no longer centered on the page\r
8844 since the right area is three times the width of the left area.\r
8845 </para>\r
8846 \r
8847 </refsection>\r
8848 </refentry>\r
8849 \r
8850 <refentry version="5.0" xml:id="footer.column.widths">\r
8851 <refmeta>\r
8852 <refentrytitle>footer.column.widths</refentrytitle>\r
8853 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
8854 </refmeta>\r
8855 <refnamediv>\r
8856 <refname>footer.column.widths</refname>\r
8857 <refpurpose>Specify relative widths of footer areas</refpurpose>\r
8858 </refnamediv>\r
8859 \r
8860 <refsynopsisdiv><programlisting xml:id="footer.column.widths.frag">\r
8861 &lt;xsl:param name="footer.column.widths"&gt;1 1 1&lt;/xsl:param&gt;\r
8862 </programlisting></refsynopsisdiv>\r
8863 \r
8864 <refsection><info><title>Description</title></info>\r
8865 \r
8866 <para>Page footers in print output use a three column table\r
8867 to position text at the left, center, and right side of\r
8868 the footer on the page.\r
8869 This parameter lets you specify the relative sizes of the\r
8870 three columns.  The default value is\r
8871 "1 1 1".</para>\r
8872 \r
8873 <para>The parameter value must be three numbers, separated\r
8874 by white space. The first number represents the relative\r
8875 width of the inside footer for\r
8876 double-sided output.  The second number is the relative\r
8877 width of the center footer.  The third number is the\r
8878 relative width of the outside footer for\r
8879 double-sided output.\r
8880 </para>\r
8881 <para>For single-sided output, the first number is the\r
8882 relative width of left footer for left-to-right\r
8883 text direction, or the right footer for right-to-left\r
8884 text direction.  \r
8885 The third number is the\r
8886 relative width of right footer for left-to-right\r
8887 text direction, or the left footer for right-to-left\r
8888 text direction.</para>\r
8889 \r
8890 <para>The numbers are used to specify the column widths\r
8891 for the table that makes up the footer area.\r
8892 In the FO output, this looks like:\r
8893 </para>\r
8894 \r
8895 <programlisting>\r
8896 &lt;fo:table-column column-number="1" \r
8897     column-width="proportional-column-width(1)"/&gt;\r
8898 </programlisting>\r
8899 \r
8900 <para>\r
8901 The <literal>proportional-column-width()</literal>\r
8902 function computes a column width by dividing its\r
8903 argument by the total of the arguments for all the columns, and\r
8904 then multiplying the result by the width of the whole table\r
8905 (assuming all the column specs use the function).\r
8906 Its argument can be any positive integer or floating point number.\r
8907 Zero is an acceptable value, although some FO processors\r
8908 may warn about it, in which case using a very small number might\r
8909 be more satisfactory.\r
8910 </para>\r
8911 \r
8912 <para>For example, the value "1 2 1" means the center\r
8913 footer should have twice the width of the other areas.\r
8914 A value of "0 0 1" means the entire footer area\r
8915 is reserved for the right (or outside) footer text.\r
8916 Note that to keep the center area centered on\r
8917 the page, the left and right values must be\r
8918 the same. A specification like "1 2 3" means the\r
8919 center area is no longer centered on the page\r
8920 since the right area is three times the width of the left area.\r
8921 </para>\r
8922 \r
8923 </refsection>\r
8924 </refentry>\r
8925 \r
8926 <refentry version="5.0" xml:id="header.table.properties">\r
8927 <refmeta>\r
8928 <refentrytitle>header.table.properties</refentrytitle>\r
8929 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
8930 </refmeta>\r
8931 <refnamediv>\r
8932 <refname>header.table.properties</refname>\r
8933 <refpurpose>Apply properties to the header layout table</refpurpose>\r
8934 </refnamediv>\r
8935 \r
8936 <refsynopsisdiv>\r
8937 <programlisting xml:id="header.table.properties.frag">\r
8938 &lt;xsl:attribute-set name="header.table.properties"&gt;\r
8939   &lt;xsl:attribute name="table-layout"&gt;fixed&lt;/xsl:attribute&gt;\r
8940   &lt;xsl:attribute name="width"&gt;100%&lt;/xsl:attribute&gt;\r
8941 &lt;/xsl:attribute-set&gt;\r
8942 </programlisting>\r
8943 </refsynopsisdiv>\r
8944 \r
8945 <refsection><info><title>Description</title></info>\r
8946 \r
8947 <para>Properties applied to the table that lays out the page header.</para>\r
8948 \r
8949 </refsection>\r
8950 </refentry>\r
8951 \r
8952 <refentry version="5.0" xml:id="header.table.height">\r
8953 <refmeta>\r
8954 <refentrytitle>header.table.height</refentrytitle>\r
8955 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
8956 </refmeta>\r
8957 <refnamediv>\r
8958 <refname>header.table.height</refname>\r
8959 <refpurpose>Specify the minimum height of the table containing the running page headers</refpurpose>\r
8960 </refnamediv>\r
8961 \r
8962 <refsynopsisdiv><programlisting xml:id="header.table.height.frag">\r
8963 &lt;xsl:param name="header.table.height"&gt;14pt&lt;/xsl:param&gt;\r
8964 </programlisting></refsynopsisdiv>\r
8965 \r
8966 <refsection><info><title>Description</title></info>\r
8967 \r
8968 <para>Page headers in print output use a three column table\r
8969 to position text at the left, center, and right side of\r
8970 the header on the page.\r
8971 This parameter lets you specify the minimum height \r
8972 of the single row in the table.  \r
8973 Since this specifies only the minimum height,\r
8974 the table should automatically grow to fit taller content.\r
8975 The default value is "14pt".</para>\r
8976 \r
8977 </refsection>\r
8978 </refentry>\r
8979 \r
8980 <refentry version="5.0" xml:id="footer.table.properties">\r
8981 <refmeta>\r
8982 <refentrytitle>footer.table.properties</refentrytitle>\r
8983 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
8984 </refmeta>\r
8985 <refnamediv>\r
8986 <refname>footer.table.properties</refname>\r
8987 <refpurpose>Apply properties to the footer layout table</refpurpose>\r
8988 </refnamediv>\r
8989 \r
8990 <refsynopsisdiv>\r
8991 <programlisting xml:id="footer.table.properties.frag">\r
8992 &lt;xsl:attribute-set name="footer.table.properties"&gt;\r
8993   &lt;xsl:attribute name="table-layout"&gt;fixed&lt;/xsl:attribute&gt;\r
8994   &lt;xsl:attribute name="width"&gt;100%&lt;/xsl:attribute&gt;\r
8995 &lt;/xsl:attribute-set&gt;\r
8996 </programlisting>\r
8997 </refsynopsisdiv>\r
8998 \r
8999 <refsection><info><title>Description</title></info>\r
9000 \r
9001 <para>Properties applied to the table that lays out the page footer.</para>\r
9002 \r
9003 </refsection>\r
9004 </refentry>\r
9005 \r
9006 <refentry version="5.0" xml:id="footer.table.height">\r
9007 <refmeta>\r
9008 <refentrytitle>footer.table.height</refentrytitle>\r
9009 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
9010 </refmeta>\r
9011 <refnamediv>\r
9012 <refname>footer.table.height</refname>\r
9013 <refpurpose>Specify the minimum height of the table containing the running page footers</refpurpose>\r
9014 </refnamediv>\r
9015 \r
9016 <refsynopsisdiv><programlisting xml:id="footer.table.height.frag">\r
9017 &lt;xsl:param name="footer.table.height"&gt;14pt&lt;/xsl:param&gt;\r
9018 </programlisting></refsynopsisdiv>\r
9019 \r
9020 <refsection><info><title>Description</title></info>\r
9021 \r
9022 <para>Page footers in print output use a three column table\r
9023 to position text at the left, center, and right side of\r
9024 the footer on the page.\r
9025 This parameter lets you specify the minimum height \r
9026 of the single row in the table.  \r
9027 Since this specifies only the minimum height,\r
9028 the table should automatically grow to fit taller content.\r
9029 The default value is "14pt".</para>\r
9030 \r
9031 </refsection>\r
9032 </refentry>\r
9033 \r
9034 <refentry version="5.0" xml:id="header.content.properties">\r
9035 <refmeta>\r
9036 <refentrytitle>header.content.properties</refentrytitle>\r
9037 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
9038 </refmeta>\r
9039 <refnamediv>\r
9040 <refname>header.content.properties</refname>\r
9041 <refpurpose>Properties of page header content</refpurpose>\r
9042 </refnamediv>\r
9043 \r
9044 <refsynopsisdiv>\r
9045 <programlisting xml:id="header.content.properties.frag">\r
9046 &lt;xsl:attribute-set name="header.content.properties"&gt;\r
9047   &lt;xsl:attribute name="font-family"&gt;\r
9048     &lt;xsl:value-of select="$body.fontset"&gt;&lt;/xsl:value-of&gt;\r
9049   &lt;/xsl:attribute&gt;\r
9050   &lt;xsl:attribute name="margin-left"&gt;\r
9051     &lt;xsl:value-of select="$title.margin.left"&gt;&lt;/xsl:value-of&gt;\r
9052   &lt;/xsl:attribute&gt;\r
9053 &lt;/xsl:attribute-set&gt;\r
9054 </programlisting>\r
9055 </refsynopsisdiv>\r
9056 \r
9057 <refsection><info><title>Description</title></info>\r
9058 \r
9059 <para>Properties of page header content.</para>\r
9060 \r
9061 </refsection>\r
9062 </refentry>\r
9063 \r
9064 <refentry version="5.0" xml:id="footer.content.properties">\r
9065 <refmeta>\r
9066 <refentrytitle>footer.content.properties</refentrytitle>\r
9067 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
9068 </refmeta>\r
9069 <refnamediv>\r
9070 <refname>footer.content.properties</refname>\r
9071 <refpurpose>Properties of page footer content</refpurpose>\r
9072 </refnamediv>\r
9073 \r
9074 <refsynopsisdiv>\r
9075 <programlisting xml:id="footer.content.properties.frag">\r
9076 &lt;xsl:attribute-set name="footer.content.properties"&gt;\r
9077   &lt;xsl:attribute name="font-family"&gt;\r
9078     &lt;xsl:value-of select="$body.fontset"&gt;&lt;/xsl:value-of&gt;\r
9079   &lt;/xsl:attribute&gt;\r
9080   &lt;xsl:attribute name="margin-left"&gt;\r
9081     &lt;xsl:value-of select="$title.margin.left"&gt;&lt;/xsl:value-of&gt;\r
9082   &lt;/xsl:attribute&gt;\r
9083 &lt;/xsl:attribute-set&gt;\r
9084 </programlisting>\r
9085 </refsynopsisdiv>\r
9086 \r
9087 <refsection><info><title>Description</title></info>\r
9088 \r
9089 <para>Properties of page footer content.</para>\r
9090 \r
9091 </refsection>\r
9092 </refentry>\r
9093 \r
9094 <refentry version="5.0" xml:id="marker.section.level">\r
9095 <refmeta>\r
9096 <refentrytitle>marker.section.level</refentrytitle>\r
9097 <refmiscinfo class="other" otherclass="datatype">integer</refmiscinfo>\r
9098 </refmeta>\r
9099 <refnamediv>\r
9100 <refname>marker.section.level</refname>\r
9101 <refpurpose>Control depth of sections shown in running headers or footers</refpurpose>\r
9102 </refnamediv>\r
9103 \r
9104 <refsynopsisdiv>\r
9105 <programlisting xml:id="marker.section.level.frag">\r
9106 &lt;xsl:param name="marker.section.level"&gt;2&lt;/xsl:param&gt;\r
9107 </programlisting>\r
9108 </refsynopsisdiv>\r
9109 \r
9110 <refsection><info><title>Description</title></info>\r
9111 \r
9112 <para>The <parameter>marker.section.level</parameter> parameter\r
9113 controls the depth of section levels that may be displayed\r
9114 in running headers and footers.  For example, if the value\r
9115 is 2 (the default), then titles from <tag>sect1</tag> and \r
9116 <tag>sect2</tag> or equivalent <tag>section</tag>\r
9117 elements are candidates for use in running headers and\r
9118 footers.\r
9119 </para>\r
9120 <para>Each candidate title is marked in the FO output with a\r
9121 <tag>&lt;fo:marker marker-class-name="section.head.marker"&gt;</tag>\r
9122 element.\r
9123 </para>\r
9124 <para>In order for such titles to appear in headers\r
9125 or footers, the <literal>header.content</literal>\r
9126 or <literal>footer.content</literal> template\r
9127 must be customized to retrieve the marker using\r
9128 an output element such as:\r
9129 </para>\r
9130 <programlisting>\r
9131 &lt;fo:retrieve-marker retrieve-class-name="section.head.marker"\r
9132                        retrieve-position="first-including-carryover"\r
9133                        retrieve-boundary="page-sequence"/&gt;\r
9134 </programlisting>\r
9135 \r
9136 \r
9137 </refsection>\r
9138 </refentry>\r
9139 \r
9140 </reference>\r
9141 <reference xml:id="fonts"><title>Font Families</title>\r
9142 <refentry version="5.0" xml:id="body.font.family">\r
9143 <refmeta>\r
9144 <refentrytitle>body.font.family</refentrytitle>\r
9145 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>\r
9146 <refmiscinfo class="other" otherclass="list-type">open</refmiscinfo>\r
9147 <refmiscinfo class="other" otherclass="value">serif</refmiscinfo>\r
9148 <refmiscinfo class="other" otherclass="value">sans-serif</refmiscinfo>\r
9149 <refmiscinfo class="other" otherclass="value">monospace</refmiscinfo>\r
9150 </refmeta>\r
9151 <refnamediv>\r
9152 <refname>body.font.family</refname>\r
9153 <refpurpose>The default font family for body text</refpurpose>\r
9154 </refnamediv>\r
9155 \r
9156 <refsynopsisdiv>\r
9157 <programlisting xml:id="body.font.family.frag">\r
9158 &lt;xsl:param name="body.font.family"&gt;serif&lt;/xsl:param&gt;\r
9159 </programlisting>\r
9160 </refsynopsisdiv>\r
9161 \r
9162 <refsection><info><title>Description</title></info>\r
9163 \r
9164 <para>The body font family is the default font used for text in the page body.\r
9165 </para>\r
9166 \r
9167 </refsection>\r
9168 </refentry>\r
9169 \r
9170 <refentry version="5.0" xml:id="dingbat.font.family">\r
9171 <refmeta>\r
9172 <refentrytitle>dingbat.font.family</refentrytitle>\r
9173 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>\r
9174 <refmiscinfo class="other" otherclass="list-type">open</refmiscinfo>\r
9175 <refmiscinfo class="other" otherclass="value">serif</refmiscinfo>\r
9176 <refmiscinfo class="other" otherclass="value">sans-serif</refmiscinfo>\r
9177 <refmiscinfo class="other" otherclass="value">monospace</refmiscinfo>\r
9178 </refmeta>\r
9179 <refnamediv>\r
9180 <refname>dingbat.font.family</refname>\r
9181 <refpurpose>The font family for copyright, quotes, and other symbols</refpurpose>\r
9182 </refnamediv>\r
9183 \r
9184 <refsynopsisdiv>\r
9185 <programlisting xml:id="dingbat.font.family.frag">\r
9186 &lt;xsl:param name="dingbat.font.family"&gt;serif&lt;/xsl:param&gt;\r
9187 </programlisting>\r
9188 </refsynopsisdiv>\r
9189 \r
9190 <refsection><info><title>Description</title></info>\r
9191 \r
9192 <para>The dingbat font family is used for dingbats. If it is defined\r
9193 as the empty string, no font change is effected around dingbats.\r
9194 </para>\r
9195 \r
9196 </refsection>\r
9197 </refentry>\r
9198 \r
9199 <refentry version="5.0" xml:id="monospace.font.family">\r
9200 <refmeta>\r
9201 <refentrytitle>monospace.font.family</refentrytitle>\r
9202 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
9203 </refmeta>\r
9204 <refnamediv>\r
9205 <refname>monospace.font.family</refname>\r
9206 <refpurpose>The default font family for monospace environments</refpurpose>\r
9207 </refnamediv>\r
9208 \r
9209 <refsynopsisdiv>\r
9210 <programlisting xml:id="monospace.font.family.frag">\r
9211 &lt;xsl:param name="monospace.font.family"&gt;monospace&lt;/xsl:param&gt;\r
9212 </programlisting>\r
9213 </refsynopsisdiv>\r
9214 \r
9215 <refsection><info><title>Description</title></info>\r
9216 \r
9217 <para>The monospace font family is used for verbatim environments\r
9218 (program listings, screens, etc.).\r
9219 </para>\r
9220 \r
9221 </refsection>\r
9222 </refentry>\r
9223 \r
9224 <refentry version="5.0" xml:id="sans.font.family">\r
9225 <refmeta>\r
9226 <refentrytitle>sans.font.family</refentrytitle>\r
9227 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
9228 </refmeta>\r
9229 <refnamediv>\r
9230 <refname>sans.font.family</refname>\r
9231 <refpurpose>The default sans-serif font family</refpurpose>\r
9232 </refnamediv>\r
9233 \r
9234 <refsynopsisdiv>\r
9235 <programlisting xml:id="sans.font.family.frag">\r
9236 &lt;xsl:param name="sans.font.family"&gt;sans-serif&lt;/xsl:param&gt;\r
9237 </programlisting>\r
9238 </refsynopsisdiv>\r
9239 \r
9240 <refsection><info><title>Description</title></info>\r
9241 \r
9242 <para>The default sans-serif font family. At the present, this isn't\r
9243 actually used by the stylesheets.\r
9244 </para>\r
9245 \r
9246 </refsection>\r
9247 </refentry>\r
9248 \r
9249 <refentry version="5.0" xml:id="title.font.family">\r
9250 <refmeta>\r
9251 <refentrytitle>title.font.family</refentrytitle>\r
9252 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>\r
9253 <refmiscinfo class="other" otherclass="list-type">open</refmiscinfo>\r
9254 <refmiscinfo class="other" otherclass="value">serif</refmiscinfo>\r
9255 <refmiscinfo class="other" otherclass="value">sans-serif</refmiscinfo>\r
9256 <refmiscinfo class="other" otherclass="value">monospace</refmiscinfo>\r
9257 </refmeta>\r
9258 <refnamediv>\r
9259 <refname>title.font.family</refname>\r
9260 <refpurpose>The default font family for titles</refpurpose>\r
9261 </refnamediv>\r
9262 \r
9263 <refsynopsisdiv>\r
9264 <programlisting xml:id="title.font.family.frag">\r
9265 &lt;xsl:param name="title.font.family"&gt;sans-serif&lt;/xsl:param&gt;\r
9266 </programlisting>\r
9267 </refsynopsisdiv>\r
9268 \r
9269 <refsection><info><title>Description</title></info>\r
9270 \r
9271 <para>The title font family is used for titles (chapter, section, figure,\r
9272 etc.)\r
9273 </para>\r
9274 \r
9275 </refsection>\r
9276 </refentry>\r
9277 \r
9278 <refentry version="5.0" xml:id="symbol.font.family">\r
9279 <refmeta>\r
9280 <refentrytitle>symbol.font.family</refentrytitle>\r
9281 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>\r
9282 <refmiscinfo class="other" otherclass="list-type">open</refmiscinfo>\r
9283 <refmiscinfo class="other" otherclass="value">serif</refmiscinfo>\r
9284 <refmiscinfo class="other" otherclass="value">sans-serif</refmiscinfo>\r
9285 <refmiscinfo class="other" otherclass="value">monospace</refmiscinfo>\r
9286 </refmeta>\r
9287 <refnamediv>\r
9288 <refname>symbol.font.family</refname>\r
9289 <refpurpose>The font families to be searched for symbols outside\r
9290     of the body font</refpurpose>\r
9291 </refnamediv>\r
9292 \r
9293 <refsynopsisdiv>\r
9294 <programlisting xml:id="symbol.font.family.frag">\r
9295 &lt;xsl:param name="symbol.font.family"&gt;Symbol,ZapfDingbats&lt;/xsl:param&gt;\r
9296 </programlisting>\r
9297 </refsynopsisdiv>\r
9298 \r
9299 <refsection><info><title>Description</title></info>\r
9300 \r
9301 <para>A typical body or title font does not contain all\r
9302 the character glyphs that DocBook supports.  This parameter\r
9303 specifies additional fonts that should be searched for\r
9304 special characters not in the normal font.\r
9305 These symbol font names are automatically appended\r
9306 to the body or title font family name when fonts\r
9307 are specified in a \r
9308 <tag class="attribute">font-family</tag>\r
9309 property in the FO output.\r
9310 </para>\r
9311 <para>The symbol font names should be entered as a\r
9312 comma-separated list.  The default value is\r
9313 <literal>Symbol,ZapfDingbats</literal>.\r
9314 </para>\r
9315 \r
9316 </refsection>\r
9317 </refentry>\r
9318 \r
9319 </reference>\r
9320 <reference xml:id="propsets"><title>Property Sets</title>\r
9321 <refentry version="5.0" xml:id="formal.object.properties">\r
9322 <refmeta>\r
9323 <refentrytitle>formal.object.properties</refentrytitle>\r
9324 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
9325 </refmeta>\r
9326 <refnamediv>\r
9327 <refname>formal.object.properties</refname>\r
9328 <refpurpose>Properties associated with a formal object such as a figure, or other component that has a title</refpurpose>\r
9329 </refnamediv>\r
9330 \r
9331 <refsynopsisdiv>\r
9332 <programlisting xml:id="formal.object.properties.frag">\r
9333 &lt;xsl:attribute-set name="formal.object.properties"&gt;\r
9334   &lt;xsl:attribute name="space-before.minimum"&gt;0.5em&lt;/xsl:attribute&gt;\r
9335   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;\r
9336   &lt;xsl:attribute name="space-before.maximum"&gt;2em&lt;/xsl:attribute&gt;\r
9337   &lt;xsl:attribute name="space-after.minimum"&gt;0.5em&lt;/xsl:attribute&gt;\r
9338   &lt;xsl:attribute name="space-after.optimum"&gt;1em&lt;/xsl:attribute&gt;\r
9339   &lt;xsl:attribute name="space-after.maximum"&gt;2em&lt;/xsl:attribute&gt;\r
9340   &lt;xsl:attribute name="keep-together.within-column"&gt;always&lt;/xsl:attribute&gt;\r
9341 &lt;/xsl:attribute-set&gt;\r
9342 </programlisting>\r
9343 </refsynopsisdiv>\r
9344 \r
9345 <refsection><info><title>Description</title></info>\r
9346 \r
9347 <para>The styling for formal objects in docbook. Specify the spacing\r
9348 before and after the object.</para>\r
9349 \r
9350 </refsection>\r
9351 </refentry>\r
9352 \r
9353 <refentry version="5.0" xml:id="formal.title.properties">\r
9354 <refmeta>\r
9355 <refentrytitle>formal.title.properties</refentrytitle>\r
9356 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
9357 </refmeta>\r
9358 <refnamediv>\r
9359 <refname>formal.title.properties</refname>\r
9360 <refpurpose>Style the title element of formal object such as a figure.</refpurpose>\r
9361 </refnamediv>\r
9362 \r
9363 <refsynopsisdiv>\r
9364 <programlisting xml:id="formal.title.properties.frag">\r
9365 &lt;xsl:attribute-set name="formal.title.properties" use-attribute-sets="normal.para.spacing"&gt;\r
9366   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;\r
9367   &lt;xsl:attribute name="font-size"&gt;\r
9368     &lt;xsl:value-of select="$body.font.master * 1.2"&gt;&lt;/xsl:value-of&gt;\r
9369     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;\r
9370   &lt;/xsl:attribute&gt;\r
9371   &lt;xsl:attribute name="hyphenate"&gt;false&lt;/xsl:attribute&gt;\r
9372   &lt;xsl:attribute name="space-after.minimum"&gt;0.4em&lt;/xsl:attribute&gt;\r
9373   &lt;xsl:attribute name="space-after.optimum"&gt;0.6em&lt;/xsl:attribute&gt;\r
9374   &lt;xsl:attribute name="space-after.maximum"&gt;0.8em&lt;/xsl:attribute&gt;\r
9375 &lt;/xsl:attribute-set&gt;\r
9376 </programlisting>\r
9377 </refsynopsisdiv>\r
9378 <refsection><info><title>Description</title></info>\r
9379 <para>Specify how the title should be styled. Specify the font size and weight of the title of the formal object.</para>\r
9380 </refsection>\r
9381 </refentry>\r
9382 \r
9383 <refentry version="5.0" xml:id="informal.object.properties">\r
9384 <refmeta>\r
9385 <refentrytitle>informal.object.properties</refentrytitle>\r
9386 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
9387 </refmeta>\r
9388 <refnamediv>\r
9389 <refname>informal.object.properties</refname>\r
9390 <refpurpose>Properties associated with an informal (untitled) object, such as an informalfigure</refpurpose>\r
9391 </refnamediv>\r
9392 \r
9393 <refsynopsisdiv>\r
9394 <programlisting xml:id="informal.object.properties.frag">&lt;xsl:attribute-set name="informal.object.properties"&gt;\r
9395   &lt;xsl:attribute name="space-before.minimum"&gt;0.5em&lt;/xsl:attribute&gt;\r
9396   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;\r
9397   &lt;xsl:attribute name="space-before.maximum"&gt;2em&lt;/xsl:attribute&gt;\r
9398   &lt;xsl:attribute name="space-after.minimum"&gt;0.5em&lt;/xsl:attribute&gt;\r
9399   &lt;xsl:attribute name="space-after.optimum"&gt;1em&lt;/xsl:attribute&gt;\r
9400   &lt;xsl:attribute name="space-after.maximum"&gt;2em&lt;/xsl:attribute&gt;\r
9401 &lt;/xsl:attribute-set&gt;</programlisting>\r
9402 </refsynopsisdiv>\r
9403 <refsection><info><title>Description</title></info>\r
9404 <para>The styling for informal objects in docbook. Specify the spacing before and after the object.</para>\r
9405 </refsection>\r
9406 </refentry>\r
9407 \r
9408 <refentry version="5.0" xml:id="monospace.properties">\r
9409 <refmeta>\r
9410 <refentrytitle>monospace.properties</refentrytitle>\r
9411 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
9412 </refmeta>\r
9413 <refnamediv>\r
9414 <refname>monospace.properties</refname>\r
9415 <refpurpose>Properties of monospaced content</refpurpose>\r
9416 </refnamediv>\r
9417 \r
9418 <refsynopsisdiv>\r
9419 <programlisting xml:id="monospace.properties.frag">\r
9420 &lt;xsl:attribute-set name="monospace.properties"&gt;\r
9421   &lt;xsl:attribute name="font-family"&gt;\r
9422     &lt;xsl:value-of select="$monospace.font.family"&gt;&lt;/xsl:value-of&gt;\r
9423   &lt;/xsl:attribute&gt;\r
9424 &lt;/xsl:attribute-set&gt;\r
9425 </programlisting>\r
9426 </refsynopsisdiv>\r
9427 \r
9428 <refsection><info><title>Description</title></info>\r
9429 \r
9430 <para>Specifies the font name for monospaced output. This property set\r
9431 used to set the font-size as well, but that doesn't work very well\r
9432 when different fonts are used (as they are in titles and paragraphs,\r
9433 for example).</para>\r
9434 \r
9435 <para>If you want to set the font-size in a customization layer, it's\r
9436 probably going to be more appropriate to set font-size-adjust, if your\r
9437 formatter supports it.</para>\r
9438 \r
9439 </refsection>\r
9440 </refentry>\r
9441 \r
9442 <refentry version="5.0" xml:id="verbatim.properties">\r
9443 <refmeta>\r
9444 <refentrytitle>verbatim.properties</refentrytitle>\r
9445 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
9446 </refmeta>\r
9447 <refnamediv>\r
9448 <refname>verbatim.properties</refname>\r
9449 <refpurpose>Properties associated with verbatim text</refpurpose>\r
9450 </refnamediv>\r
9451 \r
9452 <refsynopsisdiv>\r
9453 <programlisting xml:id="verbatim.properties.frag">\r
9454 &lt;xsl:attribute-set name="verbatim.properties"&gt;\r
9455   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;\r
9456   &lt;xsl:attribute name="space-before.optimum"&gt;1em&lt;/xsl:attribute&gt;\r
9457   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;\r
9458   &lt;xsl:attribute name="space-after.minimum"&gt;0.8em&lt;/xsl:attribute&gt;\r
9459   &lt;xsl:attribute name="space-after.optimum"&gt;1em&lt;/xsl:attribute&gt;\r
9460   &lt;xsl:attribute name="space-after.maximum"&gt;1.2em&lt;/xsl:attribute&gt;\r
9461   &lt;xsl:attribute name="hyphenate"&gt;false&lt;/xsl:attribute&gt;\r
9462   &lt;xsl:attribute name="wrap-option"&gt;no-wrap&lt;/xsl:attribute&gt;\r
9463   &lt;xsl:attribute name="white-space-collapse"&gt;false&lt;/xsl:attribute&gt;\r
9464   &lt;xsl:attribute name="white-space-treatment"&gt;preserve&lt;/xsl:attribute&gt;\r
9465   &lt;xsl:attribute name="linefeed-treatment"&gt;preserve&lt;/xsl:attribute&gt;\r
9466   &lt;xsl:attribute name="text-align"&gt;start&lt;/xsl:attribute&gt;\r
9467 &lt;/xsl:attribute-set&gt;</programlisting>\r
9468 </refsynopsisdiv>\r
9469 \r
9470 <refsection><info><title>Description</title></info>\r
9471 <para>This attribute set is used on all verbatim environments.</para>\r
9472 </refsection>\r
9473 \r
9474 </refentry>\r
9475 \r
9476 <refentry version="5.0" xml:id="monospace.verbatim.properties">\r
9477 <refmeta>\r
9478 <refentrytitle>monospace.verbatim.properties</refentrytitle>\r
9479 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
9480 </refmeta>\r
9481 <refnamediv>\r
9482 <refname>monospace.verbatim.properties</refname>\r
9483 <refpurpose>What font and size do you want for monospaced content?</refpurpose>\r
9484 </refnamediv>\r
9485 \r
9486 <refsynopsisdiv>\r
9487 <programlisting xml:id="monospace.verbatim.properties.frag">\r
9488 &lt;xsl:attribute-set name="monospace.verbatim.properties" use-attribute-sets="verbatim.properties monospace.properties"&gt;\r
9489   &lt;xsl:attribute name="text-align"&gt;start&lt;/xsl:attribute&gt;\r
9490   &lt;xsl:attribute name="wrap-option"&gt;no-wrap&lt;/xsl:attribute&gt;\r
9491 &lt;/xsl:attribute-set&gt;\r
9492 </programlisting>\r
9493 </refsynopsisdiv>\r
9494 <refsection><info><title>Description</title></info>\r
9495 <para>Specify the font name and size you want for monospaced output</para>\r
9496 </refsection>\r
9497 </refentry>\r
9498 \r
9499 <refentry version="5.0" xml:id="sidebar.properties">\r
9500 <refmeta>\r
9501 <refentrytitle>sidebar.properties</refentrytitle>\r
9502 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
9503 </refmeta>\r
9504 <refnamediv>\r
9505 <refname>sidebar.properties</refname>\r
9506 <refpurpose>Attribute set for sidebar properties</refpurpose>\r
9507 </refnamediv>\r
9508 \r
9509 <refsynopsisdiv>\r
9510 <programlisting xml:id="sidebar.properties.frag">\r
9511 &lt;xsl:attribute-set name="sidebar.properties" use-attribute-sets="formal.object.properties"&gt;\r
9512   &lt;xsl:attribute name="border-style"&gt;solid&lt;/xsl:attribute&gt;\r
9513   &lt;xsl:attribute name="border-width"&gt;1pt&lt;/xsl:attribute&gt;\r
9514   &lt;xsl:attribute name="border-color"&gt;black&lt;/xsl:attribute&gt;\r
9515   &lt;xsl:attribute name="background-color"&gt;#DDDDDD&lt;/xsl:attribute&gt;\r
9516   &lt;xsl:attribute name="padding-start"&gt;12pt&lt;/xsl:attribute&gt;\r
9517   &lt;xsl:attribute name="padding-end"&gt;12pt&lt;/xsl:attribute&gt;\r
9518   &lt;xsl:attribute name="padding-top"&gt;6pt&lt;/xsl:attribute&gt;\r
9519   &lt;xsl:attribute name="padding-bottom"&gt;6pt&lt;/xsl:attribute&gt;\r
9520   &lt;xsl:attribute name="margin-{$direction.align.start}"&gt;0pt&lt;/xsl:attribute&gt;\r
9521   &lt;xsl:attribute name="margin-{$direction.align.end}"&gt;0pt&lt;/xsl:attribute&gt;\r
9522 &lt;!--\r
9523   &lt;xsl:attribute name="margin-top"&gt;6pt&lt;/xsl:attribute&gt;\r
9524   &lt;xsl:attribute name="margin-bottom"&gt;6pt&lt;/xsl:attribute&gt;\r
9525 --&gt;\r
9526 &lt;/xsl:attribute-set&gt;\r
9527 </programlisting>\r
9528 </refsynopsisdiv>\r
9529 \r
9530 <refsection><info><title>Description</title></info>\r
9531 \r
9532 <para>The styling for sidebars.</para>\r
9533 \r
9534 </refsection>\r
9535 </refentry>\r
9536 \r
9537 <refentry version="5.0" xml:id="sidebar.title.properties">\r
9538 <refmeta>\r
9539 <refentrytitle>sidebar.title.properties</refentrytitle>\r
9540 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
9541 </refmeta>\r
9542 <refnamediv>\r
9543 <refname>sidebar.title.properties</refname>\r
9544 <refpurpose>Attribute set for sidebar titles</refpurpose>\r
9545 </refnamediv>\r
9546 \r
9547 <refsynopsisdiv>\r
9548 <programlisting xml:id="sidebar.title.properties.frag">\r
9549 &lt;xsl:attribute-set name="sidebar.title.properties"&gt;\r
9550   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;\r
9551   &lt;xsl:attribute name="hyphenate"&gt;false&lt;/xsl:attribute&gt;\r
9552   &lt;xsl:attribute name="text-align"&gt;start&lt;/xsl:attribute&gt;\r
9553   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;\r
9554 &lt;/xsl:attribute-set&gt;\r
9555 </programlisting>\r
9556 </refsynopsisdiv>\r
9557 \r
9558 <refsection><info><title>Description</title></info>\r
9559 \r
9560 <para>The styling for sidebars titles.</para>\r
9561 \r
9562 </refsection>\r
9563 </refentry>\r
9564 \r
9565 <refentry version="5.0" xml:id="sidebar.float.type">\r
9566 <refmeta>\r
9567 <refentrytitle>sidebar.float.type</refentrytitle>\r
9568 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>\r
9569 <refmiscinfo class="other" otherclass="value">none</refmiscinfo>\r
9570 <refmiscinfo class="other" otherclass="value">before</refmiscinfo>\r
9571 <refmiscinfo class="other" otherclass="value">left</refmiscinfo>\r
9572 <refmiscinfo class="other" otherclass="value">start</refmiscinfo> \r
9573 <refmiscinfo class="other" otherclass="value">right</refmiscinfo>\r
9574 <refmiscinfo class="other" otherclass="value">end</refmiscinfo>     \r
9575 <refmiscinfo class="other" otherclass="value">inside</refmiscinfo>\r
9576 <refmiscinfo class="other" otherclass="value">outside</refmiscinfo> \r
9577 </refmeta>\r
9578 <refnamediv>\r
9579 <refname>sidebar.float.type</refname>\r
9580 <refpurpose>Select type of float for sidebar elements</refpurpose>\r
9581 </refnamediv>\r
9582 \r
9583 <refsynopsisdiv>\r
9584 <programlisting xml:id="sidebar.float.type.frag">\r
9585 &lt;xsl:param name="sidebar.float.type"&gt;none&lt;/xsl:param&gt;\r
9586 </programlisting>\r
9587 </refsynopsisdiv>\r
9588 \r
9589 <refsection><info><title>Description</title></info>\r
9590 \r
9591 <para>Selects the type of float for sidebar elements.\r
9592 </para>\r
9593 <itemizedlist>\r
9594 <listitem>\r
9595 <para>If <parameter>sidebar.float.type</parameter> is\r
9596 <quote><literal>none</literal></quote>, then \r
9597 no float is used.\r
9598 </para>\r
9599 </listitem>\r
9600 <listitem>\r
9601 <para>If <parameter>sidebar.float.type</parameter> is\r
9602 <quote><literal>before</literal></quote>, then \r
9603 the float appears at the top of the page.  On some processors,\r
9604 that may be the next page rather than the current page.\r
9605 </para>\r
9606 </listitem>\r
9607 \r
9608 <listitem>\r
9609 <para>If <parameter>sidebar.float.type</parameter> is\r
9610 <quote><literal>left</literal></quote>,\r
9611 then a left side float is used.\r
9612 </para>\r
9613 </listitem>\r
9614 \r
9615 <listitem>\r
9616 <para>If <parameter>sidebar.float.type</parameter> is\r
9617 <quote><literal>start</literal></quote>,\r
9618 then when the text direction is left-to-right a left side float is used.\r
9619 When the text direction is right-to-left, a right side float is used.\r
9620 </para>\r
9621 </listitem>\r
9622 \r
9623 <listitem>\r
9624 <para>If <parameter>sidebar.float.type</parameter> is\r
9625 <quote><literal>right</literal></quote>,\r
9626 then a right side float is used.\r
9627 </para>\r
9628 </listitem>\r
9629 \r
9630 <listitem>\r
9631 <para>If <parameter>sidebar.float.type</parameter> is\r
9632 <quote><literal>end</literal></quote>,\r
9633 then when the text direction is left-to-right a right side float is used.\r
9634 When the text direction is right-to-left, a left side float is used.\r
9635 </para>\r
9636 </listitem>\r
9637 \r
9638 <listitem>\r
9639 <para>If your XSL-FO processor supports floats positioned on the\r
9640 <quote><literal>inside</literal></quote> or\r
9641 <quote><literal>outside</literal></quote>\r
9642 of double-sided pages, then you have those two \r
9643 options for side floats as well.\r
9644 </para>\r
9645 </listitem>\r
9646 </itemizedlist>\r
9647 \r
9648 </refsection>\r
9649 </refentry>\r
9650 \r
9651 <refentry version="5.0" xml:id="sidebar.float.width">\r
9652 <refmeta>\r
9653 <refentrytitle>sidebar.float.width</refentrytitle>\r
9654 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
9655 </refmeta>\r
9656 <refnamediv>\r
9657 <refname>sidebar.float.width</refname>\r
9658 <refpurpose>Set the default width for sidebars</refpurpose>\r
9659 </refnamediv>\r
9660 \r
9661 <refsynopsisdiv>\r
9662 <programlisting xml:id="sidebar.float.width.frag">\r
9663 &lt;xsl:param name="sidebar.float.width"&gt;1in&lt;/xsl:param&gt;\r
9664 </programlisting>\r
9665 </refsynopsisdiv>\r
9666 \r
9667 <refsection><info><title>Description</title></info>\r
9668 \r
9669 <para>Sets the default width for sidebars when used as a side float.\r
9670 The width determines the degree to which the sidebar block intrudes into\r
9671 the text area.\r
9672 </para>\r
9673 <para>If <parameter>sidebar.float.type</parameter> is\r
9674 <quote><literal>before</literal></quote> or \r
9675 <quote><literal>none</literal></quote>, then \r
9676 this parameter is ignored.\r
9677 </para>\r
9678 \r
9679 </refsection>\r
9680 </refentry>\r
9681 \r
9682 <refentry version="5.0" xml:id="margin.note.properties">\r
9683 <refmeta>\r
9684 <refentrytitle>margin.note.properties</refentrytitle>\r
9685 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
9686 </refmeta>\r
9687 <refnamediv>\r
9688 <refname>margin.note.properties</refname>\r
9689 <refpurpose>Attribute set for margin.note properties</refpurpose>\r
9690 </refnamediv>\r
9691 \r
9692 <refsynopsisdiv>\r
9693 <programlisting xml:id="margin.note.properties.frag">\r
9694 &lt;xsl:attribute-set name="margin.note.properties"&gt;\r
9695   &lt;xsl:attribute name="font-size"&gt;90%&lt;/xsl:attribute&gt;\r
9696   &lt;xsl:attribute name="text-align"&gt;start&lt;/xsl:attribute&gt;\r
9697 &lt;/xsl:attribute-set&gt;\r
9698 </programlisting>\r
9699 </refsynopsisdiv>\r
9700 \r
9701 <refsection><info><title>Description</title></info>\r
9702 \r
9703 <para>The styling for margin notes.\r
9704 By default, margin notes are not implemented for any\r
9705 element. A stylesheet customization is needed to make\r
9706 use of this attribute-set.</para>\r
9707 \r
9708 <para>You can use a template named <quote>floater</quote>\r
9709 to create the customization.\r
9710 That template can create side floats by specifying the\r
9711 content and characteristics as template parameters.\r
9712 </para>\r
9713 \r
9714 <para>For example:</para>\r
9715 <programlisting>&lt;xsl:template match="para[@role='marginnote']"&gt;\r
9716   &lt;xsl:call-template name="floater"&gt;\r
9717     &lt;xsl:with-param name="position"&gt;\r
9718       &lt;xsl:value-of select="$margin.note.float.type"/&gt;\r
9719     &lt;/xsl:with-param&gt;\r
9720     &lt;xsl:with-param name="width"&gt;\r
9721       &lt;xsl:value-of select="$margin.note.width"/&gt;\r
9722     &lt;/xsl:with-param&gt;\r
9723     &lt;xsl:with-param name="content"&gt;\r
9724       &lt;xsl:apply-imports/&gt;\r
9725     &lt;/xsl:with-param&gt;\r
9726   &lt;/xsl:call-template&gt;\r
9727 &lt;/xsl:template&gt;</programlisting>\r
9728 \r
9729 </refsection>\r
9730 </refentry>\r
9731 \r
9732 <refentry version="5.0" xml:id="margin.note.title.properties">\r
9733 <refmeta>\r
9734 <refentrytitle>margin.note.title.properties</refentrytitle>\r
9735 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
9736 </refmeta>\r
9737 <refnamediv>\r
9738 <refname>margin.note.title.properties</refname>\r
9739 <refpurpose>Attribute set for margin note titles</refpurpose>\r
9740 </refnamediv>\r
9741 \r
9742 <refsynopsisdiv>\r
9743 <programlisting xml:id="margin.note.title.properties.frag">\r
9744 &lt;xsl:attribute-set name="margin.note.title.properties"&gt;\r
9745   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;\r
9746   &lt;xsl:attribute name="hyphenate"&gt;false&lt;/xsl:attribute&gt;\r
9747   &lt;xsl:attribute name="text-align"&gt;start&lt;/xsl:attribute&gt;\r
9748   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;\r
9749 &lt;/xsl:attribute-set&gt;\r
9750 </programlisting>\r
9751 </refsynopsisdiv>\r
9752 \r
9753 <refsection><info><title>Description</title></info>\r
9754 \r
9755 <para>The styling for margin note titles.</para>\r
9756 \r
9757 </refsection>\r
9758 </refentry>\r
9759 \r
9760 <refentry version="5.0" xml:id="margin.note.float.type">\r
9761 <refmeta>\r
9762 <refentrytitle>margin.note.float.type</refentrytitle>\r
9763 <refmiscinfo class="other" otherclass="datatype">list</refmiscinfo>\r
9764 <refmiscinfo class="other" otherclass="value">none</refmiscinfo>\r
9765 <refmiscinfo class="other" otherclass="value">before</refmiscinfo>\r
9766 <refmiscinfo class="other" otherclass="value">left</refmiscinfo>\r
9767 <refmiscinfo class="other" otherclass="value">start</refmiscinfo> \r
9768 <refmiscinfo class="other" otherclass="value">right</refmiscinfo>\r
9769 <refmiscinfo class="other" otherclass="value">end</refmiscinfo>     \r
9770 <refmiscinfo class="other" otherclass="value">inside</refmiscinfo>\r
9771 <refmiscinfo class="other" otherclass="value">outside</refmiscinfo> \r
9772 </refmeta>\r
9773 <refnamediv>\r
9774 <refname>margin.note.float.type</refname>\r
9775 <refpurpose>Select type of float for margin note customizations</refpurpose>\r
9776 </refnamediv>\r
9777 \r
9778 <refsynopsisdiv>\r
9779 <programlisting xml:id="margin.note.float.type.frag">\r
9780 &lt;xsl:param name="margin.note.float.type"&gt;none&lt;/xsl:param&gt;\r
9781 </programlisting>\r
9782 </refsynopsisdiv>\r
9783 \r
9784 <refsection><info><title>Description</title></info>\r
9785 \r
9786 <para>Selects the type of float for margin notes.\r
9787 DocBook does not define a margin note element, so this\r
9788 feature must be implemented as a customization of the stylesheet.\r
9789 See <parameter>margin.note.properties</parameter> for\r
9790 an example.\r
9791 </para>\r
9792 <itemizedlist>\r
9793 <listitem>\r
9794 <para>If <parameter>margin.note.float.type</parameter> is\r
9795 <quote><literal>none</literal></quote>, then \r
9796 no float is used.\r
9797 </para>\r
9798 </listitem>\r
9799 <listitem>\r
9800 <para>If <parameter>margin.note.float.type</parameter> is\r
9801 <quote><literal>before</literal></quote>, then \r
9802 the float appears at the top of the page.  On some processors,\r
9803 that may be the next page rather than the current page.\r
9804 </para>\r
9805 </listitem>\r
9806 <listitem>\r
9807 <para>If <parameter>margin.note.float.type</parameter> is\r
9808 <quote><literal>left</literal></quote> or\r
9809 <quote><literal>start</literal></quote>, then \r
9810 a left side float is used.\r
9811 </para>\r
9812 </listitem>\r
9813 <listitem>\r
9814 <para>If <parameter>margin.note.float.type</parameter> is\r
9815 <quote><literal>right</literal></quote> or\r
9816 <quote><literal>end</literal></quote>, then \r
9817 a right side float is used.\r
9818 </para>\r
9819 </listitem>\r
9820 <listitem>\r
9821 <para>If your XSL-FO processor supports floats positioned on the\r
9822 <quote><literal>inside</literal></quote> or\r
9823 <quote><literal>outside</literal></quote>\r
9824 of double-sided pages, then you have those two \r
9825 options for side floats as well.\r
9826 </para>\r
9827 </listitem>\r
9828 </itemizedlist>\r
9829 \r
9830 </refsection>\r
9831 </refentry>\r
9832 \r
9833 <refentry version="5.0" xml:id="margin.note.width">\r
9834 <refmeta>\r
9835 <refentrytitle>margin.note.width</refentrytitle>\r
9836 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
9837 </refmeta>\r
9838 <refnamediv>\r
9839 <refname>margin.note.width</refname>\r
9840 <refpurpose>Set the default width for margin notes</refpurpose>\r
9841 </refnamediv>\r
9842 \r
9843 <refsynopsisdiv>\r
9844 <programlisting xml:id="margin.note.width.frag">\r
9845 &lt;xsl:param name="margin.note.width"&gt;1in&lt;/xsl:param&gt;\r
9846 </programlisting>\r
9847 </refsynopsisdiv>\r
9848 \r
9849 <refsection><info><title>Description</title></info>\r
9850 \r
9851 <para>Sets the default width for margin notes when used as a side\r
9852 float.  The width determines the degree to which the margin note block\r
9853 intrudes into the text area.\r
9854 </para>\r
9855 <para>If <parameter>margin.note.float.type</parameter> is\r
9856 <quote><literal>before</literal></quote> or \r
9857 <quote><literal>none</literal></quote>, then \r
9858 this parameter is ignored.\r
9859 </para>\r
9860 \r
9861 </refsection>\r
9862 </refentry>\r
9863 \r
9864 <refentry version="5.0" xml:id="component.title.properties">\r
9865 <refmeta>\r
9866 <refentrytitle>component.title.properties</refentrytitle>\r
9867 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
9868 </refmeta>\r
9869 <refnamediv>\r
9870 <refname>component.title.properties</refname>\r
9871 <refpurpose>Properties for component titles</refpurpose>\r
9872 </refnamediv>\r
9873 \r
9874 <refsynopsisdiv>\r
9875 <programlisting xml:id="component.title.properties.frag">\r
9876 &lt;xsl:attribute-set name="component.title.properties"&gt;\r
9877   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;\r
9878   &lt;xsl:attribute name="space-before.optimum"&gt;&lt;xsl:value-of select="concat($body.font.master, 'pt')"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;\r
9879   &lt;xsl:attribute name="space-before.minimum"&gt;&lt;xsl:value-of select="concat($body.font.master, 'pt * 0.8')"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;\r
9880   &lt;xsl:attribute name="space-before.maximum"&gt;&lt;xsl:value-of select="concat($body.font.master, 'pt * 1.2')"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;\r
9881   &lt;xsl:attribute name="hyphenate"&gt;false&lt;/xsl:attribute&gt;\r
9882   &lt;xsl:attribute name="text-align"&gt;\r
9883     &lt;xsl:choose&gt;\r
9884       &lt;xsl:when test="((parent::article | parent::articleinfo | parent::info/parent::article) and not(ancestor::book) and not(self::bibliography))         or (parent::slides | parent::slidesinfo)"&gt;center&lt;/xsl:when&gt;\r
9885       &lt;xsl:otherwise&gt;start&lt;/xsl:otherwise&gt;\r
9886     &lt;/xsl:choose&gt;\r
9887   &lt;/xsl:attribute&gt;\r
9888   &lt;xsl:attribute name="start-indent"&gt;&lt;xsl:value-of select="$title.margin.left"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;\r
9889 &lt;/xsl:attribute-set&gt;\r
9890 </programlisting>\r
9891 </refsynopsisdiv>\r
9892 \r
9893 <refsection><info><title>Description</title></info>\r
9894 \r
9895 <para>The properties common to all component titles.</para>\r
9896 \r
9897 </refsection>\r
9898 </refentry>\r
9899 \r
9900 <refentry version="5.0" xml:id="component.titlepage.properties">\r
9901 <refmeta>\r
9902 <refentrytitle>component.titlepage.properties</refentrytitle>\r
9903 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
9904 </refmeta>\r
9905 <refnamediv>\r
9906 <refname>component.titlepage.properties</refname>\r
9907 <refpurpose>Properties for component titlepages</refpurpose>\r
9908 </refnamediv>\r
9909 \r
9910 <refsynopsisdiv>\r
9911 <programlisting xml:id="component.titlepage.properties.frag">\r
9912 &lt;xsl:attribute-set name="component.titlepage.properties"&gt;\r
9913 &lt;/xsl:attribute-set&gt;\r
9914 </programlisting>\r
9915 </refsynopsisdiv>\r
9916 \r
9917 <refsection><info><title>Description</title></info>\r
9918 \r
9919 <para>The properties that are applied to the outer block containing\r
9920 all the component title page information. \r
9921 Its main use is to set a <literal>span="all"</literal>\r
9922 property on the block that is a direct child of the flow.</para>\r
9923 \r
9924 <para>This attribute-set also applies to index titlepages. It is empty by default.</para>\r
9925 \r
9926 </refsection>\r
9927 </refentry>\r
9928 \r
9929 <refentry version="5.0" xml:id="section.title.properties">\r
9930 <refmeta>\r
9931 <refentrytitle>section.title.properties</refentrytitle>\r
9932 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
9933 </refmeta>\r
9934 <refnamediv>\r
9935 <refname>section.title.properties</refname>\r
9936 <refpurpose>Properties for section titles</refpurpose>\r
9937 </refnamediv>\r
9938 \r
9939 <refsynopsisdiv>\r
9940 <programlisting xml:id="section.title.properties.frag">\r
9941 &lt;xsl:attribute-set name="section.title.properties"&gt;\r
9942   &lt;xsl:attribute name="font-family"&gt;\r
9943     &lt;xsl:value-of select="$title.font.family"&gt;&lt;/xsl:value-of&gt;\r
9944   &lt;/xsl:attribute&gt;\r
9945   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;\r
9946   &lt;!-- font size is calculated dynamically by section.heading template --&gt;\r
9947   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;\r
9948   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;\r
9949   &lt;xsl:attribute name="space-before.optimum"&gt;1.0em&lt;/xsl:attribute&gt;\r
9950   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;\r
9951   &lt;xsl:attribute name="text-align"&gt;start&lt;/xsl:attribute&gt;\r
9952   &lt;xsl:attribute name="start-indent"&gt;&lt;xsl:value-of select="$title.margin.left"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;\r
9953 &lt;/xsl:attribute-set&gt;\r
9954 </programlisting>\r
9955 </refsynopsisdiv>\r
9956 \r
9957 <refsection><info><title>Description</title></info>\r
9958 \r
9959 <para>The properties common to all section titles.</para>\r
9960 \r
9961 </refsection>\r
9962 </refentry>\r
9963 \r
9964 <refentry version="5.0" xml:id="section.title.level1.properties">\r
9965 <refmeta>\r
9966 <refentrytitle>section.title.level1.properties</refentrytitle>\r
9967 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
9968 </refmeta>\r
9969 <refnamediv>\r
9970 <refname>section.title.level1.properties</refname>\r
9971 <refpurpose>Properties for level-1 section titles</refpurpose>\r
9972 </refnamediv>\r
9973 \r
9974 <refsynopsisdiv>\r
9975 <programlisting xml:id="section.title.level1.properties.frag">\r
9976 &lt;xsl:attribute-set name="section.title.level1.properties"&gt;\r
9977   &lt;xsl:attribute name="font-size"&gt;\r
9978     &lt;xsl:value-of select="$body.font.master * 2.0736"&gt;&lt;/xsl:value-of&gt;\r
9979     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;\r
9980   &lt;/xsl:attribute&gt;\r
9981 &lt;/xsl:attribute-set&gt;\r
9982 </programlisting>\r
9983 </refsynopsisdiv>\r
9984 \r
9985 <refsection><info><title>Description</title></info>\r
9986 \r
9987 <para>The properties of level-1 section titles.</para>\r
9988 \r
9989 </refsection>\r
9990 </refentry>\r
9991 \r
9992 \r
9993 <refentry version="5.0" xml:id="section.title.level2.properties">\r
9994 <refmeta>\r
9995 <refentrytitle>section.title.level2.properties</refentrytitle>\r
9996 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
9997 </refmeta>\r
9998 <refnamediv>\r
9999 <refname>section.title.level2.properties</refname>\r
10000 <refpurpose>Properties for level-2 section titles</refpurpose>\r
10001 </refnamediv>\r
10002 \r
10003 <refsynopsisdiv>\r
10004 <programlisting xml:id="section.title.level2.properties.frag">\r
10005 &lt;xsl:attribute-set name="section.title.level2.properties"&gt;\r
10006   &lt;xsl:attribute name="font-size"&gt;\r
10007     &lt;xsl:value-of select="$body.font.master * 1.728"&gt;&lt;/xsl:value-of&gt;\r
10008     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;\r
10009   &lt;/xsl:attribute&gt;\r
10010 &lt;/xsl:attribute-set&gt;\r
10011 </programlisting>\r
10012 </refsynopsisdiv>\r
10013 \r
10014 <refsection><info><title>Description</title></info>\r
10015 \r
10016 <para>The properties of level-2 section titles.</para>\r
10017 \r
10018 </refsection>\r
10019 </refentry>\r
10020 \r
10021 <refentry version="5.0" xml:id="section.title.level3.properties">\r
10022 <refmeta>\r
10023 <refentrytitle>section.title.level3.properties</refentrytitle>\r
10024 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10025 </refmeta>\r
10026 <refnamediv>\r
10027 <refname>section.title.level3.properties</refname>\r
10028 <refpurpose>Properties for level-3 section titles</refpurpose>\r
10029 </refnamediv>\r
10030 \r
10031 <refsynopsisdiv>\r
10032 <programlisting xml:id="section.title.level3.properties.frag">\r
10033 &lt;xsl:attribute-set name="section.title.level3.properties"&gt;\r
10034   &lt;xsl:attribute name="font-size"&gt;\r
10035     &lt;xsl:value-of select="$body.font.master * 1.44"&gt;&lt;/xsl:value-of&gt;\r
10036     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;\r
10037   &lt;/xsl:attribute&gt;\r
10038 &lt;/xsl:attribute-set&gt;\r
10039 </programlisting>\r
10040 </refsynopsisdiv>\r
10041 \r
10042 <refsection><info><title>Description</title></info>\r
10043 \r
10044 <para>The properties of level-3 section titles.</para>\r
10045 \r
10046 </refsection>\r
10047 </refentry>\r
10048 \r
10049 <refentry version="5.0" xml:id="section.title.level4.properties">\r
10050 <refmeta>\r
10051 <refentrytitle>section.title.level4.properties</refentrytitle>\r
10052 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10053 </refmeta>\r
10054 <refnamediv>\r
10055 <refname>section.title.level4.properties</refname>\r
10056 <refpurpose>Properties for level-4 section titles</refpurpose>\r
10057 </refnamediv>\r
10058 \r
10059 <refsynopsisdiv>\r
10060 <programlisting xml:id="section.title.level4.properties.frag">\r
10061 &lt;xsl:attribute-set name="section.title.level4.properties"&gt;\r
10062   &lt;xsl:attribute name="font-size"&gt;\r
10063     &lt;xsl:value-of select="$body.font.master * 1.2"&gt;&lt;/xsl:value-of&gt;\r
10064     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;\r
10065   &lt;/xsl:attribute&gt;\r
10066 &lt;/xsl:attribute-set&gt;\r
10067 </programlisting>\r
10068 </refsynopsisdiv>\r
10069 \r
10070 <refsection><info><title>Description</title></info>\r
10071 \r
10072 <para>The properties of level-4 section titles.</para>\r
10073 \r
10074 </refsection>\r
10075 </refentry>\r
10076 \r
10077 <refentry version="5.0" xml:id="section.title.level5.properties">\r
10078 <refmeta>\r
10079 <refentrytitle>section.title.level5.properties</refentrytitle>\r
10080 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10081 </refmeta>\r
10082 <refnamediv>\r
10083 <refname>section.title.level5.properties</refname>\r
10084 <refpurpose>Properties for level-5 section titles</refpurpose>\r
10085 </refnamediv>\r
10086 \r
10087 <refsynopsisdiv>\r
10088 <programlisting xml:id="section.title.level5.properties.frag">\r
10089 &lt;xsl:attribute-set name="section.title.level5.properties"&gt;\r
10090   &lt;xsl:attribute name="font-size"&gt;\r
10091     &lt;xsl:value-of select="$body.font.master"&gt;&lt;/xsl:value-of&gt;\r
10092     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;\r
10093   &lt;/xsl:attribute&gt;\r
10094 &lt;/xsl:attribute-set&gt;\r
10095 </programlisting>\r
10096 </refsynopsisdiv>\r
10097 \r
10098 <refsection><info><title>Description</title></info>\r
10099 \r
10100 <para>The properties of level-5 section titles.</para>\r
10101 \r
10102 </refsection>\r
10103 </refentry>\r
10104 \r
10105 <refentry version="5.0" xml:id="section.title.level6.properties">\r
10106 <refmeta>\r
10107 <refentrytitle>section.title.level6.properties</refentrytitle>\r
10108 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10109 </refmeta>\r
10110 <refnamediv>\r
10111 <refname>section.title.level6.properties</refname>\r
10112 <refpurpose>Properties for level-6 section titles</refpurpose>\r
10113 </refnamediv>\r
10114 \r
10115 <refsynopsisdiv>\r
10116 <programlisting xml:id="section.title.level6.properties.frag">\r
10117 &lt;xsl:attribute-set name="section.title.level6.properties"&gt;\r
10118   &lt;xsl:attribute name="font-size"&gt;\r
10119     &lt;xsl:value-of select="$body.font.master"&gt;&lt;/xsl:value-of&gt;\r
10120     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;\r
10121   &lt;/xsl:attribute&gt;\r
10122 &lt;/xsl:attribute-set&gt;\r
10123 </programlisting>\r
10124 </refsynopsisdiv>\r
10125 \r
10126 <refsection><info><title>Description</title></info>\r
10127 \r
10128 <para>The properties of level-6 section titles. This property set is actually\r
10129 used for all titles below level 5.</para>\r
10130 \r
10131 </refsection>\r
10132 </refentry>\r
10133 \r
10134 <refentry version="5.0" xml:id="section.properties">\r
10135 <refmeta>\r
10136 <refentrytitle>section.properties</refentrytitle>\r
10137 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10138 </refmeta>\r
10139 <refnamediv>\r
10140 <refname>section.properties</refname>\r
10141 <refpurpose>Properties for all section levels</refpurpose>\r
10142 </refnamediv>\r
10143 \r
10144 <refsynopsisdiv>\r
10145 <programlisting xml:id="section.properties.frag">\r
10146 &lt;xsl:attribute-set name="section.properties"&gt;\r
10147 &lt;/xsl:attribute-set&gt;\r
10148 </programlisting>\r
10149 </refsynopsisdiv>\r
10150 \r
10151 <refsection><info><title>Description</title></info>\r
10152 \r
10153 <para>The properties that apply to the containing\r
10154 block of all section levels, and therefore apply to\r
10155 the whole section.  \r
10156 This attribute set is inherited by the\r
10157 more specific attribute sets such as\r
10158 <tag>section.level1.properties</tag>.\r
10159 The default is empty.\r
10160 </para>\r
10161 \r
10162 </refsection>\r
10163 </refentry>\r
10164 \r
10165 <refentry version="5.0" xml:id="section.level1.properties">\r
10166 <refmeta>\r
10167 <refentrytitle>section.level1.properties</refentrytitle>\r
10168 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10169 </refmeta>\r
10170 <refnamediv>\r
10171 <refname>section.level1.properties</refname>\r
10172 <refpurpose>Properties for level-1 sections</refpurpose>\r
10173 </refnamediv>\r
10174 \r
10175 <refsynopsisdiv>\r
10176 <programlisting xml:id="section.level1.properties.frag">\r
10177 &lt;xsl:attribute-set name="section.level1.properties" use-attribute-sets="section.properties"&gt;\r
10178 &lt;/xsl:attribute-set&gt;\r
10179 </programlisting>\r
10180 </refsynopsisdiv>\r
10181 \r
10182 <refsection><info><title>Description</title></info>\r
10183 \r
10184 <para>The properties that apply to the containing\r
10185 block of a level-1 section, and therefore apply to\r
10186 the whole section.  This includes <tag>sect1</tag>\r
10187 elements and <tag>section</tag> elements at level 1.\r
10188 </para>\r
10189 \r
10190 <para>For example, you could start each level-1 section on\r
10191 a new page by using:</para>\r
10192 <programlisting>&lt;xsl:attribute-set name="section.level1.properties"&gt;\r
10193   &lt;xsl:attribute name="break-before"&gt;page&lt;/xsl:attribute&gt;\r
10194 &lt;/xsl:attribute-set&gt;\r
10195 </programlisting>\r
10196 \r
10197 <para>This attribute set inherits attributes from the\r
10198 general <tag>section.properties</tag> attribute set.\r
10199 </para>\r
10200 \r
10201 </refsection>\r
10202 </refentry>\r
10203 \r
10204 <refentry version="5.0" xml:id="section.level2.properties">\r
10205 <refmeta>\r
10206 <refentrytitle>section.level2.properties</refentrytitle>\r
10207 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10208 </refmeta>\r
10209 <refnamediv>\r
10210 <refname>section.level2.properties</refname>\r
10211 <refpurpose>Properties for level-2 sections</refpurpose>\r
10212 </refnamediv>\r
10213 \r
10214 <refsynopsisdiv>\r
10215 <programlisting xml:id="section.level2.properties.frag">\r
10216 &lt;xsl:attribute-set name="section.level2.properties" use-attribute-sets="section.properties"&gt;\r
10217 &lt;/xsl:attribute-set&gt;\r
10218 </programlisting>\r
10219 </refsynopsisdiv>\r
10220 \r
10221 <refsection><info><title>Description</title></info>\r
10222 \r
10223 <para>The properties that apply to the containing\r
10224 block of a level-2 section, and therefore apply to\r
10225 the whole section.  This includes <tag>sect2</tag>\r
10226 elements and <tag>section</tag> elements at level 2.\r
10227 </para>\r
10228 \r
10229 <para>For example, you could start each level-2 section on\r
10230 a new page by using:</para>\r
10231 <programlisting>&lt;xsl:attribute-set name="section.level2.properties"&gt;\r
10232   &lt;xsl:attribute name="break-before"&gt;page&lt;/xsl:attribute&gt;\r
10233 &lt;/xsl:attribute-set&gt;\r
10234 </programlisting>\r
10235 \r
10236 <para>This attribute set inherits attributes from the\r
10237 general <tag>section.properties</tag> attribute set.\r
10238 </para>\r
10239 \r
10240 </refsection>\r
10241 </refentry>\r
10242 \r
10243 <refentry version="5.0" xml:id="section.level3.properties">\r
10244 <refmeta>\r
10245 <refentrytitle>section.level3.properties</refentrytitle>\r
10246 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10247 </refmeta>\r
10248 <refnamediv>\r
10249 <refname>section.level3.properties</refname>\r
10250 <refpurpose>Properties for level-3 sections</refpurpose>\r
10251 </refnamediv>\r
10252 \r
10253 <refsynopsisdiv>\r
10254 <programlisting xml:id="section.level3.properties.frag">\r
10255 &lt;xsl:attribute-set name="section.level3.properties" use-attribute-sets="section.properties"&gt;\r
10256 &lt;/xsl:attribute-set&gt;\r
10257 </programlisting>\r
10258 </refsynopsisdiv>\r
10259 \r
10260 <refsection><info><title>Description</title></info>\r
10261 \r
10262 <para>The properties that apply to the containing\r
10263 block of a level-3 section, and therefore apply to\r
10264 the whole section.  This includes <tag>sect3</tag>\r
10265 elements and <tag>section</tag> elements at level 3.\r
10266 </para>\r
10267 \r
10268 <para>For example, you could start each level-3 section on\r
10269 a new page by using:</para>\r
10270 <programlisting>&lt;xsl:attribute-set name="section.level3.properties"&gt;\r
10271   &lt;xsl:attribute name="break-before"&gt;page&lt;/xsl:attribute&gt;\r
10272 &lt;/xsl:attribute-set&gt;\r
10273 </programlisting>\r
10274 \r
10275 <para>This attribute set inherits attributes from the\r
10276 general <tag>section.properties</tag> attribute set.\r
10277 </para>\r
10278 \r
10279 </refsection>\r
10280 </refentry>\r
10281 \r
10282 <refentry version="5.0" xml:id="section.level4.properties">\r
10283 <refmeta>\r
10284 <refentrytitle>section.level4.properties</refentrytitle>\r
10285 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10286 </refmeta>\r
10287 <refnamediv>\r
10288 <refname>section.level4.properties</refname>\r
10289 <refpurpose>Properties for level-4 sections</refpurpose>\r
10290 </refnamediv>\r
10291 \r
10292 <refsynopsisdiv>\r
10293 <programlisting xml:id="section.level4.properties.frag">\r
10294 &lt;xsl:attribute-set name="section.level4.properties" use-attribute-sets="section.properties"&gt;\r
10295 &lt;/xsl:attribute-set&gt;\r
10296 </programlisting>\r
10297 </refsynopsisdiv>\r
10298 \r
10299 <refsection><info><title>Description</title></info>\r
10300 \r
10301 <para>The properties that apply to the containing\r
10302 block of a level-4 section, and therefore apply to\r
10303 the whole section.  This includes <tag>sect4</tag>\r
10304 elements and <tag>section</tag> elements at level 4.\r
10305 </para>\r
10306 \r
10307 <para>For example, you could start each level-4 section on\r
10308 a new page by using:</para>\r
10309 <programlisting>&lt;xsl:attribute-set name="section.level4.properties"&gt;\r
10310   &lt;xsl:attribute name="break-before"&gt;page&lt;/xsl:attribute&gt;\r
10311 &lt;/xsl:attribute-set&gt;\r
10312 </programlisting>\r
10313 \r
10314 <para>This attribute set inherits attributes from the\r
10315 general <tag>section.properties</tag> attribute set.\r
10316 </para>\r
10317 \r
10318 </refsection>\r
10319 </refentry>\r
10320 \r
10321 <refentry version="5.0" xml:id="section.level5.properties">\r
10322 <refmeta>\r
10323 <refentrytitle>section.level5.properties</refentrytitle>\r
10324 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10325 </refmeta>\r
10326 <refnamediv>\r
10327 <refname>section.level5.properties</refname>\r
10328 <refpurpose>Properties for level-5 sections</refpurpose>\r
10329 </refnamediv>\r
10330 \r
10331 <refsynopsisdiv>\r
10332 <programlisting xml:id="section.level5.properties.frag">\r
10333 &lt;xsl:attribute-set name="section.level5.properties" use-attribute-sets="section.properties"&gt;\r
10334 &lt;/xsl:attribute-set&gt;\r
10335 </programlisting>\r
10336 </refsynopsisdiv>\r
10337 \r
10338 <refsection><info><title>Description</title></info>\r
10339 \r
10340 <para>The properties that apply to the containing\r
10341 block of a level-5 section, and therefore apply to\r
10342 the whole section.  This includes <tag>sect5</tag>\r
10343 elements and <tag>section</tag> elements at level 5.\r
10344 </para>\r
10345 \r
10346 <para>For example, you could start each level-5 section on\r
10347 a new page by using:</para>\r
10348 <programlisting>&lt;xsl:attribute-set name="section.level5.properties"&gt;\r
10349   &lt;xsl:attribute name="break-before"&gt;page&lt;/xsl:attribute&gt;\r
10350 &lt;/xsl:attribute-set&gt;\r
10351 </programlisting>\r
10352 \r
10353 <para>This attribute set inherits attributes from the\r
10354 general <tag>section.properties</tag> attribute set.\r
10355 </para>\r
10356 \r
10357 </refsection>\r
10358 </refentry>\r
10359 \r
10360 <refentry version="5.0" xml:id="section.level6.properties">\r
10361 <refmeta>\r
10362 <refentrytitle>section.level6.properties</refentrytitle>\r
10363 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10364 </refmeta>\r
10365 <refnamediv>\r
10366 <refname>section.level6.properties</refname>\r
10367 <refpurpose>Properties for level-6 sections</refpurpose>\r
10368 </refnamediv>\r
10369 \r
10370 <refsynopsisdiv>\r
10371 <programlisting xml:id="section.level6.properties.frag">\r
10372 &lt;xsl:attribute-set name="section.level6.properties" use-attribute-sets="section.properties"&gt;\r
10373 &lt;/xsl:attribute-set&gt;\r
10374 </programlisting>\r
10375 </refsynopsisdiv>\r
10376 \r
10377 <refsection><info><title>Description</title></info>\r
10378 \r
10379 <para>The properties that apply to the containing\r
10380 block of a level 6 or lower section, and therefore apply to\r
10381 the whole section.  This includes \r
10382 <tag>section</tag> elements at level 6 and lower.\r
10383 </para>\r
10384 \r
10385 <para>For example, you could start each level-6 section on\r
10386 a new page by using:</para>\r
10387 <programlisting>&lt;xsl:attribute-set name="section.level6.properties"&gt;\r
10388   &lt;xsl:attribute name="break-before"&gt;page&lt;/xsl:attribute&gt;\r
10389 &lt;/xsl:attribute-set&gt;\r
10390 </programlisting>\r
10391 \r
10392 <para>This attribute set inherits attributes from the\r
10393 general <tag>section.properties</tag> attribute set.\r
10394 </para>\r
10395 \r
10396 </refsection>\r
10397 </refentry>\r
10398 \r
10399 <refentry version="5.0" xml:id="figure.properties">\r
10400 <refmeta>\r
10401 <refentrytitle>figure.properties</refentrytitle>\r
10402 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10403 </refmeta>  \r
10404 <refnamediv>\r
10405 <refname>figure.properties</refname>\r
10406 <refpurpose>Properties associated with a figure</refpurpose>\r
10407 </refnamediv>\r
10408 \r
10409 <refsynopsisdiv>\r
10410 <programlisting xml:id="figure.properties.frag">\r
10411 &lt;xsl:attribute-set name="figure.properties" use-attribute-sets="formal.object.properties"&gt;&lt;/xsl:attribute-set&gt;\r
10412 </programlisting>\r
10413 </refsynopsisdiv>\r
10414 \r
10415 <refsection><info><title>Description</title></info>\r
10416 \r
10417 <para>The styling for figures.</para>\r
10418 \r
10419 </refsection>\r
10420 </refentry>\r
10421 \r
10422 <refentry version="5.0" xml:id="example.properties">\r
10423 <refmeta>\r
10424 <refentrytitle>example.properties</refentrytitle>\r
10425 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10426 </refmeta>\r
10427 <refnamediv>\r
10428 <refname>example.properties</refname>\r
10429 <refpurpose>Properties associated with a example</refpurpose>\r
10430 </refnamediv>\r
10431 \r
10432 <refsynopsisdiv>\r
10433 <programlisting xml:id="example.properties.frag">\r
10434 &lt;xsl:attribute-set name="example.properties" use-attribute-sets="formal.object.properties"&gt;&lt;/xsl:attribute-set&gt;\r
10435 </programlisting>\r
10436 </refsynopsisdiv>\r
10437 \r
10438 <refsection><info><title>Description</title></info>\r
10439 \r
10440 <para>The styling for examples.</para>\r
10441 \r
10442 </refsection>\r
10443 </refentry>\r
10444 \r
10445 <refentry version="5.0" xml:id="equation.properties">\r
10446 <refmeta>\r
10447 <refentrytitle>equation.properties</refentrytitle>\r
10448 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10449 </refmeta>\r
10450 <refnamediv>\r
10451 <refname>equation.properties</refname>\r
10452 <refpurpose>Properties associated with a equation</refpurpose>\r
10453 </refnamediv>\r
10454 \r
10455 <refsynopsisdiv>\r
10456 <programlisting xml:id="equation.properties.frag">\r
10457 &lt;xsl:attribute-set name="equation.properties" use-attribute-sets="formal.object.properties"&gt;&lt;/xsl:attribute-set&gt;\r
10458 </programlisting>\r
10459 </refsynopsisdiv>\r
10460 \r
10461 <refsection><info><title>Description</title></info>\r
10462 \r
10463 <para>The styling for equations.</para>\r
10464 \r
10465 </refsection>\r
10466 </refentry>\r
10467 \r
10468 <refentry version="5.0" xml:id="table.properties">\r
10469 <refmeta>\r
10470 <refentrytitle>table.properties</refentrytitle>\r
10471 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10472 </refmeta>\r
10473 <refnamediv>\r
10474 <refname>table.properties</refname>\r
10475 <refpurpose>Properties associated with the block surrounding a table</refpurpose>\r
10476 </refnamediv>\r
10477 \r
10478 <refsynopsisdiv>\r
10479 <programlisting xml:id="table.properties.frag">\r
10480 &lt;xsl:attribute-set name="table.properties" use-attribute-sets="formal.object.properties"&gt;\r
10481   &lt;xsl:attribute name="keep-together.within-column"&gt;auto&lt;/xsl:attribute&gt;\r
10482 &lt;/xsl:attribute-set&gt;\r
10483 </programlisting>\r
10484 </refsynopsisdiv>\r
10485 \r
10486 <refsection><info><title>Description</title></info>\r
10487 \r
10488 <para>Block styling properties for tables. This parameter should really\r
10489 have been called <literal>table.block.properties</literal> or something\r
10490 like that, but we&#8217;re leaving it to avoid backwards-compatibility\r
10491 problems.</para>\r
10492 \r
10493 <para>See also <parameter>table.table.properties</parameter>.</para>\r
10494 \r
10495 </refsection>\r
10496 </refentry>\r
10497 \r
10498 <refentry version="5.0" xml:id="informalfigure.properties">\r
10499 <refmeta>\r
10500 <refentrytitle>informalfigure.properties</refentrytitle>\r
10501 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10502 </refmeta>\r
10503 <refnamediv>\r
10504 <refname>informalfigure.properties</refname>\r
10505 <refpurpose>Properties associated with an informalfigure</refpurpose>\r
10506 </refnamediv>\r
10507 \r
10508 <refsynopsisdiv>\r
10509 <programlisting xml:id="informalfigure.properties.frag">\r
10510 &lt;xsl:attribute-set name="informalfigure.properties" use-attribute-sets="informal.object.properties"&gt;&lt;/xsl:attribute-set&gt;\r
10511 </programlisting>\r
10512 </refsynopsisdiv>\r
10513 \r
10514 <refsection><info><title>Description</title></info>\r
10515 \r
10516 <para>The styling for informalfigures.</para>\r
10517 \r
10518 </refsection>\r
10519 </refentry>\r
10520 \r
10521 <refentry version="5.0" xml:id="informalexample.properties">\r
10522 <refmeta>\r
10523 <refentrytitle>informalexample.properties</refentrytitle>\r
10524 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10525 </refmeta>\r
10526 <refnamediv>\r
10527 <refname>informalexample.properties</refname>\r
10528 <refpurpose>Properties associated with an informalexample</refpurpose>\r
10529 </refnamediv>\r
10530 \r
10531 <refsynopsisdiv>\r
10532 <programlisting xml:id="informalexample.properties.frag">\r
10533 &lt;xsl:attribute-set name="informalexample.properties" use-attribute-sets="informal.object.properties"&gt;&lt;/xsl:attribute-set&gt;\r
10534 </programlisting>\r
10535 </refsynopsisdiv>\r
10536 \r
10537 <refsection><info><title>Description</title></info>\r
10538 \r
10539 <para>The styling for informalexamples.</para>\r
10540 \r
10541 </refsection>\r
10542 </refentry>\r
10543 \r
10544 <refentry version="5.0" xml:id="informalequation.properties">\r
10545 <refmeta>\r
10546 <refentrytitle>informalequation.properties</refentrytitle>\r
10547 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10548 </refmeta>\r
10549 <refnamediv>\r
10550 <refname>informalequation.properties</refname>\r
10551 <refpurpose>Properties associated with an informalequation</refpurpose>\r
10552 </refnamediv>\r
10553 \r
10554 <refsynopsisdiv>\r
10555 <programlisting xml:id="informalequation.properties.frag">\r
10556 &lt;xsl:attribute-set name="informalequation.properties" use-attribute-sets="informal.object.properties"&gt;&lt;/xsl:attribute-set&gt;\r
10557 </programlisting>\r
10558 </refsynopsisdiv>\r
10559 \r
10560 <refsection><info><title>Description</title></info>\r
10561 \r
10562 <para>The styling for informalequations.</para>\r
10563 \r
10564 </refsection>\r
10565 </refentry>\r
10566 \r
10567 <refentry version="5.0" xml:id="informaltable.properties">\r
10568 <refmeta>\r
10569 <refentrytitle>informaltable.properties</refentrytitle>\r
10570 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10571 </refmeta>\r
10572 <refnamediv>\r
10573 <refname>informaltable.properties</refname>\r
10574 <refpurpose>Properties associated with the block surrounding an informaltable</refpurpose>\r
10575 </refnamediv>\r
10576 \r
10577 <refsynopsisdiv>\r
10578 <programlisting xml:id="informaltable.properties.frag">\r
10579 &lt;xsl:attribute-set name="informaltable.properties" use-attribute-sets="informal.object.properties"&gt;&lt;/xsl:attribute-set&gt;\r
10580 </programlisting>\r
10581 </refsynopsisdiv>\r
10582 \r
10583 <refsection><info><title>Description</title></info>\r
10584 \r
10585 <para>Block styling properties for informaltables. This parameter should really\r
10586 have been called <literal>informaltable.block.properties</literal> or something\r
10587 like that, but we&#8217;re leaving it to avoid backwards-compatibility\r
10588 problems.</para>\r
10589 \r
10590 <para>See also <parameter>table.table.properties</parameter>.</para>\r
10591 \r
10592 </refsection>\r
10593 </refentry>\r
10594 \r
10595 <refentry version="5.0" xml:id="procedure.properties">\r
10596 <refmeta>\r
10597 <refentrytitle>procedure.properties</refentrytitle>\r
10598 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10599 </refmeta>\r
10600 <refnamediv>\r
10601 <refname>procedure.properties</refname>\r
10602 <refpurpose>Properties associated with a procedure</refpurpose>\r
10603 </refnamediv>\r
10604 \r
10605 <refsynopsisdiv>\r
10606 <programlisting xml:id="procedure.properties.frag">\r
10607 &lt;xsl:attribute-set name="procedure.properties" use-attribute-sets="formal.object.properties"&gt;\r
10608   &lt;xsl:attribute name="keep-together.within-column"&gt;auto&lt;/xsl:attribute&gt;\r
10609 &lt;/xsl:attribute-set&gt;\r
10610 </programlisting>\r
10611 </refsynopsisdiv>\r
10612 \r
10613 <refsection><info><title>Description</title></info>\r
10614 \r
10615 <para>The styling for procedures.</para>\r
10616 \r
10617 </refsection>\r
10618 </refentry>\r
10619 \r
10620 <refentry version="5.0" xml:id="root.properties">\r
10621 <refmeta>\r
10622 <refentrytitle>root.properties</refentrytitle>\r
10623 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10624 </refmeta>\r
10625 <refnamediv>\r
10626 <refname>root.properties</refname>\r
10627 <refpurpose>The properties of the fo:root element</refpurpose>\r
10628 </refnamediv>\r
10629 \r
10630 <refsynopsisdiv>\r
10631 <programlisting xml:id="root.properties.frag">\r
10632 &lt;xsl:attribute-set name="root.properties"&gt;\r
10633   &lt;xsl:attribute name="font-family"&gt;\r
10634     &lt;xsl:value-of select="$body.fontset"&gt;&lt;/xsl:value-of&gt;\r
10635   &lt;/xsl:attribute&gt;\r
10636   &lt;xsl:attribute name="font-size"&gt;\r
10637     &lt;xsl:value-of select="$body.font.size"&gt;&lt;/xsl:value-of&gt;\r
10638   &lt;/xsl:attribute&gt;\r
10639   &lt;xsl:attribute name="text-align"&gt;\r
10640     &lt;xsl:value-of select="$alignment"&gt;&lt;/xsl:value-of&gt;\r
10641   &lt;/xsl:attribute&gt;\r
10642   &lt;xsl:attribute name="line-height"&gt;\r
10643     &lt;xsl:value-of select="$line-height"&gt;&lt;/xsl:value-of&gt;\r
10644   &lt;/xsl:attribute&gt;\r
10645   &lt;xsl:attribute name="font-selection-strategy"&gt;character-by-character&lt;/xsl:attribute&gt;\r
10646   &lt;xsl:attribute name="line-height-shift-adjustment"&gt;disregard-shifts&lt;/xsl:attribute&gt;\r
10647   &lt;xsl:attribute name="writing-mode"&gt;\r
10648     &lt;xsl:value-of select="$direction.mode"&gt;&lt;/xsl:value-of&gt;\r
10649   &lt;/xsl:attribute&gt;\r
10650 &lt;/xsl:attribute-set&gt;\r
10651 </programlisting>\r
10652 </refsynopsisdiv>\r
10653 \r
10654 <refsection><info><title>Description</title></info>\r
10655 \r
10656 <para>This property set is used on the <tag>fo:root</tag> element of\r
10657 an FO file. It defines a set of default, global parameters.</para>\r
10658 \r
10659 </refsection>\r
10660 </refentry>\r
10661 \r
10662 <refentry version="5.0" xml:id="qanda.title.properties">\r
10663 <refmeta>\r
10664 <refentrytitle>qanda.title.properties</refentrytitle>\r
10665 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10666 </refmeta>\r
10667 <refnamediv>\r
10668 <refname>qanda.title.properties</refname>\r
10669 <refpurpose>Properties for qanda set titles</refpurpose>\r
10670 </refnamediv>\r
10671 \r
10672 <refsynopsisdiv>\r
10673 <programlisting xml:id="qanda.title.properties.frag">\r
10674 &lt;xsl:attribute-set name="qanda.title.properties"&gt;\r
10675   &lt;xsl:attribute name="font-family"&gt;\r
10676     &lt;xsl:value-of select="$title.font.family"&gt;&lt;/xsl:value-of&gt;\r
10677   &lt;/xsl:attribute&gt;\r
10678   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;\r
10679   &lt;!-- font size is calculated dynamically by qanda.heading template --&gt;\r
10680   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;\r
10681   &lt;xsl:attribute name="space-before.minimum"&gt;0.8em&lt;/xsl:attribute&gt;\r
10682   &lt;xsl:attribute name="space-before.optimum"&gt;1.0em&lt;/xsl:attribute&gt;\r
10683   &lt;xsl:attribute name="space-before.maximum"&gt;1.2em&lt;/xsl:attribute&gt;\r
10684 &lt;/xsl:attribute-set&gt;\r
10685 </programlisting>\r
10686 </refsynopsisdiv>\r
10687 \r
10688 <refsection><info><title>Description</title></info>\r
10689 \r
10690 <para>The properties common to all qanda set titles.</para>\r
10691 \r
10692 </refsection>\r
10693 </refentry>\r
10694 \r
10695 <refentry version="5.0" xml:id="qanda.title.level1.properties">\r
10696 <refmeta>\r
10697 <refentrytitle>qanda.title.level1.properties</refentrytitle>\r
10698 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10699 </refmeta>\r
10700 <refnamediv>\r
10701 <refname>qanda.title.level1.properties</refname>\r
10702 <refpurpose>Properties for level-1 qanda set titles</refpurpose>\r
10703 </refnamediv>\r
10704 \r
10705 <refsynopsisdiv>\r
10706 <programlisting xml:id="qanda.title.level1.properties.frag">\r
10707 &lt;xsl:attribute-set name="qanda.title.level1.properties"&gt;\r
10708   &lt;xsl:attribute name="font-size"&gt;\r
10709     &lt;xsl:value-of select="$body.font.master * 2.0736"&gt;&lt;/xsl:value-of&gt;\r
10710     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;\r
10711   &lt;/xsl:attribute&gt;\r
10712 &lt;/xsl:attribute-set&gt;\r
10713 </programlisting>\r
10714 </refsynopsisdiv>\r
10715 \r
10716 <refsection><info><title>Description</title></info>\r
10717 \r
10718 <para>The properties of level-1 qanda set titles.</para>\r
10719 \r
10720 </refsection>\r
10721 </refentry>\r
10722 \r
10723 <refentry version="5.0" xml:id="qanda.title.level2.properties">\r
10724 <refmeta>\r
10725 <refentrytitle>qanda.title.level2.properties</refentrytitle>\r
10726 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10727 </refmeta>\r
10728 <refnamediv>\r
10729 <refname>qanda.title.level2.properties</refname>\r
10730 <refpurpose>Properties for level-2 qanda set titles</refpurpose>\r
10731 </refnamediv>\r
10732 \r
10733 <refsynopsisdiv>\r
10734 <programlisting xml:id="qanda.title.level2.properties.frag">\r
10735 &lt;xsl:attribute-set name="qanda.title.level2.properties"&gt;\r
10736   &lt;xsl:attribute name="font-size"&gt;\r
10737     &lt;xsl:value-of select="$body.font.master * 1.728"&gt;&lt;/xsl:value-of&gt;\r
10738     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;\r
10739   &lt;/xsl:attribute&gt;\r
10740 &lt;/xsl:attribute-set&gt;\r
10741 </programlisting>\r
10742 </refsynopsisdiv>\r
10743 \r
10744 <refsection><info><title>Description</title></info>\r
10745 \r
10746 <para>The properties of level-2 qanda set titles.</para>\r
10747 \r
10748 </refsection>\r
10749 </refentry>\r
10750 \r
10751 <refentry version="5.0" xml:id="qanda.title.level3.properties">\r
10752 <refmeta>\r
10753 <refentrytitle>qanda.title.level3.properties</refentrytitle>\r
10754 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10755 </refmeta>\r
10756 <refnamediv>\r
10757 <refname>qanda.title.level3.properties</refname>\r
10758 <refpurpose>Properties for level-3 qanda set titles</refpurpose>\r
10759 </refnamediv>\r
10760 \r
10761 <refsynopsisdiv>\r
10762 <programlisting xml:id="qanda.title.level3.properties.frag">\r
10763 &lt;xsl:attribute-set name="qanda.title.level3.properties"&gt;\r
10764   &lt;xsl:attribute name="font-size"&gt;\r
10765     &lt;xsl:value-of select="$body.font.master * 1.44"&gt;&lt;/xsl:value-of&gt;\r
10766     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;\r
10767   &lt;/xsl:attribute&gt;\r
10768 &lt;/xsl:attribute-set&gt;\r
10769 </programlisting>\r
10770 </refsynopsisdiv>\r
10771 \r
10772 <refsection><info><title>Description</title></info>\r
10773 \r
10774 <para>The properties of level-3 qanda set titles.</para>\r
10775 \r
10776 </refsection>\r
10777 </refentry>\r
10778 \r
10779 <refentry version="5.0" xml:id="qanda.title.level4.properties">\r
10780 <refmeta>\r
10781 <refentrytitle>qanda.title.level4.properties</refentrytitle>\r
10782 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10783 </refmeta>\r
10784 <refnamediv>\r
10785 <refname>qanda.title.level4.properties</refname>\r
10786 <refpurpose>Properties for level-4 qanda set titles</refpurpose>\r
10787 </refnamediv>\r
10788 \r
10789 <refsynopsisdiv>\r
10790 <programlisting xml:id="qanda.title.level4.properties.frag">\r
10791 &lt;xsl:attribute-set name="qanda.title.level4.properties"&gt;\r
10792   &lt;xsl:attribute name="font-size"&gt;\r
10793     &lt;xsl:value-of select="$body.font.master * 1.2"&gt;&lt;/xsl:value-of&gt;\r
10794     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;\r
10795   &lt;/xsl:attribute&gt;\r
10796 &lt;/xsl:attribute-set&gt;\r
10797 </programlisting>\r
10798 </refsynopsisdiv>\r
10799 \r
10800 <refsection><info><title>Description</title></info>\r
10801 \r
10802 <para>The properties of level-4 qanda set titles.</para>\r
10803 \r
10804 </refsection>\r
10805 </refentry>\r
10806 \r
10807 <refentry version="5.0" xml:id="qanda.title.level5.properties">\r
10808 <refmeta>\r
10809 <refentrytitle>qanda.title.level5.properties</refentrytitle>\r
10810 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10811 </refmeta>\r
10812 <refnamediv>\r
10813 <refname>qanda.title.level5.properties</refname>\r
10814 <refpurpose>Properties for level-5 qanda set titles</refpurpose>\r
10815 </refnamediv>\r
10816 \r
10817 <refsynopsisdiv>\r
10818 <programlisting xml:id="qanda.title.level5.properties.frag">\r
10819 &lt;xsl:attribute-set name="qanda.title.level5.properties"&gt;\r
10820   &lt;xsl:attribute name="font-size"&gt;\r
10821     &lt;xsl:value-of select="$body.font.master"&gt;&lt;/xsl:value-of&gt;\r
10822     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;\r
10823   &lt;/xsl:attribute&gt;\r
10824 &lt;/xsl:attribute-set&gt;\r
10825 </programlisting>\r
10826 </refsynopsisdiv>\r
10827 \r
10828 <refsection><info><title>Description</title></info>\r
10829 \r
10830 <para>The properties of level-5 qanda set titles.</para>\r
10831 \r
10832 </refsection>\r
10833 </refentry>\r
10834 \r
10835 <refentry version="5.0" xml:id="qanda.title.level6.properties">\r
10836 <refmeta>\r
10837 <refentrytitle>qanda.title.level6.properties</refentrytitle>\r
10838 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10839 </refmeta>\r
10840 <refnamediv>\r
10841 <refname>qanda.title.level6.properties</refname>\r
10842 <refpurpose>Properties for level-6 qanda set titles</refpurpose>\r
10843 </refnamediv>\r
10844 \r
10845 <refsynopsisdiv>\r
10846 <programlisting xml:id="qanda.title.level6.properties.frag">\r
10847 &lt;xsl:attribute-set name="qanda.title.level6.properties"&gt;\r
10848   &lt;xsl:attribute name="font-size"&gt;\r
10849     &lt;xsl:value-of select="$body.font.master"&gt;&lt;/xsl:value-of&gt;\r
10850     &lt;xsl:text&gt;pt&lt;/xsl:text&gt;\r
10851   &lt;/xsl:attribute&gt;\r
10852 &lt;/xsl:attribute-set&gt;\r
10853 </programlisting>\r
10854 </refsynopsisdiv>\r
10855 \r
10856 <refsection><info><title>Description</title></info>\r
10857 \r
10858 <para>The properties of level-6 qanda set titles.\r
10859 This property set is actually\r
10860 used for all titles below level 5.</para>\r
10861 \r
10862 </refsection>\r
10863 </refentry>\r
10864 \r
10865 <refentry version="5.0" xml:id="article.appendix.title.properties">\r
10866 <refmeta>\r
10867 <refentrytitle>article.appendix.title.properties</refentrytitle>\r
10868 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10869 </refmeta>\r
10870 <refnamediv>\r
10871 <refname>article.appendix.title.properties</refname>\r
10872 <refpurpose>Properties for appendix titles that appear in an article</refpurpose>\r
10873 </refnamediv>\r
10874 \r
10875 <refsynopsisdiv>\r
10876 <programlisting xml:id="article.appendix.title.properties.frag">\r
10877 &lt;xsl:attribute-set name="article.appendix.title.properties" use-attribute-sets="section.title.properties                          section.title.level1.properties"&gt;\r
10878   &lt;xsl:attribute name="margin-{$direction.align.start}"&gt;\r
10879     &lt;xsl:value-of select="$title.margin.left"&gt;&lt;/xsl:value-of&gt;\r
10880   &lt;/xsl:attribute&gt;\r
10881 &lt;/xsl:attribute-set&gt;\r
10882 </programlisting>\r
10883 </refsynopsisdiv>\r
10884 \r
10885 <refsection><info><title>Description</title></info>\r
10886 \r
10887 <para>The properties for the title of an appendix that\r
10888 appears inside an article.  The default is to use\r
10889 the properties of sect1 titles.</para>\r
10890 \r
10891 </refsection>\r
10892 </refentry>\r
10893 \r
10894 <refentry version="5.0" xml:id="abstract.properties">\r
10895 <refmeta>\r
10896 <refentrytitle>abstract.properties</refentrytitle>\r
10897 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10898 </refmeta>\r
10899 <refnamediv>\r
10900 <refname>abstract.properties</refname>\r
10901 <refpurpose>Properties associated with the block surrounding an abstract</refpurpose>\r
10902 </refnamediv>\r
10903 \r
10904 <refsynopsisdiv>\r
10905 <programlisting xml:id="abstract.properties.frag">\r
10906 &lt;xsl:attribute-set name="abstract.properties"&gt;\r
10907   &lt;xsl:attribute name="start-indent"&gt;0.0in&lt;/xsl:attribute&gt;\r
10908   &lt;xsl:attribute name="end-indent"&gt;0.0in&lt;/xsl:attribute&gt;\r
10909 &lt;/xsl:attribute-set&gt;\r
10910 </programlisting>\r
10911 </refsynopsisdiv>\r
10912 \r
10913 <refsection><info><title>Description</title></info>\r
10914 \r
10915 <para>Block styling properties for abstract.</para>\r
10916 \r
10917 <para>See also <parameter>abstract.title.properties</parameter>.</para>\r
10918 \r
10919 </refsection>\r
10920 </refentry>\r
10921 \r
10922 <refentry version="5.0" xml:id="abstract.title.properties">\r
10923 <refmeta>\r
10924 <refentrytitle>abstract.title.properties</refentrytitle>\r
10925 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10926 </refmeta>\r
10927 <refnamediv>\r
10928 <refname>abstract.title.properties</refname>\r
10929 <refpurpose>Properties for abstract titles</refpurpose>\r
10930 </refnamediv>\r
10931 \r
10932 <refsynopsisdiv>\r
10933 <programlisting xml:id="abstract.title.properties.frag">\r
10934 &lt;xsl:attribute-set name="abstract.title.properties"&gt;\r
10935   &lt;xsl:attribute name="font-family"&gt;&lt;xsl:value-of select="$title.fontset"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;\r
10936   &lt;xsl:attribute name="font-weight"&gt;bold&lt;/xsl:attribute&gt;\r
10937   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;\r
10938   &lt;xsl:attribute name="keep-with-next.within-column"&gt;always&lt;/xsl:attribute&gt;\r
10939   &lt;xsl:attribute name="space-before.optimum"&gt;&lt;xsl:value-of select="concat($body.font.master, 'pt')"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;\r
10940   &lt;xsl:attribute name="space-before.minimum"&gt;&lt;xsl:value-of select="concat($body.font.master, 'pt * 0.8')"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;\r
10941   &lt;xsl:attribute name="space-before.maximum"&gt;&lt;xsl:value-of select="concat($body.font.master, 'pt * 1.2')"&gt;&lt;/xsl:value-of&gt;&lt;/xsl:attribute&gt;\r
10942   &lt;xsl:attribute name="hyphenate"&gt;false&lt;/xsl:attribute&gt;\r
10943   &lt;xsl:attribute name="text-align"&gt;center&lt;/xsl:attribute&gt;\r
10944 &lt;/xsl:attribute-set&gt;\r
10945 </programlisting>\r
10946 </refsynopsisdiv>\r
10947 \r
10948 <refsection><info><title>Description</title></info>\r
10949 \r
10950 <para>The properties for abstract titles.</para>\r
10951 \r
10952 <para>See also <parameter>abstract.properties</parameter>.</para>\r
10953 \r
10954 </refsection>\r
10955 </refentry>\r
10956 \r
10957 <refentry version="5.0" xml:id="index.page.number.properties">\r
10958 <refmeta>\r
10959 <refentrytitle>index.page.number.properties</refentrytitle>\r
10960 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10961 </refmeta>\r
10962 <refnamediv>\r
10963 <refname>index.page.number.properties</refname>\r
10964 <refpurpose>Properties associated with index page numbers</refpurpose>\r
10965 </refnamediv>\r
10966 \r
10967 <refsynopsisdiv>\r
10968 <programlisting xml:id="index.page.number.properties.frag">\r
10969 &lt;xsl:attribute-set name="index.page.number.properties"&gt;\r
10970 &lt;/xsl:attribute-set&gt;\r
10971 </programlisting>\r
10972 </refsynopsisdiv>\r
10973 \r
10974 <refsection><info><title>Description</title></info>\r
10975 \r
10976 <para>Properties associated with page numbers in indexes. \r
10977 Changing color to indicate the page number is a link is\r
10978 one possibility.\r
10979 </para>\r
10980 \r
10981 </refsection>\r
10982 </refentry>\r
10983 \r
10984 <refentry version="5.0" xml:id="revhistory.table.properties">\r
10985 <refmeta>\r
10986 <refentrytitle>revhistory.table.properties</refentrytitle>\r
10987 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
10988 </refmeta>\r
10989 <refnamediv>\r
10990 <refname>revhistory.table.properties</refname>\r
10991 <refpurpose>The properties of table used for formatting revhistory</refpurpose>\r
10992 </refnamediv>\r
10993 \r
10994 <refsynopsisdiv>\r
10995 <programlisting xml:id="revhistory.table.properties.frag">\r
10996 &lt;xsl:attribute-set name="revhistory.table.properties"&gt;\r
10997 &lt;/xsl:attribute-set&gt;\r
10998 </programlisting>\r
10999 </refsynopsisdiv>\r
11000 \r
11001 <refsection><info><title>Description</title></info>\r
11002 \r
11003 <para>This property set defines appearance of revhistory table.</para>\r
11004 \r
11005 </refsection>\r
11006 </refentry>\r
11007 \r
11008 <refentry version="5.0" xml:id="revhistory.table.cell.properties">\r
11009 <refmeta>\r
11010 <refentrytitle>revhistory.table.cell.properties</refentrytitle>\r
11011 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
11012 </refmeta>\r
11013 <refnamediv>\r
11014 <refname>revhistory.table.cell.properties</refname>\r
11015 <refpurpose>The properties of table cells used for formatting revhistory</refpurpose>\r
11016 </refnamediv>\r
11017 \r
11018 <refsynopsisdiv>\r
11019 <programlisting xml:id="revhistory.table.cell.properties.frag">\r
11020 &lt;xsl:attribute-set name="revhistory.table.cell.properties"&gt;\r
11021 &lt;/xsl:attribute-set&gt;\r
11022 </programlisting>\r
11023 </refsynopsisdiv>\r
11024 \r
11025 <refsection><info><title>Description</title></info>\r
11026 \r
11027 <para>This property set defines appearance of individual cells in revhistory table.</para>\r
11028 \r
11029 </refsection>\r
11030 </refentry>\r
11031 \r
11032 <refentry version="5.0" xml:id="revhistory.title.properties">\r
11033 <refmeta>\r
11034 <refentrytitle>revhistory.title.properties</refentrytitle>\r
11035 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>\r
11036 </refmeta>\r
11037 <refnamediv>\r
11038 <refname>revhistory.title.properties</refname>\r
11039 <refpurpose>The properties of revhistory title</refpurpose>\r
11040 </refnamediv>\r
11041 \r
11042 <refsynopsisdiv>\r
11043 <programlisting xml:id="revhistory.title.properties.frag">\r
11044 &lt;xsl:attribute-set name="revhistory.title.properties"&gt;\r
11045 &lt;/xsl:attribute-set&gt;\r
11046 </programlisting>\r
11047 </refsynopsisdiv>\r
11048 \r
11049 <refsection><info><title>Description</title></info>\r
11050 \r
11051 <para>This property set defines appearance of revhistory title.</para>\r
11052 \r
11053 </refsection>\r
11054 </refentry>\r
11055 \r
11056 </reference>\r
11057 <reference xml:id="profiling"><title>Profiling</title>\r
11058 <partintro xml:id="profiling_partintro">\r
11059 <para>The following parameters can be used for attribute-based\r
11060 profiling of your document. For more information about profiling, see \r
11061 <link xmlns:xlink="http://www.w3.org/1999/xlink" role="tcg" xlink:href="Profiling.html">Profiling (conditional text)</link>.</para>\r
11062 </partintro>\r
11063 <refentry version="5.0" xml:id="profile.arch">\r
11064 <refmeta>\r
11065 <refentrytitle>profile.arch</refentrytitle>\r
11066 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
11067 </refmeta>\r
11068 <refnamediv>\r
11069 <refname>profile.arch</refname>\r
11070 <refpurpose>Target profile for <tag class="attribute">arch</tag>\r
11071 attribute</refpurpose>\r
11072 </refnamediv>\r
11073 \r
11074 <refsynopsisdiv>\r
11075 <programlisting xml:id="profile.arch.frag">\r
11076 &lt;xsl:param name="profile.arch"&gt;&lt;/xsl:param&gt;\r
11077 </programlisting>\r
11078 </refsynopsisdiv>\r
11079 \r
11080 \r
11081 <refsection><info><title>Description</title></info>\r
11082 \r
11083 <para>The value of this parameter specifies profiles which should be\r
11084 included in the output. You can specify multiple profiles by\r
11085 separating them by semicolon. You can change separator character by\r
11086 <parameter>profile.separator</parameter>\r
11087 parameter.</para>\r
11088 \r
11089 <para>This parameter has effect only when you are using profiling\r
11090 stylesheets (<filename>profile-docbook.xsl</filename>,\r
11091 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal\r
11092 ones (<filename>docbook.xsl</filename>,\r
11093 <filename>chunk.xsl</filename>, &#8230;).</para>\r
11094 \r
11095 </refsection>\r
11096 </refentry>\r
11097 \r
11098 <refentry version="5.0" xml:id="profile.audience">\r
11099 <refmeta>\r
11100 <refentrytitle>profile.audience</refentrytitle>\r
11101 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
11102 </refmeta>\r
11103 <refnamediv>\r
11104 <refname>profile.audience</refname>\r
11105 <refpurpose>Target profile for <tag class="attribute">audience</tag>\r
11106 attribute</refpurpose>\r
11107 </refnamediv>\r
11108 \r
11109 <refsynopsisdiv>\r
11110 <programlisting xml:id="profile.audience.frag">\r
11111 &lt;xsl:param name="profile.audience"&gt;&lt;/xsl:param&gt;\r
11112 </programlisting>\r
11113 </refsynopsisdiv>\r
11114 \r
11115 <refsection><info><title>Description</title></info>\r
11116 \r
11117 <para>Value of this parameter specifies profiles which should be\r
11118 included in the output. You can specify multiple profiles by\r
11119 separating them by semicolon. You can change separator character by\r
11120 <parameter>profile.separator</parameter>\r
11121 parameter.</para>\r
11122 \r
11123 <para>This parameter has effect only when you are using profiling\r
11124 stylesheets (<filename>profile-docbook.xsl</filename>,\r
11125 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal\r
11126 ones (<filename>docbook.xsl</filename>,\r
11127 <filename>chunk.xsl</filename>, &#8230;).</para>\r
11128 \r
11129 </refsection>\r
11130 </refentry>\r
11131 \r
11132 <refentry version="5.0" xml:id="profile.condition">\r
11133 <refmeta>\r
11134 <refentrytitle>profile.condition</refentrytitle>\r
11135 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
11136 </refmeta>\r
11137 <refnamediv>\r
11138 <refname>profile.condition</refname>\r
11139 <refpurpose>Target profile for <tag class="attribute">condition</tag>\r
11140 attribute</refpurpose>\r
11141 </refnamediv>\r
11142 \r
11143 <refsynopsisdiv>\r
11144 <programlisting xml:id="profile.condition.frag">\r
11145 &lt;xsl:param name="profile.condition"&gt;&lt;/xsl:param&gt;\r
11146 </programlisting>\r
11147 </refsynopsisdiv>\r
11148 \r
11149 <refsection><info><title>Description</title></info>\r
11150 \r
11151 <para>The value of this parameter specifies profiles which should be\r
11152 included in the output. You can specify multiple profiles by\r
11153 separating them by semicolon. You can change separator character by\r
11154 <parameter>profile.separator</parameter>\r
11155 parameter.</para>\r
11156 \r
11157 <para>This parameter has effect only when you are using profiling\r
11158 stylesheets (<filename>profile-docbook.xsl</filename>,\r
11159 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal\r
11160 ones (<filename>docbook.xsl</filename>,\r
11161 <filename>chunk.xsl</filename>, &#8230;).</para>\r
11162 \r
11163 </refsection>\r
11164 </refentry>\r
11165 \r
11166 <refentry version="5.0" xml:id="profile.conformance">\r
11167 <refmeta>\r
11168 <refentrytitle>profile.conformance</refentrytitle>\r
11169 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
11170 </refmeta>\r
11171 <refnamediv>\r
11172 <refname>profile.conformance</refname>\r
11173 <refpurpose>Target profile for <tag class="attribute">conformance</tag>\r
11174 attribute</refpurpose>\r
11175 </refnamediv>\r
11176 \r
11177 <refsynopsisdiv>\r
11178 <programlisting xml:id="profile.conformance.frag">\r
11179 &lt;xsl:param name="profile.conformance"&gt;&lt;/xsl:param&gt;\r
11180 </programlisting>\r
11181 </refsynopsisdiv>\r
11182 \r
11183 <refsection><info><title>Description</title></info>\r
11184 \r
11185 <para>The value of this parameter specifies profiles which should be\r
11186 included in the output. You can specify multiple profiles by\r
11187 separating them by semicolon. You can change separator character by\r
11188 <parameter>profile.separator</parameter>\r
11189 parameter.</para>\r
11190 \r
11191 <para>This parameter has effect only when you are using profiling\r
11192 stylesheets (<filename>profile-docbook.xsl</filename>,\r
11193 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal\r
11194 ones (<filename>docbook.xsl</filename>,\r
11195 <filename>chunk.xsl</filename>, &#8230;).</para>\r
11196 \r
11197 </refsection>\r
11198 </refentry>\r
11199 \r
11200 <refentry version="5.0" xml:id="profile.lang">\r
11201 <refmeta>\r
11202 <refentrytitle>profile.lang</refentrytitle>\r
11203 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
11204 </refmeta>\r
11205 <refnamediv>\r
11206 <refname>profile.lang</refname>\r
11207 <refpurpose>Target profile for <tag class="attribute">lang</tag>\r
11208 attribute</refpurpose>\r
11209 </refnamediv>\r
11210 \r
11211 <refsynopsisdiv>\r
11212 <programlisting xml:id="profile.lang.frag">\r
11213 &lt;xsl:param name="profile.lang"&gt;&lt;/xsl:param&gt;\r
11214 </programlisting>\r
11215 </refsynopsisdiv>\r
11216 \r
11217 <refsection><info><title>Description</title></info>\r
11218 \r
11219 <para>The value of this parameter specifies profiles which should be\r
11220 included in the output. You can specify multiple profiles by\r
11221 separating them by semicolon. You can change separator character by\r
11222 <parameter>profile.separator</parameter>\r
11223 parameter.</para>\r
11224 \r
11225 <para>This parameter has effect only when you are using profiling\r
11226 stylesheets (<filename>profile-docbook.xsl</filename>,\r
11227 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal\r
11228 ones (<filename>docbook.xsl</filename>,\r
11229 <filename>chunk.xsl</filename>, &#8230;).</para>\r
11230 \r
11231 </refsection>\r
11232 </refentry>\r
11233 \r
11234 <refentry version="5.0" xml:id="profile.os">\r
11235 <refmeta>\r
11236 <refentrytitle>profile.os</refentrytitle>\r
11237 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
11238 </refmeta>\r
11239 <refnamediv>\r
11240 <refname>profile.os</refname>\r
11241 <refpurpose>Target profile for <tag class="attribute">os</tag>\r
11242 attribute</refpurpose>\r
11243 </refnamediv>\r
11244 \r
11245 <refsynopsisdiv>\r
11246 <programlisting xml:id="profile.os.frag">\r
11247 &lt;xsl:param name="profile.os"&gt;&lt;/xsl:param&gt;\r
11248 </programlisting>\r
11249 </refsynopsisdiv>\r
11250 \r
11251 <refsection><info><title>Description</title></info>\r
11252 \r
11253 <para>The value of this parameter specifies profiles which should be\r
11254 included in the output. You can specify multiple profiles by\r
11255 separating them by semicolon. You can change separator character by\r
11256 <parameter>profile.separator</parameter>\r
11257 parameter.</para>\r
11258 \r
11259 <para>This parameter has effect only when you are using profiling\r
11260 stylesheets (<filename>profile-docbook.xsl</filename>,\r
11261 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal\r
11262 ones (<filename>docbook.xsl</filename>,\r
11263 <filename>chunk.xsl</filename>, &#8230;).</para>\r
11264 \r
11265 </refsection>\r
11266 </refentry>\r
11267 \r
11268 <refentry version="5.0" xml:id="profile.revision">\r
11269 <refmeta>\r
11270 <refentrytitle>profile.revision</refentrytitle>\r
11271 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
11272 </refmeta>\r
11273 <refnamediv>\r
11274 <refname>profile.revision</refname>\r
11275 <refpurpose>Target profile for <tag class="attribute">revision</tag>\r
11276 attribute</refpurpose>\r
11277 </refnamediv>\r
11278 \r
11279 <refsynopsisdiv>\r
11280 <programlisting xml:id="profile.revision.frag">\r
11281 &lt;xsl:param name="profile.revision"&gt;&lt;/xsl:param&gt;\r
11282 </programlisting>\r
11283 </refsynopsisdiv>\r
11284 \r
11285 <refsection><info><title>Description</title></info>\r
11286 \r
11287 <para>The value of this parameter specifies profiles which should be\r
11288 included in the output. You can specify multiple profiles by\r
11289 separating them by semicolon. You can change separator character by\r
11290 <parameter>profile.separator</parameter>\r
11291 parameter.</para>\r
11292 \r
11293 <para>This parameter has effect only when you are using profiling\r
11294 stylesheets (<filename>profile-docbook.xsl</filename>,\r
11295 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal\r
11296 ones (<filename>docbook.xsl</filename>,\r
11297 <filename>chunk.xsl</filename>, &#8230;).</para>\r
11298 \r
11299 </refsection>\r
11300 </refentry>\r
11301 \r
11302 <refentry version="5.0" xml:id="profile.revisionflag">\r
11303 <refmeta>\r
11304 <refentrytitle>profile.revisionflag</refentrytitle>\r
11305 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
11306 </refmeta>\r
11307 <refnamediv>\r
11308 <refname>profile.revisionflag</refname>\r
11309 <refpurpose>Target profile for <tag class="attribute">revisionflag</tag>\r
11310 attribute</refpurpose>\r
11311 </refnamediv>\r
11312 \r
11313 <refsynopsisdiv>\r
11314 <programlisting xml:id="profile.revisionflag.frag">\r
11315 &lt;xsl:param name="profile.revisionflag"&gt;&lt;/xsl:param&gt;\r
11316 </programlisting>\r
11317 </refsynopsisdiv>\r
11318 \r
11319 <refsection><info><title>Description</title></info>\r
11320 \r
11321 <para>The value of this parameter specifies profiles which should be\r
11322 included in the output. You can specify multiple profiles by\r
11323 separating them by semicolon. You can change separator character by\r
11324 <parameter>profile.separator</parameter>\r
11325 parameter.</para>\r
11326 \r
11327 <para>This parameter has effect only when you are using profiling\r
11328 stylesheets (<filename>profile-docbook.xsl</filename>,\r
11329 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal\r
11330 ones (<filename>docbook.xsl</filename>,\r
11331 <filename>chunk.xsl</filename>, &#8230;).</para>\r
11332 \r
11333 </refsection>\r
11334 </refentry>\r
11335 \r
11336 <refentry version="5.0" xml:id="profile.role">\r
11337 <refmeta>\r
11338 <refentrytitle>profile.role</refentrytitle>\r
11339 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
11340 </refmeta>\r
11341 <refnamediv>\r
11342 <refname>profile.role</refname>\r
11343 <refpurpose>Target profile for <tag class="attribute">role</tag>\r
11344 attribute</refpurpose>\r
11345 </refnamediv>\r
11346 \r
11347 <refsynopsisdiv>\r
11348 <programlisting xml:id="profile.role.frag">\r
11349 &lt;xsl:param name="profile.role"&gt;&lt;/xsl:param&gt;\r
11350 </programlisting>\r
11351 </refsynopsisdiv>\r
11352 \r
11353 <refsection><info><title>Description</title></info>\r
11354 \r
11355 <para>The value of this parameter specifies profiles which should be\r
11356 included in the output. You can specify multiple profiles by\r
11357 separating them by semicolon. You can change separator character by\r
11358 <parameter>profile.separator</parameter>\r
11359 parameter.</para>\r
11360 \r
11361 <para>This parameter has effect only when you are using profiling\r
11362 stylesheets (<filename>profile-docbook.xsl</filename>,\r
11363 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal\r
11364 ones (<filename>docbook.xsl</filename>,\r
11365 <filename>chunk.xsl</filename>, &#8230;).</para>\r
11366 \r
11367 <warning>\r
11368 <para>Note that <tag class="attribute">role</tag> is often\r
11369 used for other purposes than profiling. For example it is commonly\r
11370 used to get emphasize in bold font:</para>\r
11371 \r
11372 <programlisting>&lt;emphasis role="bold"&gt;very important&lt;/emphasis&gt;</programlisting>\r
11373 \r
11374 <para>If you are using <tag class="attribute">role</tag> for\r
11375 these purposes do not forget to add values like <literal>bold</literal> to\r
11376 value of this parameter. If you forgot you will get document with\r
11377 small pieces missing which are very hard to track.</para>\r
11378 \r
11379 <para>For this reason it is not recommended to use <tag class="attribute">role</tag> attribute for profiling. You should\r
11380 rather use profiling specific attributes like <tag class="attribute">userlevel</tag>, <tag class="attribute">os</tag>, <tag class="attribute">arch</tag>, <tag class="attribute">condition</tag>, etc.</para>\r
11381 </warning>\r
11382 \r
11383 </refsection>\r
11384 </refentry>\r
11385 \r
11386 <refentry version="5.0" xml:id="profile.security">\r
11387 <refmeta>\r
11388 <refentrytitle>profile.security</refentrytitle>\r
11389 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
11390 </refmeta>\r
11391 <refnamediv>\r
11392 <refname>profile.security</refname>\r
11393 <refpurpose>Target profile for <tag class="attribute">security</tag>\r
11394 attribute</refpurpose>\r
11395 </refnamediv>\r
11396 \r
11397 <refsynopsisdiv>\r
11398 <programlisting xml:id="profile.security.frag">\r
11399 &lt;xsl:param name="profile.security"&gt;&lt;/xsl:param&gt;\r
11400 </programlisting>\r
11401 </refsynopsisdiv>\r
11402 \r
11403 <refsection><info><title>Description</title></info>\r
11404 \r
11405 <para>The value of this parameter specifies profiles which should be\r
11406 included in the output. You can specify multiple profiles by\r
11407 separating them by semicolon. You can change separator character by\r
11408 <parameter>profile.separator</parameter>\r
11409 parameter.</para>\r
11410 \r
11411 <para>This parameter has effect only when you are using profiling\r
11412 stylesheets (<filename>profile-docbook.xsl</filename>,\r
11413 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal\r
11414 ones (<filename>docbook.xsl</filename>,\r
11415 <filename>chunk.xsl</filename>, &#8230;).</para>\r
11416 \r
11417 </refsection>\r
11418 </refentry>\r
11419 \r
11420 <refentry version="5.0" xml:id="profile.status">\r
11421 <refmeta>\r
11422 <refentrytitle>profile.status</refentrytitle>\r
11423 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
11424 </refmeta>\r
11425 <refnamediv>\r
11426 <refname>profile.status</refname>\r
11427 <refpurpose>Target profile for <tag class="attribute">status</tag>\r
11428 attribute</refpurpose>\r
11429 </refnamediv>\r
11430 \r
11431 <refsynopsisdiv>\r
11432 <programlisting xml:id="profile.status.frag">\r
11433 &lt;xsl:param name="profile.status"&gt;&lt;/xsl:param&gt;\r
11434 </programlisting>\r
11435 </refsynopsisdiv>\r
11436 \r
11437 <refsection><info><title>Description</title></info>\r
11438 \r
11439 <para>The value of this parameter specifies profiles which should be\r
11440 included in the output. You can specify multiple profiles by\r
11441 separating them by semicolon. You can change separator character by\r
11442 <parameter>profile.separator</parameter>\r
11443 parameter.</para>\r
11444 \r
11445 <para>This parameter has effect only when you are using profiling\r
11446 stylesheets (<filename>profile-docbook.xsl</filename>,\r
11447 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal\r
11448 ones (<filename>docbook.xsl</filename>,\r
11449 <filename>chunk.xsl</filename>, &#8230;).</para>\r
11450 \r
11451 </refsection>\r
11452 </refentry>\r
11453 \r
11454 <refentry version="5.0" xml:id="profile.userlevel">\r
11455 <refmeta>\r
11456 <refentrytitle>profile.userlevel</refentrytitle>\r
11457 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
11458 </refmeta>\r
11459 <refnamediv>\r
11460 <refname>profile.userlevel</refname>\r
11461 <refpurpose>Target profile for <tag class="attribute">userlevel</tag>\r
11462 attribute</refpurpose>\r
11463 </refnamediv>\r
11464 \r
11465 <refsynopsisdiv>\r
11466 <programlisting xml:id="profile.userlevel.frag">\r
11467 &lt;xsl:param name="profile.userlevel"&gt;&lt;/xsl:param&gt;\r
11468 </programlisting>\r
11469 </refsynopsisdiv>\r
11470 \r
11471 <refsection><info><title>Description</title></info>\r
11472 \r
11473 <para>The value of this parameter specifies profiles which should be\r
11474 included in the output. You can specify multiple profiles by\r
11475 separating them by semicolon. You can change separator character by\r
11476 <parameter>profile.separator</parameter>\r
11477 parameter.</para>\r
11478 \r
11479 <para>This parameter has effect only when you are using profiling\r
11480 stylesheets (<filename>profile-docbook.xsl</filename>,\r
11481 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal\r
11482 ones (<filename>docbook.xsl</filename>,\r
11483 <filename>chunk.xsl</filename>, &#8230;).</para>\r
11484 \r
11485 </refsection>\r
11486 </refentry>\r
11487 \r
11488 <refentry version="5.0" xml:id="profile.vendor">\r
11489 <refmeta>\r
11490 <refentrytitle>profile.vendor</refentrytitle>\r
11491 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
11492 </refmeta>\r
11493 <refnamediv>\r
11494 <refname>profile.vendor</refname>\r
11495 <refpurpose>Target profile for <tag class="attribute">vendor</tag>\r
11496 attribute</refpurpose>\r
11497 </refnamediv>\r
11498 \r
11499 <refsynopsisdiv>\r
11500 <programlisting xml:id="profile.vendor.frag">\r
11501 &lt;xsl:param name="profile.vendor"&gt;&lt;/xsl:param&gt;\r
11502 </programlisting>\r
11503 </refsynopsisdiv>\r
11504 \r
11505 <refsection><info><title>Description</title></info>\r
11506 \r
11507 <para>The value of this parameter specifies profiles which should be\r
11508 included in the output. You can specify multiple profiles by\r
11509 separating them by semicolon. You can change separator character by\r
11510 <parameter>profile.separator</parameter>\r
11511 parameter.</para>\r
11512 \r
11513 <para>This parameter has effect only when you are using profiling\r
11514 stylesheets (<filename>profile-docbook.xsl</filename>,\r
11515 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal\r
11516 ones (<filename>docbook.xsl</filename>,\r
11517 <filename>chunk.xsl</filename>, &#8230;).</para>\r
11518 \r
11519 </refsection>\r
11520 </refentry>\r
11521 \r
11522 <refentry version="5.0" xml:id="profile.wordsize">\r
11523 <refmeta>\r
11524 <refentrytitle>profile.wordsize</refentrytitle>\r
11525 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
11526 </refmeta>\r
11527 <refnamediv>\r
11528 <refname>profile.wordsize</refname>\r
11529 <refpurpose>Target profile for <tag class="attribute">wordsize</tag>\r
11530 attribute</refpurpose>\r
11531 </refnamediv>\r
11532 \r
11533 <refsynopsisdiv>\r
11534 <programlisting xml:id="profile.wordsize.frag">\r
11535 &lt;xsl:param name="profile.wordsize"&gt;&lt;/xsl:param&gt;\r
11536 </programlisting>\r
11537 </refsynopsisdiv>\r
11538 \r
11539 <refsection><info><title>Description</title></info>\r
11540 \r
11541 <para>The value of this parameter specifies profiles which should be\r
11542 included in the output. You can specify multiple profiles by\r
11543 separating them by semicolon. You can change separator character by\r
11544 <parameter>profile.separator</parameter>\r
11545 parameter.</para>\r
11546 \r
11547 <para>This parameter has effect only when you are using profiling\r
11548 stylesheets (<filename>profile-docbook.xsl</filename>,\r
11549 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal\r
11550 ones (<filename>docbook.xsl</filename>,\r
11551 <filename>chunk.xsl</filename>, &#8230;).</para>\r
11552 \r
11553 </refsection>\r
11554 </refentry>\r
11555 \r
11556 <refentry version="5.0" xml:id="profile.attribute">\r
11557 <refmeta>\r
11558 <refentrytitle>profile.attribute</refentrytitle>\r
11559 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
11560 </refmeta>\r
11561 <refnamediv>\r
11562 <refname>profile.attribute</refname>\r
11563 <refpurpose>Name of user-specified profiling attribute</refpurpose>\r
11564 </refnamediv>\r
11565 \r
11566 <refsynopsisdiv>\r
11567 <programlisting xml:id="profile.attribute.frag">\r
11568 &lt;xsl:param name="profile.attribute"&gt;&lt;/xsl:param&gt;\r
11569 </programlisting>\r
11570 </refsynopsisdiv>\r
11571 \r
11572 <refsection><info><title>Description</title></info>\r
11573 \r
11574 <para>This parameter is used in conjuction with\r
11575 <parameter>profile.value</parameter>.</para>\r
11576 \r
11577 <para>This parameter has effect only when you are using profiling\r
11578 stylesheets (<filename>profile-docbook.xsl</filename>,\r
11579 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal\r
11580 ones (<filename>docbook.xsl</filename>,\r
11581 <filename>chunk.xsl</filename>, &#8230;).</para>\r
11582 \r
11583 </refsection>\r
11584 </refentry>\r
11585 \r
11586 <refentry version="5.0" xml:id="profile.value">\r
11587 <refmeta>\r
11588 <refentrytitle>profile.value</refentrytitle>\r
11589 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
11590 </refmeta>\r
11591 <refnamediv>\r
11592 <refname>profile.value</refname>\r
11593 <refpurpose>Target profile for user-specified attribute</refpurpose>\r
11594 </refnamediv>\r
11595 \r
11596 <refsynopsisdiv>\r
11597 <programlisting xml:id="profile.value.frag">\r
11598 &lt;xsl:param name="profile.value"&gt;&lt;/xsl:param&gt;\r
11599 </programlisting>\r
11600 </refsynopsisdiv>\r
11601 \r
11602 <refsection><info><title>Description</title></info>\r
11603 \r
11604 <para>When you are using this parameter you must also specify name of\r
11605 profiling attribute with parameter\r
11606 <parameter>profile.attribute</parameter>.</para>\r
11607 \r
11608 <para>The value of this parameter specifies profiles which should be\r
11609 included in the output. You can specify multiple profiles by\r
11610 separating them by semicolon. You can change separator character by\r
11611 <parameter>profile.separator</parameter>\r
11612 parameter.</para>\r
11613 \r
11614 <para>This parameter has effect only when you are using profiling\r
11615 stylesheets (<filename>profile-docbook.xsl</filename>,\r
11616 <filename>profile-chunk.xsl</filename>, &#8230;) instead of normal\r
11617 ones (<filename>docbook.xsl</filename>,\r
11618 <filename>chunk.xsl</filename>, &#8230;).</para>\r
11619 \r
11620 </refsection>\r
11621 </refentry>\r
11622 \r
11623 <refentry version="5.0" xml:id="profile.separator">\r
11624 <refmeta>\r
11625 <refentrytitle>profile.separator</refentrytitle>\r
11626 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
11627 </refmeta>\r
11628 <refnamediv>\r
11629 <refname>profile.separator</refname>\r
11630 <refpurpose>Separator character for compound profile values</refpurpose>\r
11631 </refnamediv>\r
11632 \r
11633 <refsynopsisdiv>\r
11634 <programlisting xml:id="profile.separator.frag">\r
11635 &lt;xsl:param name="profile.separator"&gt;;&lt;/xsl:param&gt;\r
11636 </programlisting>\r
11637 </refsynopsisdiv>\r
11638 \r
11639 <refsection><info><title>Description</title></info>\r
11640 \r
11641 <para>Separator character used for compound profile values. See <parameter>profile.arch</parameter></para>\r
11642 \r
11643 </refsection>\r
11644 </refentry>\r
11645 \r
11646 </reference>\r
11647 <reference xml:id="l10n"><title>Localization</title>\r
11648 <refentry version="5.0" xml:id="l10n.gentext.language">\r
11649 <refmeta>\r
11650 <refentrytitle>l10n.gentext.language</refentrytitle>\r
11651 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
11652 </refmeta>\r
11653 <refnamediv>\r
11654 <refname>l10n.gentext.language</refname>\r
11655 <refpurpose>Sets the gentext language</refpurpose>\r
11656 </refnamediv>\r
11657 \r
11658 <refsynopsisdiv>\r
11659 <programlisting xml:id="l10n.gentext.language.frag">\r
11660 &lt;xsl:param name="l10n.gentext.language"&gt;&lt;/xsl:param&gt;\r
11661 </programlisting>\r
11662 </refsynopsisdiv>\r
11663 \r
11664 <refsection><info><title>Description</title></info>\r
11665 \r
11666 <para>If this parameter is set to any value other than the empty string, its\r
11667 value will be used as the value for the language when generating text. Setting\r
11668 <parameter>l10n.gentext.language</parameter> overrides any settings within the\r
11669 document being formatted.</para>\r
11670 \r
11671 <para>It's much more likely that you might want to set the\r
11672 <parameter>l10n.gentext.default.language</parameter> parameter.</para>\r
11673 \r
11674 </refsection>\r
11675 </refentry>\r
11676 \r
11677 <refentry version="5.0" xml:id="l10n.gentext.default.language">\r
11678   <refmeta>\r
11679     <refentrytitle>l10n.gentext.default.language</refentrytitle>\r
11680     <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
11681   </refmeta>\r
11682   <refnamediv>\r
11683     <refname>l10n.gentext.default.language</refname>\r
11684     <refpurpose>Sets the default language for generated text</refpurpose>\r
11685   </refnamediv>\r
11686 \r
11687   <refsynopsisdiv>\r
11688 <programlisting xml:id="l10n.gentext.default.language.frag">\r
11689 &lt;xsl:param name="l10n.gentext.default.language"&gt;en&lt;/xsl:param&gt;\r
11690 </programlisting>\r
11691 </refsynopsisdiv>\r
11692 \r
11693 <refsection><info><title>Description</title></info>\r
11694 \r
11695 <para>The value of the <parameter>l10n.gentext.default.language</parameter>\r
11696 parameter is used as the language for generated text if no setting is provided\r
11697 in the source document.</para>\r
11698 \r
11699 </refsection>\r
11700 </refentry>\r
11701 \r
11702 <refentry version="5.0" xml:id="l10n.gentext.use.xref.language">\r
11703 <refmeta>\r
11704 <refentrytitle>l10n.gentext.use.xref.language</refentrytitle>\r
11705 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
11706 </refmeta>\r
11707 <refnamediv>\r
11708 <refname>l10n.gentext.use.xref.language</refname>\r
11709 <refpurpose>Use the language of target when generating cross-reference text?</refpurpose>\r
11710 </refnamediv>\r
11711 \r
11712 <refsynopsisdiv>\r
11713 <programlisting xml:id="l10n.gentext.use.xref.language.frag">\r
11714 &lt;xsl:param name="l10n.gentext.use.xref.language" select="0"&gt;&lt;/xsl:param&gt;\r
11715 </programlisting>\r
11716 </refsynopsisdiv>\r
11717 \r
11718 <refsection><info><title>Description</title></info>\r
11719 \r
11720 <para>If non-zero, the language of the target will be used when\r
11721 generating cross reference text. Usually, the <quote>current</quote>\r
11722 language is used when generating text (that is, the language of the\r
11723 element that contains the cross-reference element). But setting this parameter\r
11724 allows the language of the element <emphasis>pointed to</emphasis> to control\r
11725 the generated text.</para>\r
11726 \r
11727 <para>Consider the following example:</para>\r
11728 \r
11729 <informalexample>\r
11730 <programlisting>&lt;para lang="en"&gt;See also &lt;xref linkend="chap3"/&gt;.&lt;/para&gt;\r
11731 </programlisting>\r
11732 </informalexample>\r
11733 \r
11734 <para>Suppose that Chapter 3 happens to be written in German.\r
11735 If <parameter>l10n.gentext.use.xref.language</parameter> is non-zero, the\r
11736 resulting text will be something like this:</para>\r
11737 \r
11738 <blockquote>\r
11739 <para>See also Kapital 3.</para>\r
11740 </blockquote>\r
11741 \r
11742 <para>Where the more traditional rendering would be:</para>\r
11743 \r
11744 <blockquote>\r
11745 <para>See also Chapter 3.</para>\r
11746 </blockquote>\r
11747 \r
11748 </refsection>\r
11749 </refentry>\r
11750 \r
11751 <refentry version="5.0" xml:id="l10n.lang.value.rfc.compliant">\r
11752 <refmeta>\r
11753 <refentrytitle>l10n.lang.value.rfc.compliant</refentrytitle>\r
11754 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
11755 </refmeta>\r
11756 <refnamediv>\r
11757 <refname>l10n.lang.value.rfc.compliant</refname>\r
11758 <refpurpose>Make value of lang attribute RFC compliant?</refpurpose>\r
11759 </refnamediv>\r
11760 \r
11761 <refsynopsisdiv>\r
11762 <programlisting xml:id="l10n.lang.value.rfc.compliant.frag">\r
11763 &lt;xsl:param name="l10n.lang.value.rfc.compliant" select="1"&gt;&lt;/xsl:param&gt;\r
11764 </programlisting>\r
11765 </refsynopsisdiv>\r
11766 \r
11767 <refsection><info><title>Description</title></info>\r
11768 \r
11769 <para>If non-zero, ensure that the values for all <tag class="attribute">lang</tag> attributes in HTML output are RFC\r
11770 compliant<footnote><para>Section 8.1.1, <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.w3.org/TR/REC-html40/struct/dirlang.html#h-8.1.1">Language Codes</link>, in the HTML 4.0 Recommendation states that:\r
11771 \r
11772 <blockquote><para>[RFC1766] defines and explains the language codes\r
11773 that must be used in HTML documents.</para>\r
11774 <para>Briefly, language codes consist of a primary code and a possibly\r
11775 empty series of subcodes:\r
11776 \r
11777 <literallayout class="monospaced">language-code = primary-code ( "-" subcode )*</literallayout>\r
11778 </para>\r
11779 <para>And in RFC 1766, <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.ietf.org/rfc/rfc1766.txt">Tags for the Identification\r
11780 of Languages</link>, the EBNF for "language tag" is given as:\r
11781 \r
11782 <literallayout class="monospaced">Language-Tag = Primary-tag *( "-" Subtag )\r
11783 Primary-tag = 1*8ALPHA\r
11784 Subtag = 1*8ALPHA</literallayout>\r
11785 </para>\r
11786 </blockquote>\r
11787 </para></footnote>.\r
11788 \r
11789 by taking any underscore characters in any <tag class="attribute">lang</tag> values found in source documents, and\r
11790 replacing them with hyphen characters in output HTML files. For\r
11791 example, <literal>zh_CN</literal> in a source document becomes\r
11792 <literal>zh-CN</literal> in the HTML output form that source.\r
11793 \r
11794 <note>\r
11795 <para>This parameter does not cause any case change in <tag class="attribute">lang</tag> values, because RFC 1766\r
11796 explicitly states that all "language tags" (as it calls them) "are\r
11797 to be treated as case insensitive".</para>\r
11798 </note>\r
11799 </para>\r
11800 \r
11801 </refsection>\r
11802 </refentry>\r
11803 \r
11804 <refentry version="5.0" xml:id="writing.mode">\r
11805 <refmeta>\r
11806 <refentrytitle>writing.mode</refentrytitle>\r
11807 <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>\r
11808 </refmeta>\r
11809 <refnamediv>\r
11810 <refname>writing.mode</refname>\r
11811 <refpurpose>Direction of text flow based on locale</refpurpose>\r
11812 </refnamediv>\r
11813 \r
11814 <refsynopsisdiv>\r
11815 <programlisting xml:id="writing.mode.frag">\r
11816 &lt;xsl:param name="writing.mode"&gt;\r
11817   &lt;xsl:call-template name="gentext"&gt;\r
11818     &lt;xsl:with-param name="key"&gt;writing-mode&lt;/xsl:with-param&gt;\r
11819     &lt;xsl:with-param name="lang"&gt;\r
11820       &lt;xsl:call-template name="l10n.language"&gt;\r
11821         &lt;xsl:with-param name="target" select="/*[1]"&gt;&lt;/xsl:with-param&gt;\r
11822       &lt;/xsl:call-template&gt;\r
11823     &lt;/xsl:with-param&gt;\r
11824   &lt;/xsl:call-template&gt;\r
11825 &lt;/xsl:param&gt;\r
11826 </programlisting>\r
11827 </refsynopsisdiv>\r
11828 \r
11829 <refsection><info><title>Description</title></info>\r
11830 \r
11831 <para>Sets direction of text flow and text alignment based on locale.\r
11832 The value is normally taken from the gentext file for the \r
11833 lang attribute of the document's root element, using the \r
11834 key name 'writing-mode' to look it up in the gentext file.\r
11835 But the param can also be\r
11836 set on the command line to override that gentext value.\r
11837 </para>\r
11838 <para>Accepted values are:\r
11839 <variablelist>\r
11840   <varlistentry>\r
11841     <term>lr-tb</term>\r
11842     <listitem>\r
11843       <para>Left-to-right text flow in each line, lines stack top to bottom.</para>\r
11844     </listitem>\r
11845   </varlistentry>\r
11846   <varlistentry>\r
11847     <term>rl-tb</term>\r
11848     <listitem>\r
11849       <para>Right-to-left text flow in each line, lines stack top to bottom.</para>\r
11850     </listitem>\r
11851   </varlistentry>\r
11852   <varlistentry>\r
11853     <term>tb-rl</term>\r
11854     <listitem>\r
11855       <para>Top-to-bottom text flow in each vertical line, lines stack right to left.\r
11856       Supported by only a few XSL-FO processors. Not supported in HTML output.</para>\r
11857     </listitem>\r
11858   </varlistentry>\r
11859   <varlistentry>\r
11860     <term>lr</term>\r
11861     <listitem>\r
11862       <para>Shorthand for lr-tb.</para>\r
11863     </listitem>\r
11864   </varlistentry>\r
11865   <varlistentry>\r
11866     <term>rl</term>\r
11867     <listitem>\r
11868       <para>Shorthand for rl-tb.</para>\r
11869     </listitem>\r
11870   </varlistentry>\r
11871   <varlistentry>\r
11872     <term>tb</term>\r
11873     <listitem>\r
11874       <para>Shorthand for tb-rl.</para>\r
11875     </listitem>\r
11876   </varlistentry>\r
11877 </variablelist>\r
11878 </para>\r
11879 \r
11880 </refsection>\r
11881 </refentry>\r
11882 \r
11883 </reference>\r
11884 <reference xml:id="ebnf"><title>EBNF</title>\r
11885 <refentry version="5.0" xml:id="ebnf.assignment">\r
11886 <refmeta>\r
11887 <refentrytitle>ebnf.assignment</refentrytitle>\r
11888 <refmiscinfo class="other" otherclass="datatype">rtf</refmiscinfo>\r
11889 </refmeta>\r
11890 <refnamediv>\r
11891 <refname>ebnf.assignment</refname>\r
11892 <refpurpose>The EBNF production assignment operator</refpurpose>\r
11893 </refnamediv>\r
11894 \r
11895 <refsynopsisdiv>\r
11896 <programlisting xml:id="ebnf.assignment.frag">\r
11897 \r
11898 &lt;xsl:param name="ebnf.assignment"&gt;\r
11899   &lt;fo:inline font-family="{$monospace.font.family}"&gt;\r
11900     &lt;xsl:text&gt;::=&lt;/xsl:text&gt;\r
11901   &lt;/fo:inline&gt;\r
11902 &lt;/xsl:param&gt;\r
11903 </programlisting>\r
11904 </refsynopsisdiv>\r
11905 \r
11906 <refsection><info><title>Description</title></info>\r
11907 \r
11908 <para>The <parameter>ebnf.assignment</parameter> parameter determines what\r
11909 text is used to show <quote>assignment</quote> in <tag>production</tag>s\r
11910 in <tag>productionset</tag>s.</para>\r
11911 \r
11912 <para>While <quote><literal>::=</literal></quote> is common, so are several\r
11913 other operators.</para>\r
11914 \r
11915 </refsection>\r
11916 </refentry>\r
11917 \r
11918 <refentry version="5.0" xml:id="ebnf.statement.terminator">\r
11919 <refmeta>\r
11920 <refentrytitle>ebnf.statement.terminator</refentrytitle>\r
11921 <refmiscinfo class="other" otherclass="datatype">rtf</refmiscinfo>\r
11922 </refmeta>\r
11923 <refnamediv>\r
11924 <refname>ebnf.statement.terminator</refname>\r
11925 <refpurpose>Punctuation that ends an EBNF statement.</refpurpose>\r
11926 </refnamediv>\r
11927 \r
11928 <refsynopsisdiv>\r
11929 <programlisting xml:id="ebnf.statement.terminator.frag">\r
11930 \r
11931 &lt;xsl:param name="ebnf.statement.terminator"&gt;&lt;/xsl:param&gt;\r
11932 </programlisting>\r
11933 </refsynopsisdiv>\r
11934 \r
11935 <refsection><info><title>Description</title></info>\r
11936 \r
11937 <para>The <parameter>ebnf.statement.terminator</parameter> parameter determines what\r
11938 text is used to terminate each <tag>production</tag>\r
11939 in <tag>productionset</tag>.</para>\r
11940 \r
11941 <para>Some notations end each statement with a period.</para>\r
11942 \r
11943 </refsection>\r
11944 </refentry>\r
11945 \r
11946 </reference>\r
11947 <reference xml:id="prepress"><title>Prepress</title>\r
11948 <refentry version="5.0" xml:id="crop.marks">\r
11949 <refmeta>\r
11950 <refentrytitle>crop.marks</refentrytitle>\r
11951 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>\r
11952 </refmeta>\r
11953 <refnamediv>\r
11954 <refname>crop.marks</refname>\r
11955 <refpurpose>Output crop marks?</refpurpose>\r
11956 </refnamediv>\r
11957 \r
11958 <refsynopsisdiv>\r
11959 <programlisting xml:id="crop.marks.frag">\r
11960 &lt;xsl:param name="crop.marks" select="0"&gt;&lt;/xsl:param&gt;\r
11961 </programlisting>\r
11962 </refsynopsisdiv>\r
11963 \r
11964 <refsection><info><title>Description</title></info>\r
11965 \r
11966 <para>If non-zero, crop marks will be added to each page. Currently this\r
11967 works only with XEP if you have <parameter>xep.extensions</parameter> set.</para>\r
11968 \r
11969 </refsection>\r
11970 </refentry>\r
11971 \r
11972 <refentry version="5.0" xml:id="crop.mark.width">\r
11973 <refmeta>\r
11974 <refentrytitle>crop.mark.width</refentrytitle>\r
11975 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
11976 </refmeta>\r
11977 <refnamediv>\r
11978 <refname>crop.mark.width</refname>\r
11979 <refpurpose>Width of crop marks.</refpurpose>\r
11980 </refnamediv>\r
11981 \r
11982 <refsynopsisdiv>\r
11983 <programlisting xml:id="crop.mark.width.frag">\r
11984 &lt;xsl:param name="crop.mark.width"&gt;0.5pt&lt;/xsl:param&gt;\r
11985 </programlisting>\r
11986 </refsynopsisdiv>\r
11987 \r
11988 <refsection><info><title>Description</title></info>\r
11989 \r
11990 <para>Width of crop marks. Crop marks are controlled by\r
11991 <parameter>crop.marks</parameter> parameter.</para>\r
11992 \r
11993 </refsection>\r
11994 </refentry>\r
11995 \r
11996 <refentry version="5.0" xml:id="crop.mark.offset">\r
11997 <refmeta>\r
11998 <refentrytitle>crop.mark.offset</refentrytitle>\r
11999 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
12000 </refmeta>\r
12001 <refnamediv>\r
12002 <refname>crop.mark.offset</refname>\r
12003 <refpurpose>Length of crop marks.</refpurpose>\r
12004 </refnamediv>\r
12005 \r
12006 <refsynopsisdiv>\r
12007 <programlisting xml:id="crop.mark.offset.frag">\r
12008 &lt;xsl:param name="crop.mark.offset"&gt;24pt&lt;/xsl:param&gt;\r
12009 </programlisting>\r
12010 </refsynopsisdiv>\r
12011 \r
12012 <refsection><info><title>Description</title></info>\r
12013 \r
12014 <para>Length of crop marks. Crop marks are controlled by\r
12015 <parameter>crop.marks</parameter> parameter.</para>\r
12016 \r
12017 </refsection>\r
12018 </refentry>\r
12019 \r
12020 <refentry version="5.0" xml:id="crop.mark.bleed">\r
12021 <refmeta>\r
12022 <refentrytitle>crop.mark.bleed</refentrytitle>\r
12023 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>\r
12024 </refmeta>\r
12025 <refnamediv>\r
12026 <refname>crop.mark.bleed</refname>\r
12027 <refpurpose>Length of invisible part of crop marks.</refpurpose>\r
12028 </refnamediv>\r
12029 \r
12030 <refsynopsisdiv>\r
12031 <programlisting xml:id="crop.mark.bleed.frag">\r
12032 &lt;xsl:param name="crop.mark.bleed"&gt;6pt&lt;/xsl:param&gt;\r
12033 </programlisting>\r
12034 </refsynopsisdiv>\r
12035 \r
12036 <refsection><info><title>Description</title></info>\r
12037 \r
12038 <para>Length of invisible part of crop marks. Crop marks are controlled by\r
12039 <parameter>crop.marks</parameter> parameter.</para>\r
12040 \r
12041 </refsection>\r
12042 </refentry>\r
12043 \r
12044 </reference>\r
12045 \r
12046 <appendix xml:id="stylesheet"><title>The Stylesheet</title>\r
12047 \r
12048 <para>The <filename>param.xsl</filename> stylesheet is just a wrapper\r
12049 around all these parameters.</para>\r
12050 \r
12051 <programlisting xml:id="top">\r
12052 &lt;xsl:stylesheet exclude-result-prefixes="src" version="1.0"&gt;\r
12053 \r
12054 &lt;!-- This file is generated from param.xweb --&gt;\r
12055 \r
12056 &lt;!-- ********************************************************************\r
12057      $Id: param.xweb 8392 2009-04-01 08:47:55Z bobstayton $\r
12058      ********************************************************************\r
12059 \r
12060      This file is part of the XSL DocBook Stylesheet distribution.\r
12061      See ../README or http://docbook.sf.net/release/xsl/current/ for\r
12062      copyright and other information.\r
12063 \r
12064      ******************************************************************** --&gt;\r
12065 \r
12066 &lt;src:fragref linkend="abstract.properties.frag"&gt;&lt;/src:fragref&gt;\r
12067 &lt;src:fragref linkend="abstract.title.properties.frag"&gt;&lt;/src:fragref&gt;\r
12068 &lt;src:fragref linkend="admon.graphics.extension.frag"&gt;&lt;/src:fragref&gt;\r
12069 &lt;src:fragref linkend="admon.graphics.frag"&gt;&lt;/src:fragref&gt;\r
12070 &lt;src:fragref linkend="admon.graphics.path.frag"&gt;&lt;/src:fragref&gt;\r
12071 &lt;src:fragref linkend="admon.textlabel.frag"&gt;&lt;/src:fragref&gt;\r
12072 &lt;src:fragref linkend="admonition.properties.frag"&gt;&lt;/src:fragref&gt;\r
12073 &lt;src:fragref linkend="admonition.title.properties.frag"&gt;&lt;/src:fragref&gt;\r
12074 &lt;src:fragref linkend="graphical.admonition.properties.frag"&gt;&lt;/src:fragref&gt;\r
12075 &lt;src:fragref linkend="nongraphical.admonition.properties.frag"&gt;&lt;/src:fragref&gt;\r
12076 &lt;src:fragref linkend="alignment.frag"&gt;&lt;/src:fragref&gt;\r
12077 &lt;src:fragref linkend="appendix.autolabel.frag"&gt;&lt;/src:fragref&gt;\r
12078 &lt;src:fragref linkend="arbortext.extensions.frag"&gt;&lt;/src:fragref&gt;\r
12079 &lt;src:fragref linkend="article.appendix.title.properties.frag"&gt;&lt;/src:fragref&gt;\r
12080 &lt;src:fragref linkend="author.othername.in.middle.frag"&gt;&lt;/src:fragref&gt;\r
12081 &lt;src:fragref linkend="autotoc.label.separator.frag"&gt;&lt;/src:fragref&gt;\r
12082 &lt;src:fragref linkend="axf.extensions.frag"&gt;&lt;/src:fragref&gt;\r
12083 &lt;src:fragref linkend="biblioentry.item.separator.frag"&gt;&lt;/src:fragref&gt;\r
12084 &lt;src:fragref linkend="biblioentry.properties.frag"&gt;&lt;/src:fragref&gt;\r
12085 &lt;src:fragref linkend="bibliography.collection.frag"&gt;&lt;/src:fragref&gt;\r
12086 &lt;src:fragref linkend="bibliography.numbered.frag"&gt;&lt;/src:fragref&gt;\r
12087 &lt;src:fragref linkend="bibliography.style.frag"&gt;&lt;/src:fragref&gt;\r
12088 &lt;src:fragref linkend="blockquote.properties.frag"&gt;&lt;/src:fragref&gt;\r
12089 &lt;src:fragref linkend="body.font.family.frag"&gt;&lt;/src:fragref&gt;\r
12090 &lt;src:fragref linkend="body.font.master.frag"&gt;&lt;/src:fragref&gt;\r
12091 &lt;src:fragref linkend="body.font.size.frag"&gt;&lt;/src:fragref&gt;\r
12092 &lt;src:fragref linkend="body.margin.bottom.frag"&gt;&lt;/src:fragref&gt;\r
12093 &lt;src:fragref linkend="body.margin.top.frag"&gt;&lt;/src:fragref&gt;\r
12094 &lt;src:fragref linkend="body.start.indent.frag"&gt;&lt;/src:fragref&gt;\r
12095 &lt;src:fragref linkend="body.end.indent.frag"&gt;&lt;/src:fragref&gt;\r
12096 &lt;src:fragref linkend="bookmarks.collapse.frag"&gt;&lt;/src:fragref&gt;\r
12097 &lt;src:fragref linkend="bridgehead.in.toc.frag"&gt;&lt;/src:fragref&gt;\r
12098 &lt;src:fragref linkend="callout.defaultcolumn.frag"&gt;&lt;/src:fragref&gt;\r
12099 &lt;src:fragref linkend="callout.graphics.extension.frag"&gt;&lt;/src:fragref&gt;\r
12100 &lt;src:fragref linkend="callout.graphics.frag"&gt;&lt;/src:fragref&gt;\r
12101 &lt;src:fragref linkend="callout.icon.size.frag"&gt;&lt;/src:fragref&gt;\r
12102 &lt;src:fragref linkend="callout.graphics.number.limit.frag"&gt;&lt;/src:fragref&gt;\r
12103 &lt;src:fragref linkend="callout.graphics.path.frag"&gt;&lt;/src:fragref&gt;\r
12104 &lt;src:fragref linkend="callout.unicode.font.frag"&gt;&lt;/src:fragref&gt;\r
12105 &lt;src:fragref linkend="callout.unicode.frag"&gt;&lt;/src:fragref&gt;\r
12106 &lt;src:fragref linkend="callout.unicode.number.limit.frag"&gt;&lt;/src:fragref&gt;\r
12107 &lt;src:fragref linkend="callout.unicode.start.character.frag"&gt;&lt;/src:fragref&gt;\r
12108 &lt;src:fragref linkend="callouts.extension.frag"&gt;&lt;/src:fragref&gt;\r
12109 &lt;src:fragref linkend="chapter.autolabel.frag"&gt;&lt;/src:fragref&gt;\r
12110 &lt;src:fragref linkend="collect.xref.targets.frag"&gt;&lt;/src:fragref&gt;\r
12111 &lt;src:fragref linkend="column.count.back.frag"&gt;&lt;/src:fragref&gt;\r
12112 &lt;src:fragref linkend="column.count.body.frag"&gt;&lt;/src:fragref&gt;\r
12113 &lt;src:fragref linkend="column.count.front.frag"&gt;&lt;/src:fragref&gt;\r
12114 &lt;src:fragref linkend="column.count.index.frag"&gt;&lt;/src:fragref&gt;\r
12115 &lt;src:fragref linkend="column.count.lot.frag"&gt;&lt;/src:fragref&gt;\r
12116 &lt;src:fragref linkend="column.count.titlepage.frag"&gt;&lt;/src:fragref&gt;\r
12117 &lt;src:fragref linkend="column.gap.back.frag"&gt;&lt;/src:fragref&gt;\r
12118 &lt;src:fragref linkend="column.gap.body.frag"&gt;&lt;/src:fragref&gt;\r
12119 &lt;src:fragref linkend="column.gap.front.frag"&gt;&lt;/src:fragref&gt;\r
12120 &lt;src:fragref linkend="column.gap.index.frag"&gt;&lt;/src:fragref&gt;\r
12121 &lt;src:fragref linkend="column.gap.lot.frag"&gt;&lt;/src:fragref&gt;\r
12122 &lt;src:fragref linkend="column.gap.titlepage.frag"&gt;&lt;/src:fragref&gt;\r
12123 &lt;src:fragref linkend="compact.list.item.spacing.frag"&gt;&lt;/src:fragref&gt;\r
12124 &lt;src:fragref linkend="component.label.includes.part.label.frag"&gt;&lt;/src:fragref&gt;\r
12125 &lt;src:fragref linkend="component.title.properties.frag"&gt;&lt;/src:fragref&gt;\r
12126 &lt;src:fragref linkend="component.titlepage.properties.frag"&gt;&lt;/src:fragref&gt;\r
12127 &lt;src:fragref linkend="crop.marks.frag"&gt;&lt;/src:fragref&gt;\r
12128 &lt;src:fragref linkend="crop.mark.width.frag"&gt;&lt;/src:fragref&gt;\r
12129 &lt;src:fragref linkend="crop.mark.offset.frag"&gt;&lt;/src:fragref&gt;\r
12130 &lt;src:fragref linkend="crop.mark.bleed.frag"&gt;&lt;/src:fragref&gt;\r
12131 &lt;src:fragref linkend="current.docid.frag"&gt;&lt;/src:fragref&gt;\r
12132 &lt;src:fragref linkend="default.float.class.frag"&gt;&lt;/src:fragref&gt;\r
12133 &lt;src:fragref linkend="default.image.width.frag"&gt;&lt;/src:fragref&gt;\r
12134 &lt;src:fragref linkend="default.table.width.frag"&gt;&lt;/src:fragref&gt;\r
12135 &lt;src:fragref linkend="default.table.frame.frag"&gt;&lt;/src:fragref&gt;\r
12136 &lt;src:fragref linkend="default.table.rules.frag"&gt;&lt;/src:fragref&gt;\r
12137 &lt;src:fragref linkend="default.units.frag"&gt;&lt;/src:fragref&gt;\r
12138 &lt;src:fragref linkend="dingbat.font.family.frag"&gt;&lt;/src:fragref&gt;\r
12139 &lt;src:fragref linkend="double.sided.frag"&gt;&lt;/src:fragref&gt;\r
12140 &lt;src:fragref linkend="draft.mode.frag"&gt;&lt;/src:fragref&gt;\r
12141 &lt;src:fragref linkend="draft.watermark.image.frag"&gt;&lt;/src:fragref&gt;\r
12142 &lt;src:fragref linkend="ebnf.assignment.frag"&gt;&lt;/src:fragref&gt;\r
12143 &lt;src:fragref linkend="ebnf.statement.terminator.frag"&gt;&lt;/src:fragref&gt;\r
12144 &lt;src:fragref linkend="email.delimiters.enabled.frag"&gt;&lt;/src:fragref&gt;\r
12145 &lt;src:fragref linkend="email.mailto.enabled.frag"&gt;&lt;/src:fragref&gt;\r
12146 &lt;src:fragref linkend="equation.properties.frag"&gt;&lt;/src:fragref&gt;\r
12147 &lt;src:fragref linkend="example.properties.frag"&gt;&lt;/src:fragref&gt;\r
12148 &lt;src:fragref linkend="exsl.node.set.available.frag"&gt;&lt;/src:fragref&gt;\r
12149 &lt;src:fragref linkend="figure.properties.frag"&gt;&lt;/src:fragref&gt;\r
12150 &lt;src:fragref linkend="firstterm.only.link.frag"&gt;&lt;/src:fragref&gt;\r
12151 &lt;src:fragref linkend="footer.content.properties.frag"&gt;&lt;/src:fragref&gt;\r
12152 &lt;src:fragref linkend="footer.rule.frag"&gt;&lt;/src:fragref&gt;\r
12153 &lt;src:fragref linkend="footer.column.widths.frag"&gt;&lt;/src:fragref&gt;\r
12154 &lt;src:fragref linkend="footer.table.height.frag"&gt;&lt;/src:fragref&gt;\r
12155 &lt;src:fragref linkend="footer.table.properties.frag"&gt;&lt;/src:fragref&gt;\r
12156 &lt;src:fragref linkend="footers.on.blank.pages.frag"&gt;&lt;/src:fragref&gt;\r
12157 &lt;src:fragref linkend="footnote.font.size.frag"&gt;&lt;/src:fragref&gt;\r
12158 &lt;src:fragref linkend="footnote.number.format.frag"&gt;&lt;/src:fragref&gt;\r
12159 &lt;src:fragref linkend="footnote.number.symbols.frag"&gt;&lt;/src:fragref&gt;\r
12160 &lt;src:fragref linkend="footnote.mark.properties.frag"&gt;&lt;/src:fragref&gt;\r
12161 &lt;src:fragref linkend="footnote.properties.frag"&gt;&lt;/src:fragref&gt;\r
12162 &lt;src:fragref linkend="footnote.sep.leader.properties.frag"&gt;&lt;/src:fragref&gt;\r
12163 &lt;src:fragref linkend="fop.extensions.frag"&gt;&lt;/src:fragref&gt;\r
12164 &lt;src:fragref linkend="fop1.extensions.frag"&gt;&lt;/src:fragref&gt;\r
12165 &lt;src:fragref linkend="formal.object.properties.frag"&gt;&lt;/src:fragref&gt;\r
12166 &lt;src:fragref linkend="formal.procedures.frag"&gt;&lt;/src:fragref&gt;\r
12167 &lt;src:fragref linkend="formal.title.placement.frag"&gt;&lt;/src:fragref&gt;\r
12168 &lt;src:fragref linkend="formal.title.properties.frag"&gt;&lt;/src:fragref&gt;\r
12169 &lt;src:fragref linkend="funcsynopsis.decoration.frag"&gt;&lt;/src:fragref&gt;\r
12170 &lt;src:fragref linkend="funcsynopsis.style.frag"&gt;&lt;/src:fragref&gt;\r
12171 &lt;src:fragref linkend="function.parens.frag"&gt;&lt;/src:fragref&gt;\r
12172 &lt;src:fragref linkend="generate.index.frag"&gt;&lt;/src:fragref&gt;\r
12173 &lt;src:fragref linkend="generate.section.toc.level.frag"&gt;&lt;/src:fragref&gt;\r
12174 &lt;src:fragref linkend="generate.toc.frag"&gt;&lt;/src:fragref&gt;\r
12175 &lt;src:fragref linkend="glossary.as.blocks.frag"&gt;&lt;/src:fragref&gt;\r
12176 &lt;src:fragref linkend="glossary.collection.frag"&gt;&lt;/src:fragref&gt;\r
12177 &lt;src:fragref linkend="glossary.sort.frag"&gt;&lt;/src:fragref&gt;\r
12178 &lt;src:fragref linkend="glossentry.show.acronym.frag"&gt;&lt;/src:fragref&gt;\r
12179 &lt;src:fragref linkend="glosslist.as.blocks.frag"&gt;&lt;/src:fragref&gt;\r
12180 &lt;src:fragref linkend="glossterm.auto.link.frag"&gt;&lt;/src:fragref&gt;\r
12181 &lt;src:fragref linkend="glossterm.separation.frag"&gt;&lt;/src:fragref&gt;\r
12182 &lt;src:fragref linkend="glossterm.width.frag"&gt;&lt;/src:fragref&gt;\r
12183 &lt;src:fragref linkend="glossentry.list.item.properties.frag"&gt;&lt;/src:fragref&gt;\r
12184 &lt;src:fragref linkend="glossterm.list.properties.frag"&gt;&lt;/src:fragref&gt;\r
12185 &lt;src:fragref linkend="glossterm.block.properties.frag"&gt;&lt;/src:fragref&gt;\r
12186 &lt;src:fragref linkend="glossdef.list.properties.frag"&gt;&lt;/src:fragref&gt;\r
12187 &lt;src:fragref linkend="glossdef.block.properties.frag"&gt;&lt;/src:fragref&gt;\r
12188 &lt;src:fragref linkend="graphic.default.extension.frag"&gt;&lt;/src:fragref&gt;\r
12189 &lt;src:fragref linkend="header.content.properties.frag"&gt;&lt;/src:fragref&gt;\r
12190 &lt;src:fragref linkend="header.rule.frag"&gt;&lt;/src:fragref&gt;\r
12191 &lt;src:fragref linkend="header.column.widths.frag"&gt;&lt;/src:fragref&gt;\r
12192 &lt;src:fragref linkend="header.table.height.frag"&gt;&lt;/src:fragref&gt;\r
12193 &lt;src:fragref linkend="header.table.properties.frag"&gt;&lt;/src:fragref&gt;\r
12194 &lt;src:fragref linkend="headers.on.blank.pages.frag"&gt;&lt;/src:fragref&gt;\r
12195 &lt;src:fragref linkend="highlight.default.language.frag"&gt;&lt;/src:fragref&gt;\r
12196 &lt;src:fragref linkend="highlight.source.frag"&gt;&lt;/src:fragref&gt;\r
12197 &lt;src:fragref linkend="highlight.xslthl.config.frag"&gt;&lt;/src:fragref&gt;\r
12198 &lt;src:fragref linkend="hyphenate.frag"&gt;&lt;/src:fragref&gt;\r
12199 &lt;src:fragref linkend="hyphenate.verbatim.frag"&gt;&lt;/src:fragref&gt;\r
12200 &lt;src:fragref linkend="hyphenate.verbatim.characters.frag"&gt;&lt;/src:fragref&gt;\r
12201 &lt;src:fragref linkend="ignore.image.scaling.frag"&gt;&lt;/src:fragref&gt;\r
12202 &lt;src:fragref linkend="img.src.path.frag"&gt;&lt;/src:fragref&gt;\r
12203 &lt;src:fragref linkend="index.method.frag"&gt;&lt;/src:fragref&gt;\r
12204 &lt;src:fragref linkend="index.on.role.frag"&gt;&lt;/src:fragref&gt;\r
12205 &lt;src:fragref linkend="index.on.type.frag"&gt;&lt;/src:fragref&gt;\r
12206 &lt;src:fragref linkend="index.page.number.properties.frag"&gt;&lt;/src:fragref&gt;\r
12207 &lt;src:fragref linkend="informalequation.properties.frag"&gt;&lt;/src:fragref&gt;\r
12208 &lt;src:fragref linkend="informalexample.properties.frag"&gt;&lt;/src:fragref&gt;\r
12209 &lt;src:fragref linkend="informalfigure.properties.frag"&gt;&lt;/src:fragref&gt;\r
12210 &lt;src:fragref linkend="informal.object.properties.frag"&gt;&lt;/src:fragref&gt;\r
12211 &lt;src:fragref linkend="informaltable.properties.frag"&gt;&lt;/src:fragref&gt;\r
12212 &lt;src:fragref linkend="index.preferred.page.properties.frag"&gt;&lt;/src:fragref&gt;\r
12213 &lt;src:fragref linkend="index.div.title.properties.frag"&gt;&lt;/src:fragref&gt;\r
12214 &lt;src:fragref linkend="index.entry.properties.frag"&gt;&lt;/src:fragref&gt;\r
12215 &lt;src:fragref linkend="index.number.separator.frag"&gt;&lt;/src:fragref&gt;\r
12216 &lt;src:fragref linkend="index.range.separator.frag"&gt;&lt;/src:fragref&gt;\r
12217 &lt;src:fragref linkend="index.term.separator.frag"&gt;&lt;/src:fragref&gt;\r
12218 &lt;src:fragref linkend="insert.link.page.number.frag"&gt;&lt;/src:fragref&gt;\r
12219 &lt;src:fragref linkend="insert.xref.page.number.frag"&gt;&lt;/src:fragref&gt;\r
12220 &lt;src:fragref linkend="itemizedlist.properties.frag"&gt;&lt;/src:fragref&gt;\r
12221 &lt;src:fragref linkend="itemizedlist.label.properties.frag"&gt;&lt;/src:fragref&gt;\r
12222 &lt;src:fragref linkend="itemizedlist.label.width.frag"&gt;&lt;/src:fragref&gt;\r
12223 &lt;src:fragref linkend="keep.relative.image.uris.frag"&gt;&lt;/src:fragref&gt;\r
12224 &lt;src:fragref linkend="l10n.gentext.default.language.frag"&gt;&lt;/src:fragref&gt;\r
12225 &lt;src:fragref linkend="l10n.gentext.language.frag"&gt;&lt;/src:fragref&gt;\r
12226 &lt;src:fragref linkend="l10n.gentext.use.xref.language.frag"&gt;&lt;/src:fragref&gt;\r
12227 &lt;src:fragref linkend="l10n.lang.value.rfc.compliant.frag"&gt;&lt;/src:fragref&gt;\r
12228 &lt;src:fragref linkend="label.from.part.frag"&gt;&lt;/src:fragref&gt;\r
12229 &lt;src:fragref linkend="line-height.frag"&gt;&lt;/src:fragref&gt;\r
12230 &lt;src:fragref linkend="linenumbering.everyNth.frag"&gt;&lt;/src:fragref&gt;\r
12231 &lt;src:fragref linkend="linenumbering.extension.frag"&gt;&lt;/src:fragref&gt;\r
12232 &lt;src:fragref linkend="linenumbering.separator.frag"&gt;&lt;/src:fragref&gt;\r
12233 &lt;src:fragref linkend="linenumbering.width.frag"&gt;&lt;/src:fragref&gt;\r
12234 &lt;src:fragref linkend="list.block.properties.frag"&gt;&lt;/src:fragref&gt;\r
12235 &lt;src:fragref linkend="list.block.spacing.frag"&gt;&lt;/src:fragref&gt;\r
12236 &lt;src:fragref linkend="list.item.spacing.frag"&gt;&lt;/src:fragref&gt;\r
12237 &lt;src:fragref linkend="make.index.markup.frag"&gt;&lt;/src:fragref&gt;\r
12238 &lt;src:fragref linkend="make.single.year.ranges.frag"&gt;&lt;/src:fragref&gt;\r
12239 &lt;src:fragref linkend="make.year.ranges.frag"&gt;&lt;/src:fragref&gt;\r
12240 &lt;src:fragref linkend="margin.note.properties.frag"&gt;&lt;/src:fragref&gt;\r
12241 &lt;src:fragref linkend="margin.note.title.properties.frag"&gt;&lt;/src:fragref&gt;\r
12242 &lt;src:fragref linkend="margin.note.float.type.frag"&gt;&lt;/src:fragref&gt;\r
12243 &lt;src:fragref linkend="margin.note.width.frag"&gt;&lt;/src:fragref&gt;\r
12244 &lt;src:fragref linkend="marker.section.level.frag"&gt;&lt;/src:fragref&gt;\r
12245 &lt;src:fragref linkend="menuchoice.menu.separator.frag"&gt;&lt;/src:fragref&gt;\r
12246 &lt;src:fragref linkend="menuchoice.separator.frag"&gt;&lt;/src:fragref&gt;\r
12247 &lt;src:fragref linkend="monospace.font.family.frag"&gt;&lt;/src:fragref&gt;\r
12248 &lt;src:fragref linkend="monospace.properties.frag"&gt;&lt;/src:fragref&gt;\r
12249 &lt;src:fragref linkend="monospace.verbatim.properties.frag"&gt;&lt;/src:fragref&gt;\r
12250 &lt;src:fragref linkend="monospace.verbatim.font.width.frag"&gt;&lt;/src:fragref&gt;\r
12251 &lt;src:fragref linkend="nominal.table.width.frag"&gt;&lt;/src:fragref&gt;\r
12252 &lt;src:fragref linkend="normal.para.spacing.frag"&gt;&lt;/src:fragref&gt;\r
12253 &lt;src:fragref linkend="olink.doctitle.frag"&gt;&lt;/src:fragref&gt;\r
12254 &lt;src:fragref linkend="olink.base.uri.frag"&gt;&lt;/src:fragref&gt;\r
12255 &lt;src:fragref linkend="olink.debug.frag"&gt;&lt;/src:fragref&gt;\r
12256 &lt;src:fragref linkend="olink.properties.frag"&gt;&lt;/src:fragref&gt;\r
12257 &lt;src:fragref linkend="olink.lang.fallback.sequence.frag"&gt;&lt;/src:fragref&gt;\r
12258 &lt;src:fragref linkend="orderedlist.properties.frag"&gt;&lt;/src:fragref&gt;\r
12259 &lt;src:fragref linkend="orderedlist.label.properties.frag"&gt;&lt;/src:fragref&gt;\r
12260 &lt;src:fragref linkend="orderedlist.label.width.frag"&gt;&lt;/src:fragref&gt;\r
12261 &lt;src:fragref linkend="prefer.internal.olink.frag"&gt;&lt;/src:fragref&gt;\r
12262 &lt;src:fragref linkend="insert.olink.page.number.frag"&gt;&lt;/src:fragref&gt;\r
12263 &lt;src:fragref linkend="insert.olink.pdf.frag.frag"&gt;&lt;/src:fragref&gt;\r
12264 &lt;src:fragref linkend="page.height.frag"&gt;&lt;/src:fragref&gt;\r
12265 &lt;src:fragref linkend="page.height.portrait.frag"&gt;&lt;/src:fragref&gt;\r
12266 &lt;src:fragref linkend="page.margin.bottom.frag"&gt;&lt;/src:fragref&gt;\r
12267 &lt;src:fragref linkend="page.margin.inner.frag"&gt;&lt;/src:fragref&gt;\r
12268 &lt;src:fragref linkend="page.margin.outer.frag"&gt;&lt;/src:fragref&gt;\r
12269 &lt;src:fragref linkend="page.margin.top.frag"&gt;&lt;/src:fragref&gt;\r
12270 &lt;src:fragref linkend="page.orientation.frag"&gt;&lt;/src:fragref&gt;\r
12271 &lt;src:fragref linkend="page.width.frag"&gt;&lt;/src:fragref&gt;\r
12272 &lt;src:fragref linkend="page.width.portrait.frag"&gt;&lt;/src:fragref&gt;\r
12273 &lt;src:fragref linkend="paper.type.frag"&gt;&lt;/src:fragref&gt;\r
12274 &lt;src:fragref linkend="part.autolabel.frag"&gt;&lt;/src:fragref&gt;\r
12275 &lt;src:fragref linkend="passivetex.extensions.frag"&gt;&lt;/src:fragref&gt;\r
12276 &lt;src:fragref linkend="pgwide.properties.frag"&gt;&lt;/src:fragref&gt;\r
12277 &lt;src:fragref linkend="preface.autolabel.frag"&gt;&lt;/src:fragref&gt;\r
12278 &lt;src:fragref linkend="preferred.mediaobject.role.frag"&gt;&lt;/src:fragref&gt;\r
12279 &lt;src:fragref linkend="procedure.properties.frag"&gt;&lt;/src:fragref&gt;\r
12280 &lt;src:fragref linkend="process.empty.source.toc.frag"&gt;&lt;/src:fragref&gt;\r
12281 &lt;src:fragref linkend="process.source.toc.frag"&gt;&lt;/src:fragref&gt;\r
12282 &lt;src:fragref linkend="profile.arch.frag"&gt;&lt;/src:fragref&gt;\r
12283 &lt;src:fragref linkend="profile.audience.frag"&gt;&lt;/src:fragref&gt;\r
12284 &lt;src:fragref linkend="profile.attribute.frag"&gt;&lt;/src:fragref&gt;\r
12285 &lt;src:fragref linkend="profile.condition.frag"&gt;&lt;/src:fragref&gt;\r
12286 &lt;src:fragref linkend="profile.conformance.frag"&gt;&lt;/src:fragref&gt;\r
12287 &lt;src:fragref linkend="profile.lang.frag"&gt;&lt;/src:fragref&gt;\r
12288 &lt;src:fragref linkend="profile.os.frag"&gt;&lt;/src:fragref&gt;\r
12289 &lt;src:fragref linkend="profile.revision.frag"&gt;&lt;/src:fragref&gt;\r
12290 &lt;src:fragref linkend="profile.revisionflag.frag"&gt;&lt;/src:fragref&gt;\r
12291 &lt;src:fragref linkend="profile.role.frag"&gt;&lt;/src:fragref&gt;\r
12292 &lt;src:fragref linkend="profile.security.frag"&gt;&lt;/src:fragref&gt;\r
12293 &lt;src:fragref linkend="profile.separator.frag"&gt;&lt;/src:fragref&gt;\r
12294 &lt;src:fragref linkend="profile.status.frag"&gt;&lt;/src:fragref&gt;\r
12295 &lt;src:fragref linkend="profile.userlevel.frag"&gt;&lt;/src:fragref&gt;\r
12296 &lt;src:fragref linkend="profile.value.frag"&gt;&lt;/src:fragref&gt;\r
12297 &lt;src:fragref linkend="profile.vendor.frag"&gt;&lt;/src:fragref&gt;\r
12298 &lt;src:fragref linkend="profile.wordsize.frag"&gt;&lt;/src:fragref&gt;\r
12299 &lt;src:fragref linkend="punct.honorific.frag"&gt;&lt;/src:fragref&gt;\r
12300 &lt;src:fragref linkend="qanda.defaultlabel.frag"&gt;&lt;/src:fragref&gt;\r
12301 &lt;src:fragref linkend="qanda.in.toc.frag"&gt;&lt;/src:fragref&gt;\r
12302 &lt;src:fragref linkend="qanda.nested.in.toc.frag"&gt;&lt;/src:fragref&gt;\r
12303 &lt;src:fragref linkend="qanda.inherit.numeration.frag"&gt;&lt;/src:fragref&gt;\r
12304 &lt;src:fragref linkend="qandadiv.autolabel.frag"&gt;&lt;/src:fragref&gt;\r
12305 &lt;src:fragref linkend="qanda.title.level1.properties.frag"&gt;&lt;/src:fragref&gt;\r
12306 &lt;src:fragref linkend="qanda.title.level2.properties.frag"&gt;&lt;/src:fragref&gt;\r
12307 &lt;src:fragref linkend="qanda.title.level3.properties.frag"&gt;&lt;/src:fragref&gt;\r
12308 &lt;src:fragref linkend="qanda.title.level4.properties.frag"&gt;&lt;/src:fragref&gt;\r
12309 &lt;src:fragref linkend="qanda.title.level5.properties.frag"&gt;&lt;/src:fragref&gt;\r
12310 &lt;src:fragref linkend="qanda.title.level6.properties.frag"&gt;&lt;/src:fragref&gt;\r
12311 &lt;src:fragref linkend="qanda.title.properties.frag"&gt;&lt;/src:fragref&gt;\r
12312 &lt;src:fragref linkend="refentry.generate.name.frag"&gt;&lt;/src:fragref&gt;\r
12313 &lt;src:fragref linkend="refentry.generate.title.frag"&gt;&lt;/src:fragref&gt;\r
12314 &lt;src:fragref linkend="refentry.pagebreak.frag"&gt;&lt;/src:fragref&gt;\r
12315 &lt;src:fragref linkend="refentry.title.properties.frag"&gt;&lt;/src:fragref&gt;\r
12316 &lt;src:fragref linkend="refentry.xref.manvolnum.frag"&gt;&lt;/src:fragref&gt;\r
12317 &lt;src:fragref linkend="reference.autolabel.frag"&gt;&lt;/src:fragref&gt;\r
12318 &lt;src:fragref linkend="refclass.suppress.frag"&gt;&lt;/src:fragref&gt;\r
12319 &lt;src:fragref linkend="region.after.extent.frag"&gt;&lt;/src:fragref&gt;\r
12320 &lt;src:fragref linkend="region.before.extent.frag"&gt;&lt;/src:fragref&gt;\r
12321 &lt;src:fragref linkend="revhistory.table.properties.frag"&gt;&lt;/src:fragref&gt;\r
12322 &lt;src:fragref linkend="revhistory.table.cell.properties.frag"&gt;&lt;/src:fragref&gt;\r
12323 &lt;src:fragref linkend="revhistory.title.properties.frag"&gt;&lt;/src:fragref&gt;\r
12324 &lt;src:fragref linkend="root.properties.frag"&gt;&lt;/src:fragref&gt;\r
12325 &lt;src:fragref linkend="rootid.frag"&gt;&lt;/src:fragref&gt;\r
12326 &lt;src:fragref linkend="runinhead.default.title.end.punct.frag"&gt;&lt;/src:fragref&gt;\r
12327 &lt;src:fragref linkend="runinhead.title.end.punct.frag"&gt;&lt;/src:fragref&gt;\r
12328 &lt;src:fragref linkend="sans.font.family.frag"&gt;&lt;/src:fragref&gt;\r
12329 &lt;src:fragref linkend="section.autolabel.frag"&gt;&lt;/src:fragref&gt;\r
12330 &lt;src:fragref linkend="section.autolabel.max.depth.frag"&gt;&lt;/src:fragref&gt;\r
12331 &lt;src:fragref linkend="section.container.element.frag"&gt;&lt;/src:fragref&gt;\r
12332 &lt;src:fragref linkend="section.label.includes.component.label.frag"&gt;&lt;/src:fragref&gt;\r
12333 &lt;src:fragref linkend="section.title.level1.properties.frag"&gt;&lt;/src:fragref&gt;\r
12334 &lt;src:fragref linkend="section.title.level2.properties.frag"&gt;&lt;/src:fragref&gt;\r
12335 &lt;src:fragref linkend="section.title.level3.properties.frag"&gt;&lt;/src:fragref&gt;\r
12336 &lt;src:fragref linkend="section.title.level4.properties.frag"&gt;&lt;/src:fragref&gt;\r
12337 &lt;src:fragref linkend="section.title.level5.properties.frag"&gt;&lt;/src:fragref&gt;\r
12338 &lt;src:fragref linkend="section.title.level6.properties.frag"&gt;&lt;/src:fragref&gt;\r
12339 &lt;src:fragref linkend="section.title.properties.frag"&gt;&lt;/src:fragref&gt;\r
12340 &lt;src:fragref linkend="section.level1.properties.frag"&gt;&lt;/src:fragref&gt;\r
12341 &lt;src:fragref linkend="section.level2.properties.frag"&gt;&lt;/src:fragref&gt;\r
12342 &lt;src:fragref linkend="section.level3.properties.frag"&gt;&lt;/src:fragref&gt;\r
12343 &lt;src:fragref linkend="section.level4.properties.frag"&gt;&lt;/src:fragref&gt;\r
12344 &lt;src:fragref linkend="section.level5.properties.frag"&gt;&lt;/src:fragref&gt;\r
12345 &lt;src:fragref linkend="section.level6.properties.frag"&gt;&lt;/src:fragref&gt;\r
12346 &lt;src:fragref linkend="section.properties.frag"&gt;&lt;/src:fragref&gt;\r
12347 &lt;src:fragref linkend="segmentedlist.as.table.frag"&gt;&lt;/src:fragref&gt;\r
12348 &lt;src:fragref linkend="shade.verbatim.frag"&gt;&lt;/src:fragref&gt;\r
12349 &lt;src:fragref linkend="shade.verbatim.style.frag"&gt;&lt;/src:fragref&gt;\r
12350 &lt;src:fragref linkend="show.comments.frag"&gt;&lt;/src:fragref&gt;\r
12351 &lt;src:fragref linkend="sidebar.properties.frag"&gt;&lt;/src:fragref&gt;\r
12352 &lt;src:fragref linkend="sidebar.title.properties.frag"&gt;&lt;/src:fragref&gt;\r
12353 &lt;src:fragref linkend="sidebar.float.type.frag"&gt;&lt;/src:fragref&gt;\r
12354 &lt;src:fragref linkend="sidebar.float.width.frag"&gt;&lt;/src:fragref&gt;\r
12355 &lt;src:fragref linkend="simplesect.in.toc.frag"&gt;&lt;/src:fragref&gt;\r
12356 &lt;src:fragref linkend="subscript.properties.frag"&gt;&lt;/src:fragref&gt;\r
12357 &lt;src:fragref linkend="superscript.properties.frag"&gt;&lt;/src:fragref&gt;\r
12358 &lt;src:fragref linkend="symbol.font.family.frag"&gt;&lt;/src:fragref&gt;\r
12359 &lt;src:fragref linkend="table.cell.border.color.frag"&gt;&lt;/src:fragref&gt;\r
12360 &lt;src:fragref linkend="table.cell.border.style.frag"&gt;&lt;/src:fragref&gt;\r
12361 &lt;src:fragref linkend="table.cell.border.thickness.frag"&gt;&lt;/src:fragref&gt;\r
12362 &lt;src:fragref linkend="table.cell.padding.frag"&gt;&lt;/src:fragref&gt;\r
12363 &lt;src:fragref linkend="table.footnote.number.format.frag"&gt;&lt;/src:fragref&gt;\r
12364 &lt;src:fragref linkend="table.footnote.number.symbols.frag"&gt;&lt;/src:fragref&gt;\r
12365 &lt;src:fragref linkend="table.footnote.properties.frag"&gt;&lt;/src:fragref&gt;\r
12366 &lt;src:fragref linkend="table.frame.border.color.frag"&gt;&lt;/src:fragref&gt;\r
12367 &lt;src:fragref linkend="table.frame.border.style.frag"&gt;&lt;/src:fragref&gt;\r
12368 &lt;src:fragref linkend="table.frame.border.thickness.frag"&gt;&lt;/src:fragref&gt;\r
12369 &lt;src:fragref linkend="table.properties.frag"&gt;&lt;/src:fragref&gt;\r
12370 &lt;src:fragref linkend="tablecolumns.extension.frag"&gt;&lt;/src:fragref&gt;\r
12371 &lt;src:fragref linkend="table.table.properties.frag"&gt;&lt;/src:fragref&gt;\r
12372 &lt;src:fragref linkend="target.database.document.frag"&gt;&lt;/src:fragref&gt;\r
12373 &lt;src:fragref linkend="targets.filename.frag"&gt;&lt;/src:fragref&gt;\r
12374 &lt;src:fragref linkend="textdata.default.encoding.frag"&gt;&lt;/src:fragref&gt;\r
12375 &lt;src:fragref linkend="tex.math.delims.frag"&gt;&lt;/src:fragref&gt;\r
12376 &lt;src:fragref linkend="tex.math.in.alt.frag"&gt;&lt;/src:fragref&gt;\r
12377 &lt;src:fragref linkend="textinsert.extension.frag"&gt;&lt;/src:fragref&gt;\r
12378 &lt;src:fragref linkend="title.font.family.frag"&gt;&lt;/src:fragref&gt;\r
12379 &lt;src:fragref linkend="title.margin.left.frag"&gt;&lt;/src:fragref&gt;\r
12380 &lt;src:fragref linkend="toc.indent.width.frag"&gt;&lt;/src:fragref&gt;\r
12381 &lt;src:fragref linkend="toc.line.properties.frag"&gt;&lt;/src:fragref&gt;\r
12382 &lt;src:fragref linkend="toc.margin.properties.frag"&gt;&lt;/src:fragref&gt;\r
12383 &lt;src:fragref linkend="toc.max.depth.frag"&gt;&lt;/src:fragref&gt;\r
12384 &lt;src:fragref linkend="toc.section.depth.frag"&gt;&lt;/src:fragref&gt;\r
12385 &lt;src:fragref linkend="ulink.footnotes.frag"&gt;&lt;/src:fragref&gt;\r
12386 &lt;src:fragref linkend="ulink.hyphenate.frag"&gt;&lt;/src:fragref&gt;\r
12387 &lt;src:fragref linkend="ulink.hyphenate.chars.frag"&gt;&lt;/src:fragref&gt;\r
12388 &lt;src:fragref linkend="ulink.show.frag"&gt;&lt;/src:fragref&gt;\r
12389 &lt;src:fragref linkend="use.extensions.frag"&gt;&lt;/src:fragref&gt;\r
12390 &lt;src:fragref linkend="use.local.olink.style.frag"&gt;&lt;/src:fragref&gt;\r
12391 &lt;src:fragref linkend="use.role.as.xrefstyle.frag"&gt;&lt;/src:fragref&gt;\r
12392 &lt;src:fragref linkend="use.role.for.mediaobject.frag"&gt;&lt;/src:fragref&gt;\r
12393 &lt;src:fragref linkend="use.svg.frag"&gt;&lt;/src:fragref&gt;\r
12394 &lt;src:fragref linkend="variablelist.as.blocks.frag"&gt;&lt;/src:fragref&gt;\r
12395 &lt;src:fragref linkend="variablelist.max.termlength.frag"&gt;&lt;/src:fragref&gt;\r
12396 &lt;src:fragref linkend="variablelist.term.separator.frag"&gt;&lt;/src:fragref&gt;\r
12397 &lt;src:fragref linkend="variablelist.term.properties.frag"&gt;&lt;/src:fragref&gt;\r
12398 &lt;src:fragref linkend="variablelist.term.break.after.frag"&gt;&lt;/src:fragref&gt;\r
12399 &lt;src:fragref linkend="verbatim.properties.frag"&gt;&lt;/src:fragref&gt;\r
12400 &lt;src:fragref linkend="writing.mode.frag"&gt;&lt;/src:fragref&gt;\r
12401 &lt;src:fragref linkend="xep.extensions.frag"&gt;&lt;/src:fragref&gt;\r
12402 &lt;src:fragref linkend="xep.index.item.properties.frag"&gt;&lt;/src:fragref&gt;\r
12403 &lt;src:fragref linkend="xref.label-page.separator.frag"&gt;&lt;/src:fragref&gt;\r
12404 &lt;src:fragref linkend="xref.label-title.separator.frag"&gt;&lt;/src:fragref&gt;\r
12405 &lt;src:fragref linkend="xref.properties.frag"&gt;&lt;/src:fragref&gt;\r
12406 &lt;src:fragref linkend="xref.title-page.separator.frag"&gt;&lt;/src:fragref&gt;\r
12407 &lt;src:fragref linkend="xref.with.number.and.title.frag"&gt;&lt;/src:fragref&gt;\r
12408 \r
12409 &lt;/xsl:stylesheet&gt;\r
12410 </programlisting>\r
12411 \r
12412 </appendix>\r
12413 </book>\r