1<html>
2   <head>
3      <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
4   
5      <title>Formatting Object Table Reference</title>
6      <link rel="stylesheet" href="/reference.css" type="text/css">
7      <meta name="generator" content="DocBook XSL Stylesheets V1.37">
8   </head>
9   <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
10      <div class="reference">
11         <div class="titlepage">
12            <div>
13               <h1 class="title"><a name="d41e1"></a>Formatting Object Table Reference
14               </h1>
15            </div>
16            <div>
17               <h3 class="author">Norman Walsh</h3>
18            </div>
19            <div>
20               <p class="releaseinfo">
21                  $Id$
22                  
23               </p>
24            </div>
25            <div>
26               <p class="copyright"><a href="/copyright.html">Copyright</a> &copy; 1999, 2000 by Norman Walsh. <a href="/warranty.html">No Warranty</a>.
27               </p>
28            </div>
29            <hr>
30         </div>
31         <div class="partintro">
32            <div></div>
33            <div class="section"><a name="d41e24"></a><div class="titlepage">
34                  <div>
35                     <h2 class="title" style="clear: all"><a name="d41e24"></a>Introduction
36                     </h2>
37                  </div>
38               </div>
39               <p>This is technical reference documentation for the DocBook XSL
40                  Stylesheets; it documents (some of) the parameters, templates, and
41                  other elements of the stylesheets.
42               </p>
43               <p>This is not intended to be &#8220;user&#8221; documentation.
44                  It is provided for developers writing customization layers for the
45                  stylesheets, and for anyone who's interested in &#8220;how it
46                  works&#8221;.
47               </p>
48               <p>Although I am trying to be thorough, this documentation is known
49                  to be incomplete. Don't forget to read the source, too :-)
50               </p>
51            </div>
52            <div class="toc">
53               <p><b>Table of Contents</b></p>
54               <dl>
55                  <dt><a href="#template.calc.column.width">calc.column.width</a></dt>
56               </dl>
57            </div>
58         </div>
59         <hr>
60         <div class="refentry">
61            <h1 class="title"><a name="template.calc.column.width"></a>calc.column.width
62            </h1>
63            <div class="refnamediv"><a name="d41e40"></a><h2>Name</h2>calc.column.width &#8212; Calculate an XSL FO table column width specification from a
64               CALS table column width specification.
65            </div>
66            <div class="refsynopsisdiv"><a name="d41e45"></a><h2>Synopsis</h2><pre class="synopsis">&lt;xsl:template name="calc.column.width"&gt;
67&lt;xsl:param name="colwidth"&gt;1*&lt;/xsl:param&gt;
68  ...
69&lt;/xsl:template&gt;</pre></div>
70            <div class="refdescription"><a name="d41e48"></a>
71               
72               
73               <p>CALS expresses table column widths in the following basic
74                  forms:
75               </p>
76               
77               
78               
79               
80               <div class="itemizedlist">
81                  <ul>
82                     <li>
83                        <p><a name="d41e54"></a><i>99.99units</i>, a fixed length specifier.
84                        </p>
85                     </li>
86                     <li>
87                        <p><a name="d41e59"></a><i>99.99</i>, a fixed length specifier without any units.
88                        </p>
89                     </li>
90                     <li>
91                        <p><a name="d41e64"></a><i>99.99*</i>, a relative length specifier.
92                        </p>
93                     </li>
94                     <li>
95                        <p><a name="d41e69"></a><i>99.99*+99.99units</i>, a combination of both.
96                        </p>
97                     </li>
98                  </ul>
99               </div>
100               
101               
102               
103               
104               <p>The CALS units are points (pt), picas (pi), centimeters (cm),
105                  millimeters (mm), and inches (in). These are the same units as XSL,
106                  except that XSL abbreviates picas "pc" instead of "pi". If a length
107                  specifier has no units, the CALS default unit (pt) is assumed.
108               </p>
109               
110               
111               
112               
113               <p>Relative length specifiers are represented in XSL with the
114                  proportional-column-width() function.
115               </p>
116               
117               
118               
119               
120               <p>Here are some examples:</p>
121               
122               
123               
124               
125               <div class="itemizedlist">
126                  <ul>
127                     <li>
128                        <p><a name="d41e85"></a>"36pt" becomes "36pt"
129                        </p>
130                     </li>
131                     <li>
132                        <p><a name="d41e88"></a>"3pi" becomes "3pc"
133                        </p>
134                     </li>
135                     <li>
136                        <p><a name="d41e91"></a>"36" becomes "36pt"
137                        </p>
138                     </li>
139                     <li>
140                        <p><a name="d41e94"></a>"3*" becomes "proportional-column-width(3)"
141                        </p>
142                     </li>
143                     <li>
144                        <p><a name="d41e97"></a>"3*+2pi" becomes "proportional-column-width(3)+2pc"
145                        </p>
146                     </li>
147                     <li>
148                        <p><a name="d41e100"></a>"1*+2" becomes "proportional-column-width(1)+2pt"
149                        </p>
150                     </li>
151                  </ul>
152               </div>
153               
154               
155            </div>
156            <div class="refparameter"><b><a name="d41e104"></a>Parameters</b>
157               
158               
159               <div class="variablelist">
160                  <dl>
161                     <dt><a name="d41e107"></a><span class="term">colwidth</span></dt>
162                     <dd>
163                        <p><a name="d41e110"></a>The CALS column width specification.
164                        </p>
165                     </dd>
166                  </dl>
167               </div>
168               
169               
170            </div>
171            <div class="refreturn"><b><a name="d41e114"></a>Returns</b>
172               
173               
174               <p>The XSL column width specification.</p>
175               
176               
177            </div>
178         </div>
179      </div>
180   </body>
181</html>