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