<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>dblatex table-width</title><link rel="stylesheet" type="text/css" href="manual.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.76.1" /><link rel="home" href="index.html" title="DocBook to LaTeX Publishing" /><link rel="up" href="apbs04.html" title="Tables" /><link rel="prev" href="pi-dblatex_bgcolor.html" title="dblatex bgcolor" /><link rel="next" href="sec-pi-lists.html" title="Lists" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">dblatex table-width</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="pi-dblatex_bgcolor.html">Prev</a> </td><th width="60%" align="center">Tables</th><td width="20%" align="right"> <a accesskey="n" href="sec-pi-lists.html">Next</a></td></tr></table><hr /></div><div class="refentry" title="dblatex table-width"><a id="pi-dblatex_table-width"></a><div class="titlepage"></div><div class="refnamediv"><h2><span class="refentrytitle">dblatex table-width</span></h2><p><code class="sgmltag-xmlpi"><?dblatex
<em class="parameter"><code>table-width</code></em>?></code> — Control the Automatic Width of a Table</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="programlisting"><?dblatex table-width="12cm" ?></pre></div><div class="refsection" title="Description"><a id="idp3746576"></a><h2>Description</h2><p>Set the width of a table. Used only when there is at least
one column in the table without a fixed width, the
<em class="parameter"><code>table-width</code></em> has precedence over other
determinants of a table's width.</p><p>The <em class="parameter"><code>table.width</code></em> takes the values
allowed for the <a class="xref" href="default.table.width.html" title="default.table.width"><span class="refentrytitle">default.table.width</span></a> param, plus
more. The values shared with <a class="xref" href="default.table.width.html" title="default.table.width"><span class="refentrytitle">default.table.width</span></a> are:</p><div class="itemizedlist"><a id="table-width-format"></a><ul class="itemizedlist" type="disc"><li class="listitem"><p>A valid length (e.g. 15cm),</p></li><li class="listitem"><p>A percentage of the page width (e.g. 75%),</p></li><li class="listitem"><p>A keyword telling to apply an automatic column width (e.g.
autowidth.all).</p></li></ul></div></div><div class="refsection" title="Automatic Column Width"><a id="idp2174232"></a><h2>Automatic Column Width</h2><p><a id="pi-autowidth"></a>If you want to apply an automatic width only to some
specific tables you can put the Processing Instruction <code class="literal"><?dblatex
table-with="autowidth.<em class="replaceable"><code>scope</code></em>" ?></code> in the
related tables. The PI has precedence over the
<em class="parameter"><code>newtbl.autowidth</code></em> parameter.</p><p>The <em class="replaceable"><code>scope</code></em> can take the following values,
like in the <em class="parameter"><code>newtbl.autowidth</code></em> parameter:</p><div class="variablelist"><a id="autowidth-items"></a><dl><dt><span class="term">default</span></dt><dd><p>The automatic width (that is, latex is in charge to size the column
width) is applied only to columns not having a specified
<code class="sgmltag-element">colspec</code> colwidth. It includes both undefined
<code class="sgmltag-element">colspec</code>, and <code class="sgmltag-element">colspec</code> without the
colwidth attribute.</p></dd><dt><span class="term">all</span></dt><dd><p>the automatic width is applied to any column, whether a colspec is
provided or not.</p></dd></dl></div><p><a id="pi-autowidth-column"></a>In addition to these keywords, <em class="parameter"><code>table.width</code></em>
can also take for its value keywords of the form
<code class="literal">autowidth.column: <em class="replaceable"><code>N</code></em><em class="replaceable"><code> ...</code></em></code>, where <em class="replaceable"><code>N</code></em> is the number of the
column (counting from 1) which is to have its width automatically sized.</p><p>There is no default.</p></div><div class="refsection" title="Context"><a id="idp3092080"></a><h2>Context</h2><p>Recognized in the <code class="sgmltag-element">table</code> element.</p></div><div class="refsection" title="See Also"><a id="idm285728"></a><h2>See Also</h2><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><a class="xref" href="sec-table.html#sec-table-width" title="Table Width">the section called “Table Width”</a></li><li class="listitem"><a class="xref" href="sec-table.html#sec-newtbl-autowidth2" title="Local Setting">the section called “Local Setting”</a></li><li class="listitem"><a class="xref" href="default.table.width.html" title="default.table.width"><span class="refentrytitle">default.table.width</span></a></li><li class="listitem"><a class="xref" href="newtbl.autowidth.html" title="newtbl.autowidth"><span class="refentrytitle">newtbl.autowidth</span></a></li></ul></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="pi-dblatex_bgcolor.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="apbs04.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="sec-pi-lists.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">dblatex bgcolor </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Lists</td></tr></table></div></body></html>