Command/setupcolumns

Syntax (autogenerated)

\setupcolumns[...=...,...]
...=...,...	inherits from \setupmixedcolumns

Syntax

\setupcolumns[...,...=...,...]
n	number
ntop	number
rule	on off – DEPRECATED - use "separator=rule" instead
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	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 (gutter) 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, % DEPRECATED
     separator=rule, % need newly instead "rule=on"
     ntop=4,background=color,backgroundcolor=green,
    ]
  
  \startcolumns
    % 12 lines, please
    \dorecurse{12}{line\crlf}
  \stopcolumns
  

• 

See also

• \startcolumns to start a columnar environment.
• \column to move to the next column.
• \setupparagraphs for the analogous command for side-by-side paragraphs

Help from ConTeXt-Mailinglist/Forum

All issues with:

• setupcolumns on the mailing list (all results)
• setupcolumns on the mailing list (subject only)
• setupcolumns on stack exchange
• setupcolumns in ConTeXt's source

v · d · e Columns General overview Columns Commands Columns \setupcolumns \startcolumns \column Paragraphs \defineparagraphs \setupparagraphs \startparagraph \paragraph Columnsets \definecolumnset \setupcolumnsetlines \setupcolumnsetstart \startcolumnset Manuals Columnsets manual Source files page-set.mkii page-mul.mkii page-set.mkiv page-col.mkiv page-mix.mkiv page-mul.mkiv Examples Skdk style MAPS style (mkii, mkiv)