stylesheets/evergreen_docbook_files/docbook-xsl-1.75.2/fo/table.xml

   1 <?xml version="1.0"?>\r
   2 \r
   3 <reference xml:id="table-templates"><?dbhtml dir="fo"?>\r
   4   \r
   5   <info>\r
   6     <title>Formatting Object Table Reference</title>\r
   7     <releaseinfo role="meta">\r
   8       $Id: table.xsl 8392 2009-04-01 08:47:55Z bobstayton $\r
   9     </releaseinfo>\r
  10   </info>\r
  11   <partintro xml:id="partintro">\r
  12     <title>Introduction</title>\r
  13     \r
  14 <para>This is technical reference documentation for the FO\r
  15       table-processing templates in the DocBook XSL Stylesheets.</para>\r
  16 \r
  17     \r
  18 <para>This is not intended to be user documentation.  It is\r
  19       provided for developers writing customization layers for the\r
  20       stylesheets.</para>\r
  21 \r
  22   </partintro>\r
  23 \r
  24 <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="template.calc.column.width">\r
  25 <refnamediv>\r
  26 <refname>calc.column.width</refname>\r
  27 <refpurpose>Calculate an XSL FO table column width specification from a\r
  28 CALS table column width specification.</refpurpose>\r
  29 </refnamediv>\r
  30 <refsynopsisdiv>\r
  31 <synopsis>&lt;xsl:template name="calc.column.width"&gt;\r
  32 &lt;xsl:param name="colwidth"&gt;1*&lt;/xsl:param&gt;\r
  33   ...\r
  34 &lt;/xsl:template&gt;</synopsis>\r
  35 </refsynopsisdiv>\r
  36 <refsect1><title>Description</title>\r
  37 \r
  38 <para>CALS expresses table column widths in the following basic\r
  39 forms:</para>\r
  40 \r
  41 \r
  42 \r
  43 <itemizedlist>\r
  44 <listitem>\r
  45 \r
  46 <para><emphasis>99.99units</emphasis>, a fixed length specifier.</para>\r
  47 \r
  48 </listitem>\r
  49 <listitem>\r
  50 \r
  51 <para><emphasis>99.99</emphasis>, a fixed length specifier without any units.</para>\r
  52 \r
  53 </listitem>\r
  54 <listitem>\r
  55 \r
  56 <para><emphasis>99.99*</emphasis>, a relative length specifier.</para>\r
  57 \r
  58 </listitem>\r
  59 <listitem>\r
  60 \r
  61 <para><emphasis>99.99*+99.99units</emphasis>, a combination of both.</para>\r
  62 \r
  63 </listitem>\r
  64 </itemizedlist>\r
  65 \r
  66 \r
  67 \r
  68 <para>The CALS units are points (pt), picas (pi), centimeters (cm),\r
  69 millimeters (mm), and inches (in). These are the same units as XSL,\r
  70 except that XSL abbreviates picas "pc" instead of "pi". If a length\r
  71 specifier has no units, the CALS default unit (pt) is assumed.</para>\r
  72 \r
  73 \r
  74 \r
  75 <para>Relative length specifiers are represented in XSL with the\r
  76 proportional-column-width() function.</para>\r
  77 \r
  78 \r
  79 \r
  80 <para>Here are some examples:</para>\r
  81 \r
  82 \r
  83 \r
  84 <itemizedlist>\r
  85 <listitem>\r
  86 \r
  87 <para>"36pt" becomes "36pt"</para>\r
  88 \r
  89 </listitem>\r
  90 <listitem>\r
  91 \r
  92 <para>"3pi" becomes "3pc"</para>\r
  93 \r
  94 </listitem>\r
  95 <listitem>\r
  96 \r
  97 <para>"36" becomes "36pt"</para>\r
  98 \r
  99 </listitem>\r
 100 <listitem>\r
 101 \r
 102 <para>"3*" becomes "proportional-column-width(3)"</para>\r
 103 \r
 104 </listitem>\r
 105 <listitem>\r
 106 \r
 107 <para>"3*+2pi" becomes "proportional-column-width(3)+2pc"</para>\r
 108 \r
 109 </listitem>\r
 110 <listitem>\r
 111 \r
 112 <para>"1*+2" becomes "proportional-column-width(1)+2pt"</para>\r
 113 \r
 114 </listitem>\r
 115 </itemizedlist>\r
 116 \r
 117 </refsect1><refsect1><title>Parameters</title>\r
 118 \r
 119 <variablelist>\r
 120 <varlistentry><term>colwidth</term>\r
 121 <listitem>\r
 122 \r
 123 <para>The CALS column width specification.</para>\r
 124 \r
 125 </listitem>\r
 126 </varlistentry>\r
 127 </variablelist>\r
 128 \r
 129 </refsect1><refsect1><title>Returns</title>\r
 130 \r
 131 <para>The XSL column width specification.</para>\r
 132 \r
 133 </refsect1></refentry>\r
 134 </reference>\r
 135 \r