Difference between revisions of "Command/setupcolumns"

From Wiki
Jump to navigation Jump to search
(move {{Columns navbox}})
(5 intermediate revisions by 2 users not shown)
Line 4: Line 4:
 
}}
 
}}
  
 +
== [[Help:Reference|Syntax]] (autogenerated) ==
 +
<syntax>setupcolumns</syntax>
 
== [[Help:Reference|Syntax]] ==
 
== [[Help:Reference|Syntax]] ==
 
<table cellspacing="4" cellpadding="2" class="cmd">
 
<table cellspacing="4" cellpadding="2" class="cmd">
Line 19: Line 21:
 
   <tr valign="top" class="first">
 
   <tr valign="top" class="first">
 
     <td class="cmd">[[Command/keyword:rule|rule]]</td>
 
     <td class="cmd">[[Command/keyword:rule|rule]]</td>
     <td>[[Command/value:on|on]] [[Command/value:off|off]] </td>
+
     <td>[[Command/value:on|on]] [[Command/value:off|off]] – DEPRECATED - use "separator=rule" instead </td>
 
   </tr>
 
   </tr>
 
   <tr valign="top" class="first">
 
   <tr valign="top" class="first">
Line 58: Line 60:
 
   </tr>
 
   </tr>
 
</table>
 
</table>
 
  
 
== Description ==  
 
== Description ==  
Line 70: Line 71:
 
|-
 
|-
 
| rule  
 
| rule  
| Draw a line between the columns. Default is off.
+
| DEPRECATED: Draw a line between the columns. Default is off.
 +
|-
 +
| separator=rule
 +
| Add vertical line between columns.
 
|-
 
|-
 
| tolerance  
 
| tolerance  
Line 102: Line 106:
 
== Example ==
 
== Example ==
 
<context source=yes>
 
<context source=yes>
\setupcolumns[n=3, rule=on, ntop=4]
+
\setupcolumns
 +
  [n=3,
 +
  rule=on, % DEPRECATED
 +
  separator=rule, % need newly instead "rule=on"
 +
  ntop=4,background=color,backgroundcolor=green,
 +
  ]
  
 
\startcolumns
 
\startcolumns

Revision as of 13:34, 22 May 2020

\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 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

Help from ConTeXt-Mailinglist/Forum

All issues with: