doc/xslt/params/section.level1.properties.xml

   1 <refentry xmlns="http://docbook.org/ns/docbook"
   2           xmlns:xlink="http://www.w3.org/1999/xlink"
   3           xmlns:xi="http://www.w3.org/2001/XInclude"
   4           xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
   5           xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
   6           version="5.0" xml:id="section.level1.properties">
   7 <refmeta>
   8 <refentrytitle>section.level1.properties</refentrytitle>
   9 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
  10 </refmeta>
  11 <refnamediv>
  12 <refname>section.level1.properties</refname>
  13 <refpurpose>Properties for level-1 sections</refpurpose>
  14 </refnamediv>
  15
  16 <refsynopsisdiv>
  17 <src:fragment xml:id="section.level1.properties.frag">
  18 <xsl:attribute-set name="section.level1.properties" use-attribute-sets="section.properties">
  19 </xsl:attribute-set>
  20 </src:fragment>
  21 </refsynopsisdiv>
  22
  23 <refsection><info><title>Description</title></info>
  24
  25 <para>The properties that apply to the containing
  26 block of a level-1 section, and therefore apply to
  27 the whole section.  This includes <tag>sect1</tag>
  28 elements and <tag>section</tag> elements at level 1.
  29 </para>
  30
  31 <para>For example, you could start each level-1 section on
  32 a new page by using:</para>
  33 <programlisting>&lt;xsl:attribute-set name="section.level1.properties"&gt;
  34   &lt;xsl:attribute name="break-before"&gt;page&lt;/xsl:attribute&gt;
  35 &lt;/xsl:attribute-set&gt;
  36 </programlisting>
  37
  38 <para>This attribute set inherits attributes from the
  39 general <tag>section.properties</tag> attribute set.
  40 </para>
  41
  42 </refsection>
  43 </refentry>