]> git.stg.codes - stg.git/blob - doc/xslt/params/margin.note.properties.xml
Help book chapter 3 complete
[stg.git] / doc / xslt / params / margin.note.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="margin.note.properties">
7 <refmeta>
8 <refentrytitle>margin.note.properties</refentrytitle>
9 <refmiscinfo class="other" otherclass="datatype">attribute set</refmiscinfo>
10 </refmeta>
11 <refnamediv>
12 <refname>margin.note.properties</refname>
13 <refpurpose>Attribute set for margin.note properties</refpurpose>
14 </refnamediv>
15
16 <refsynopsisdiv>
17 <src:fragment xml:id="margin.note.properties.frag">
18 <xsl:attribute-set name="margin.note.properties">
19   <xsl:attribute name="font-size">90%</xsl:attribute>
20   <xsl:attribute name="text-align">start</xsl:attribute>
21 </xsl:attribute-set>
22 </src:fragment>
23 </refsynopsisdiv>
24
25 <refsection><info><title>Description</title></info>
26
27 <para>The styling for margin notes.
28 By default, margin notes are not implemented for any
29 element. A stylesheet customization is needed to make
30 use of this attribute-set.</para>
31
32 <para>You can use a template named <quote>floater</quote>
33 to create the customization.
34 That template can create side floats by specifying the
35 content and characteristics as template parameters.
36 </para>
37
38 <para>For example:</para>
39 <programlisting>&lt;xsl:template match="para[@role='marginnote']"&gt;
40   &lt;xsl:call-template name="floater"&gt;
41     &lt;xsl:with-param name="position"&gt;
42       &lt;xsl:value-of select="$margin.note.float.type"/&gt;
43     &lt;/xsl:with-param&gt;
44     &lt;xsl:with-param name="width"&gt;
45       &lt;xsl:value-of select="$margin.note.width"/&gt;
46     &lt;/xsl:with-param&gt;
47     &lt;xsl:with-param name="content"&gt;
48       &lt;xsl:apply-imports/&gt;
49     &lt;/xsl:with-param&gt;
50   &lt;/xsl:call-template&gt;
51 &lt;/xsl:template&gt;</programlisting>
52
53 </refsection>
54 </refentry>