| 1 | <refentry xmlns="http://docbook.org/ns/docbook"
|
|---|
| 2 | xmlns:xlink="http://www.w3.org/1999/xlink"
|
|---|
| 3 | xmlns:xi="http://www.w3.org/2001/XInclude"
|
|---|
| 4 | xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
|
|---|
| 5 | xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
|
|---|
| 6 | version="5.0" xml:id="side.region.precedence">
|
|---|
| 7 | <refmeta>
|
|---|
| 8 | <refentrytitle>side.region.precedence</refentrytitle>
|
|---|
| 9 | <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
|
|---|
| 10 | </refmeta>
|
|---|
| 11 | <refnamediv>
|
|---|
| 12 | <refname>side.region.precedence</refname>
|
|---|
| 13 | <refpurpose>Determines side region page layout precedence</refpurpose>
|
|---|
| 14 | </refnamediv>
|
|---|
| 15 | <refsynopsisdiv> <src:fragment xml:id="side.region.precedence.frag">
|
|---|
| 16 | <xsl:param name="side.region.precedence">false</xsl:param>
|
|---|
| 17 | </src:fragment>
|
|---|
| 18 | </refsynopsisdiv>
|
|---|
| 19 | <refsection><info><title>Description</title></info>
|
|---|
| 20 |
|
|---|
| 21 | <para>If optional side regions on a page
|
|---|
| 22 | are established using parameters such as
|
|---|
| 23 | <parameter>body.margin.inner</parameter>,
|
|---|
| 24 | <parameter>region.inner.extent</parameter>, etc., then this
|
|---|
| 25 | parameter determines what happens at the corners where the
|
|---|
| 26 | side regions meet the header and footer regions.</para>
|
|---|
| 27 |
|
|---|
| 28 | <para>If the value of this parameter is <literal>true</literal>,
|
|---|
| 29 | then the side regions have precedence and extend higher
|
|---|
| 30 | and lower, while the header and footer regions are narrower
|
|---|
| 31 | and fit inside the side regions.</para>
|
|---|
| 32 |
|
|---|
| 33 | <para>If the value of this parameter is <literal>false</literal>
|
|---|
| 34 | (the default value), then the header and footer regions
|
|---|
| 35 | have precedence and extend over and below the side regions.
|
|---|
| 36 | Any value other than <literal>true</literal> or
|
|---|
| 37 | <literal>false</literal> is taken to be <literal>false</literal>.</para>
|
|---|
| 38 |
|
|---|
| 39 | <para>If you need to set precedence separately for
|
|---|
| 40 | individual regions, then you can set four
|
|---|
| 41 | parameters that are normally internal to the stylesheet.
|
|---|
| 42 | These four parameters are normally set based
|
|---|
| 43 | on the value from <parameter>side.region.precedence</parameter>:</para>
|
|---|
| 44 |
|
|---|
| 45 | <programlisting>region.before.precedence
|
|---|
| 46 | region.after.precedence
|
|---|
| 47 | region.start.precedence
|
|---|
| 48 | region.end.precedence</programlisting>
|
|---|
| 49 |
|
|---|
| 50 | <para>See also
|
|---|
| 51 | <parameter>region.inner.extent</parameter>,
|
|---|
| 52 | <parameter>region.outer.extent</parameter>,
|
|---|
| 53 | <parameter>body.margin.inner</parameter>,
|
|---|
| 54 | <parameter>body.margin.outer</parameter>.
|
|---|
| 55 | </para>
|
|---|
| 56 | </refsection> </refentry>
|
|---|
