Changes

Jump to navigation Jump to search
803 bytes added ,  12:53, 14 January 2020
}}
== [[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]] </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" ‘simple’ columns.
ntop has to do with balancing{| class="wikitable"|-| 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 | 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, but I raggedright).|- | blank | Amount of whitespace between paragraphs set in columns. Also accepts a dimension as an argument. Column equivalent of {{cmd|setupwhitespace}}.|- | option | With option=background you can't make sense of ituse everything that \setupframed offers. See page|-mult| direction | Default is right, i.e.tex / minbalancetoplinesthe 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 should have. If, when a new set of columns starts (e.g. at the start of 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 ==
<!-- Please fill in an example if you can --context source=yes>\setupcolumns[n=3,rule=on,ntop=4,background=color,backgroundcolor=green,] \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- something like [[cmdside paragraphs == Help from ConTeXt-Mailinglist/Forum ==All issues with:goto{{Forum|\goto]] -->{{SUBPAGENAME}}}} {{Columns navbox}}
[[Category:CommandsCommand/Columns|setupcolumns]]
105

edits

Navigation menu