Command/setupcolumns

From ConTeXt wiki

\setupcolumns

Syntax (autogenerated)

\setupcolumns[...=...,...]
nnumber
distancedimension
optionbackground
offsetdimension
commandoneargument
heightdimension
directionleft right
balanceyes no
alignsee \setupalign
tolerancesee \setuptolerance
blanksee \blank
ntopnumber
ruleon off command


Syntax

\setupcolumns[...,...=...,...]
n number
ntop number
rule on off
height dimension
tolerance verystrict strict tolerant verytolerant stretch
distance dimension
balance yes no
align yes no text
blank fixed halfline line flexible big medium small
option background
direction left right
[...,...=...,...] see \setupframed


Description

Consider using paragraphs (\defineparagraphs or column sets (\startcolumnset instead of ‘simple’ columns.

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, 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 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 ntop=7, then ConTeXt will produce one 12-line column rather than two 6-line columns. Note that ntop=6 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 ntop - n + 1.

Example

\setupcolumns[n=3, rule=on, ntop=4]

\startcolumns
  % 12 lines, please
  \dorecurse{12}{line\crlf}
\stopcolumns

See also

Help from ConTeXt-Mailinglist/Forum

All issues with: