| <refentry xmlns="http://docbook.org/ns/docbook" |
| xmlns:xlink="http://www.w3.org/1999/xlink" |
| xmlns:xi="http://www.w3.org/2001/XInclude" |
| xmlns:src="http://nwalsh.com/xmlns/litprog/fragment" |
| xmlns:xsl="http://www.w3.org/1999/XSL/Transform" |
| version="5.0" xml:id="footer.column.widths"> |
| <refmeta> |
| <refentrytitle>footer.column.widths</refentrytitle> |
| <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo> |
| </refmeta> |
| <refnamediv> |
| <refname>footer.column.widths</refname> |
| <refpurpose>Specify relative widths of footer areas</refpurpose> |
| </refnamediv> |
| |
| <refsynopsisdiv><src:fragment xml:id="footer.column.widths.frag"> |
| <xsl:param name="footer.column.widths">1 1 1</xsl:param> |
| </src:fragment></refsynopsisdiv> |
| |
| <refsection><info><title>Description</title></info> |
| |
| <para>Page footers in print output use a three column table |
| to position text at the left, center, and right side of |
| the footer on the page. |
| This parameter lets you specify the relative sizes of the |
| three columns. The default value is |
| "1 1 1".</para> |
| |
| <para>The parameter value must be three numbers, separated |
| by white space. The first number represents the relative |
| width of the inside footer for |
| double-sided output. The second number is the relative |
| width of the center footer. The third number is the |
| relative width of the outside footer for |
| double-sided output. |
| </para> |
| <para>For single-sided output, the first number is the |
| relative width of left footer for left-to-right |
| text direction, or the right footer for right-to-left |
| text direction. |
| The third number is the |
| relative width of right footer for left-to-right |
| text direction, or the left footer for right-to-left |
| text direction.</para> |
| |
| <para>The numbers are used to specify the column widths |
| for the table that makes up the footer area. |
| In the FO output, this looks like: |
| </para> |
| |
| <programlisting> |
| <fo:table-column column-number="1" |
| column-width="proportional-column-width(1)"/> |
| </programlisting> |
| |
| <para> |
| The <literal>proportional-column-width()</literal> |
| function computes a column width by dividing its |
| argument by the total of the arguments for all the columns, and |
| then multiplying the result by the width of the whole table |
| (assuming all the column specs use the function). |
| Its argument can be any positive integer or floating point number. |
| Zero is an acceptable value, although some FO processors |
| may warn about it, in which case using a very small number might |
| be more satisfactory. |
| </para> |
| |
| <para>For example, the value "1 2 1" means the center |
| footer should have twice the width of the other areas. |
| A value of "0 0 1" means the entire footer area |
| is reserved for the right (or outside) footer text. |
| Note that to keep the center area centered on |
| the page, the left and right values must be |
| the same. A specification like "1 2 3" means the |
| center area is no longer centered on the page |
| since the right area is three times the width of the left area. |
| </para> |
| |
| </refsection> |
| </refentry> |