40 lines
1.6 KiB
XML
40 lines
1.6 KiB
XML
|
<refentry xmlns="http://docbook.org/ns/docbook"
|
||
|
|
xmlns:xlink="http://www.w3.org/1999/xlink"
|
||
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
||
|
|
xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
|
||
|
|
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
|
||
|
|
version="5.0" xml:id="component.label.includes.part.label">
|
||
|
|
<refmeta>
|
||
|
|
<refentrytitle>component.label.includes.part.label</refentrytitle>
|
||
|
|
<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
|
||
|
|
</refmeta>
|
||
|
|
<refnamediv>
|
||
|
|
<refname>component.label.includes.part.label</refname>
|
||
|
|
<refpurpose>Do component labels include the part label?</refpurpose>
|
||
|
|
</refnamediv>
|
||
|
|
|
||
|
|
<refsynopsisdiv>
|
||
|
|
<src:fragment xml:id="component.label.includes.part.label.frag"><xsl:param name="component.label.includes.part.label" select="0"/></src:fragment>
|
||
|
|
</refsynopsisdiv>
|
||
|
|
|
||
|
|
<refsection><info><title>Description</title></info>
|
||
|
|
|
||
|
|
<para>If non-zero, number labels for <tag>chapter</tag>,
|
||
|
|
<tag>appendix</tag>, and other component elements are prefixed with
|
||
|
|
the label of the part element that contains them. So you might see
|
||
|
|
Chapter II.3 instead of Chapter 3. Also, the labels for formal
|
||
|
|
elements such as <tag>table</tag> and <tag>figure</tag> will include
|
||
|
|
the part label. If there is no part element container, then no prefix
|
||
|
|
is generated.
|
||
|
|
</para>
|
||
|
|
<para>
|
||
|
|
This feature is most useful when the
|
||
|
|
<parameter>label.from.part</parameter> parameter is turned on.
|
||
|
|
In that case, there would be more than one <tag>chapter</tag>
|
||
|
|
<quote>1</quote>, and the extra part label prefix will identify
|
||
|
|
each chapter unambiguously.
|
||
|
|
</para>
|
||
|
|
|
||
|
|
</refsection>
|
||
|
|
</refentry>
|