summaryrefslogtreecommitdiffstats
path: root/kdoctools/docbook/xsl/params/section.level1.properties.xml
diff options
context:
space:
mode:
Diffstat (limited to 'kdoctools/docbook/xsl/params/section.level1.properties.xml')
-rw-r--r--kdoctools/docbook/xsl/params/section.level1.properties.xml39
1 files changed, 39 insertions, 0 deletions
diff --git a/kdoctools/docbook/xsl/params/section.level1.properties.xml b/kdoctools/docbook/xsl/params/section.level1.properties.xml
new file mode 100644
index 000000000..c0a804d7b
--- /dev/null
+++ b/kdoctools/docbook/xsl/params/section.level1.properties.xml
@@ -0,0 +1,39 @@
+<refentry id="section.level1.properties">
+<refmeta>
+<refentrytitle>section.level1.properties</refentrytitle>
+<refmiscinfo role="type">attribute set</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>section.level1.properties</refname>
+<refpurpose>Properties for level-1 sections</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<src:fragment id='section.level1.properties.frag'>
+<xsl:attribute-set name="section.level1.properties"
+ use-attribute-sets="section.properties">
+</xsl:attribute-set>
+</src:fragment>
+</refsynopsisdiv>
+
+<refsect1><title>Description</title>
+
+<para>The properties that apply to the containing
+block of a level-1 section, and therefore apply to
+the whole section. This includes <sgmltag>sect1</sgmltag>
+elements and <sgmltag>section</sgmltag> elements at level 1.
+</para>
+
+<para>For example, you could start each level-1 section on
+a new page by using:</para>
+<programlisting>&lt;xsl:attribute-set name="section.level1.properties"&gt;
+ &lt;xsl:attribute name="break-before"&gt;page&lt;/xsl:attribute&gt;
+&lt;/xsl:attribute-set&gt;
+</programlisting>
+
+<para>This attribute set inherits attributes from the
+general <sgmltag>section.properties</sgmltag> attribute set.
+</para>
+
+</refsect1>
+</refentry>