diff options
Diffstat (limited to '3rdParty/DocBook/XSL/params/header.column.widths.xml')
-rw-r--r-- | 3rdParty/DocBook/XSL/params/header.column.widths.xml | 80 |
1 files changed, 80 insertions, 0 deletions
diff --git a/3rdParty/DocBook/XSL/params/header.column.widths.xml b/3rdParty/DocBook/XSL/params/header.column.widths.xml new file mode 100644 index 0000000..7d85b96 --- /dev/null +++ b/3rdParty/DocBook/XSL/params/header.column.widths.xml @@ -0,0 +1,80 @@ +<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="header.column.widths"> +<refmeta> +<refentrytitle>header.column.widths</refentrytitle> +<refmiscinfo class="other" otherclass="datatype">string</refmiscinfo> +</refmeta> +<refnamediv> +<refname>header.column.widths</refname> +<refpurpose>Specify relative widths of header areas</refpurpose> +</refnamediv> + +<refsynopsisdiv><src:fragment xml:id="header.column.widths.frag"> +<xsl:param name="header.column.widths">1 1 1</xsl:param> +</src:fragment></refsynopsisdiv> + +<refsection><info><title>Description</title></info> + +<para>Page headers in print output use a three column table +to position text at the left, center, and right side of +the header 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 header for +double-sided output. The second number is the relative +width of the center header. The third number is the +relative width of the outside header for +double-sided output. +</para> +<para>For single-sided output, the first number is the +relative width of left header for left-to-right +text direction, or the right header for right-to-left +text direction. +The third number is the +relative width of right header for left-to-right +text direction, or the left header for right-to-left +text direction.</para> + +<para>The numbers are used to specify the column widths +for the table that makes up the header 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 +header should have twice the width of the other areas. +A value of "0 0 1" means the entire header area +is reserved for the right (or outside) header 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> |