Add support for side floats, especially with sidebar.

diff --git a/xsl/params/side.float.properties.xml b/xsl/params/side.float.properties.xml
new file mode 100644 (file)
index 0000000..789615a
--- /dev/null
+++ b/xsl/params/side.float.properties.xml
@@ -0,0 +1,45 @@
+<refentry id="side.float.properties">
+<refmeta>
+<refentrytitle>side.float.properties</refentrytitle>
+<refmiscinfo role="type">attribute set</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>side.float.properties</refname>
+<refpurpose>Attribute set for side float container properties</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<src:fragment id='side.float.properties.frag'>
+<xsl:attribute-set name="side.float.properties">
+  <xsl:attribute name="width">2in</xsl:attribute>
+  <xsl:attribute name="padding-left">4pt</xsl:attribute>
+  <xsl:attribute name="padding-right">4pt</xsl:attribute>
+  <xsl:attribute name="padding-top">2pt</xsl:attribute>
+  <xsl:attribute name="padding-bottom">2pt</xsl:attribute>
+  <xsl:attribute name="margin-left">0pt</xsl:attribute>
+  <xsl:attribute name="margin-right">0pt</xsl:attribute>
+  <xsl:attribute name="text-align">left</xsl:attribute>
+</xsl:attribute-set>
+</src:fragment>
+</refsynopsisdiv>
+
+<refsect1><title>Description</title>
+
+<para>Properties that are applied to the
+<sgmltag class="element">fo:block-container</sgmltag> inside of
+a side float that is generated by the template named
+<literal>floater</literal>.
+That template generates a side float
+when the <parameter>side.float.type</parameter> is set to one
+of the values for a side float.</para>
+
+<para>If you do only <literal>left</literal> or 
+<literal>start</literal> side floats, you may want to set the
+<literal>padding-left</literal> attribute to zero.
+If you do only <literal>right</literal> or 
+<literal>end</literal> side floats, you may want to set the
+<literal>padding-right</literal> attribute to zero.
+</para>
+
+</refsect1>
+</refentry>

diff --git a/xsl/params/sidebar.float.type.xml b/xsl/params/sidebar.float.type.xml
new file mode 100644 (file)
index 0000000..a248256
--- /dev/null
+++ b/xsl/params/sidebar.float.type.xml
@@ -0,0 +1,60 @@
+<refentry id="sidebar.float.type">
+<refmeta>
+<refentrytitle>sidebar.float.type</refentrytitle>
+<refmiscinfo role="type">list</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>sidebar.float.type</refname>
+<refpurpose>Select type of float for sidebar elements</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<src:fragment id='sidebar.float.type.frag'>
+<xsl:param name="sidebar.float.type" select="'none'"/>
+</src:fragment>
+</refsynopsisdiv>
+
+<refsect1><title>Description</title>
+
+<para>Selects the type of float for sidebar elements.
+</para>
+<itemizedlist>
+<listitem>
+<para>If <parameter>sidebar.float.type</parameter> is
+<quote><literal>none</literal></quote>, then 
+no float is used.
+</para>
+</listitem>
+<listitem>
+<para>If <parameter>sidebar.float.type</parameter> is
+<quote><literal>before</literal></quote>, then 
+the float appears at the top of the page.  On some processors,
+that may be the next page rather than the current page.
+</para>
+</listitem>
+<listitem>
+<para>If <parameter>sidebar.float.type</parameter> is
+<quote><literal>left</literal></quote> or
+<quote><literal>start</literal></quote>, then 
+a left side float is used.
+</para>
+</listitem>
+<listitem>
+<para>If <parameter>sidebar.float.type</parameter> is
+<quote><literal>right</literal></quote> or
+<quote><literal>end</literal></quote>, then 
+a left side float is used.
+</para>
+</listitem>
+<listitem>
+<para>If your XSL-FO processor supports floats positioned on the
+<quote><literal>inside</literal></quote> or
+<quote><literal>outside</literal></quote>
+of double-sided pages, then you have those two 
+options for side floats as well.
+</para>
+</listitem>
+</itemizedlist>
+
+</refsect1>
+</refentry>