Changes

Jump to navigation Jump to search
<!-- please remove this and the following line if you have checked this page -->
{{Reference_Cleanup}}
{{Reference
|name=setupcolumns
}}
== [[Help:Reference|Syntax]] (autogenerated) ==
<syntax>setupcolumns</syntax>
== [[Help:Reference|Syntax]] ==
<table cellspacing="4" cellpadding="2" class="cmd">
</tr>
<tr valign="top" class="first">
<td class="cmd">[[Reference/enCommand/keyword:n|n]]</td> <td>[[Reference/enCommand/value:number|number]] </td>
</tr>
<tr valign="top" class="first">
<td class="cmd">[[Reference/enCommand/keyword:ntop|ntop]]</td> <td>[[Reference/enCommand/value:number|number]] </td>
</tr>
<tr valign="top" class="first">
<td class="cmd">[[Reference/enCommand/keyword:rule|rule]]</td> <td>[[Reference/enCommand/value:on|on]] [[Reference/enCommand/value:off|off]] – DEPRECATED - use "separator=rule" instead </td>
</tr>
<tr valign="top" class="first">
<td class="cmd">[[Reference/enCommand/keyword:height|height]]</td> <td>[[Reference/enCommand/value:dimension|dimension]] </td>
</tr>
<tr valign="top" class="first">
<td class="cmd">[[Reference/enCommand/keyword:tolerance|tolerance]]</td> <td>[[Reference/enCommand/value:verystrict|verystrict]] [[Reference/enCommand/value:strict|strict]] [[Reference/enCommand/value:tolerant|tolerant]] [[Reference/enCommand/value:verytolerant|verytolerant]] [[Reference/enCommand/value:stretch|stretch]] </td>
</tr>
<tr valign="top" class="first">
<td class="cmd">[[Reference/enCommand/keyword:distance|distance]]</td> <td>[[Reference/enCommand/value:dimension|dimension]] </td>
</tr>
<tr valign="top" class="first">
<td class="cmd">[[Reference/enCommand/keyword:balance|balance]]</td> <td>[[Reference/enCommand/value:yes|yes]] [[Reference/enCommand/value:no|no]] </td>
</tr>
<tr valign="top" class="first">
<td class="cmd">[[Reference/enCommand/keyword:align|align]]</td> <td>[[Reference/enCommand/value:yes|yes]] [[Reference/enCommand/value:no|no]] [[Reference/enCommand/value:text|text]] </td>
</tr>
<tr valign="top" class="first">
<td class="cmd">[[Reference/enCommand/keyword:blank|blank]]</td> <td>[[Reference/enCommand/value:fixed|fixed]] [[Reference/enCommand/value:halfline|halfline]] [[Reference/enCommand/value:line|line]] [[Reference/enCommand/value:flexible|flexible]] [[Reference/enCommand/value:big|big]] [[Reference/enCommand/value:medium|medium]] [[Reference/enCommand/value:small|small]] </td>
</tr>
<tr valign="top" class="first">
<td class="cmd">[[Reference/enCommand/keyword:option|option]]</td> <td>[[Reference/enCommand/value:background|background]] </td>
</tr>
<tr valign="top" class="first">
<td class="cmd">[[Reference/enCommand/keyword:direction|direction]]</td> <td>[[Reference/enCommand/value:left|left]] [[Reference/enCommand/value:right|right]] </td>
</tr>
<tr valign="top" class="first">
<td class="cmd">[...,...=...,...]</td>
<td>see [[Reference/enCommand/setupframed|\setupframed]] </td>
</tr>
</table>
 
== Description ==
<pre>
n: number of columns, default is n=2
rule: draw a line between the columns, default is off
tolerance: affects spacing, narrow columns should be set tolerant, verytolerant or stretch
distance: gap between the columns
balance: should the columns be balanced, i.e. should they get the same number of lines?
align: left, right (raggedleft, raggedright)
blank: amount of whitespace between paragraphs set in columns. Also accepts a dimension as an argument. Column equivalent of \setupwhitespace
option: with option=background you can use everything that \setupframed offers
direction: default is right, i.e. the first column is on the left; 'left' means the first column is the rightmost.
height: ?
ntop: ?
</pre>== comment ==Consider using paragraphs ({{cmd|defineparagraphs}} or column sets ({{cmd|startcolumnset}} instead of ‘simple’ columns.
Consider using {| class="wikitable"|-| n | Number of columns. Default is n=2.|-| rule | DEPRECATED: Draw a line between the columns. Default is off.|-| separator=rule| Add vertical line between columns.|-| tolerance | Affects spacing. Narrow columns should be set tolerant, verytolerant or stretch|- | distance | Size of the gap between the columns.|- | balance | Should the columns be balanced, i.e. should they get the same number of lines?|- | align | Left, right (raggedleft, raggedright).|- | blank | Amount of whitespace between paragraphs or set in columns. Also accepts a dimension as an argument. Column equivalent of {{cmd|setupwhitespace}}.|- | option | With option=background you can use everything that \setupframed offers.|- | direction | Default is right, i.e. the first column is on the left; 'left' means the first column is the rightmost.|- | height | height is unclear to me.|- | ntop | ntop contains the minimum number of lines a column sets instead should have. If, when a new set of columns starts (e.g. at the start of "simple" a page), there are 12 lines to distribute and <code>ntop=7</code>, then ConTeXt will produce one 12-line column rather than two 6-line columns.Note that <code>ntop=6</code> will result in one 7-line column and one 5-line column: ConTeXt seems to prefer that the last column be shorter, as long as its length is at least <code>ntop - n + 1</code>.|}
== Example ==<context source=yes>\setupcolumns [n=3, rule=on, % DEPRECATED separator=rule, % need newly instead "rule=on" ntop has to do with balancing=4,background=color,backgroundcolor=green, but I can't make sense of it. See page-mult.tex / minbalancetoplines. height is unclear to me ]
--pg\startcolumns % 12 lines, please \dorecurse{12}{line\crlf}\stopcolumns</context>
== See also ==
* {{cmd|startcolumns}} to start a columnar environment.
* {{cmd|column}} to move to the next column.
* {{cmd|setupparagraphs}} for the analogous command for side-by-side paragraphs
== Example Help from ConTeXt-Mailinglist/Forum ==<!-- Please fill in an example if you can -->All issues with:{{Forum|{{SUBPAGENAME}}}}
== See also ==<!-- something like [[cmd:goto|\goto]] -->{{Columns navbox}}
[[Category:ReferenceCommand/enColumns|setupcolumns]]
105

edits

Navigation menu