3,899
edits
Changes
Jump to navigation
Jump to search
Command/startcolumnset (view source)
Revision as of 09:30, 14 September 2023
, 09:30, 14 September 2023Created page with "Documentation for \startcolumnset ... \stopcolumnset"
<cd:commandgroup name="columnset" type="environment" xmlns:cd="http://wiki.contextgarden.net/commanddoc/20200807">
<cd:shortdesc><!-- a short command summary goes here -->
The environment <tt>\startcolumnset ... \stopcolumnset</tt> is used for material in columns.
</cd:shortdesc>
<cd:variants>
<cd:command category="columns" file="page-cst.mkiv" interfacedate="2020-07-14T09:24" interfacefile="i-pagegrid.xml" keywords="structure layout" level="document" name="columnset" type="environment" variantnumber="1">
<cd:arguments>
<cd:keywords optional="yes" ordinal="1">
<cd:keywordsdoc></cd:keywordsdoc>
<cd:constant type="cd:name"></cd:constant>
</cd:keywords>
<cd:assignments list="yes" optional="yes" ordinal="2">
<cd:assignmentsdoc></cd:assignmentsdoc>
<cd:inherit name="setupcolumnset"></cd:inherit>
</cd:assignments>
</cd:arguments>
</cd:command>
</cd:variants>
<cd:description>Start a column environment using the columnset mechanism.
</cd:description>
<cd:examples><cd:example title=""><context source="yes">
\starttext
\setuppapersize[A6,landscape]
\definecolumnset[TwoColumns][n=2]
\startcolumnset [TwoColumns]
\startalignment[justified,verytolerant]
\input knuth
\blank
\framed
[frame=off,
bottomframe=on,
width=\textwidth,
frameoffset=1mm,
foregroundstyle=small,
]{\copyright\ Donald E. Knuth}
\input zapf
\blank
\framed
[frame=off,
bottomframe=on,
width=\textwidth,
frameoffset=1mm,
foregroundstyle=small,
]{\copyright\ Hermann Zapf}
\stopalignment
\stopcolumnset
\stoptext
</context></cd:example><cd:example title="Overlapping lines problems">Using columnsets may cause overlapping lines at the end of columns.
To avoid this, <code>\setuplayout[grid=yes]</code> must be placed in the preamble of the document.
<context source="yes">
\setuppapersize[A6,landscape]
\definecolumnset[example][n=3,balancing=no]
\definecolumnsetspan[wide][n=2]
\setupexternalfigures[location=default]
\setuplayout[grid=yes] % Without this, last lines in the first column overlap
%
\starttext
\noheaderandfooterlines
\startcolumnset[example]
\startcolumnsetspan[wide]
\externalfigure[hacker][width=60mm]
\stopcolumnsetspan
\input knuth
\stopcolumnset
\stoptext
</context>
</cd:example></cd:examples>
<cd:notes></cd:notes>
<cd:seealso>
<cd:commandref name="definecolumnset" originator="system"></cd:commandref>
<cd:commandref name="setupcolumnset" originator="system"></cd:commandref>
<cd:source file="page-cst.mkiv" originator="system"></cd:source>
<cd:wikipage originator="system" page="Category:Columns"></cd:wikipage>
<cd:wikipage originator="system" page="Keywords:Layout"></cd:wikipage>
<cd:wikipage originator="system" page="Keywords:Structure"></cd:wikipage>
<cd:commandref name="startcolumns">for an alternative column mechanism</cd:commandref></cd:seealso>
</cd:commandgroup>
<cd:shortdesc><!-- a short command summary goes here -->
The environment <tt>\startcolumnset ... \stopcolumnset</tt> is used for material in columns.
</cd:shortdesc>
<cd:variants>
<cd:command category="columns" file="page-cst.mkiv" interfacedate="2020-07-14T09:24" interfacefile="i-pagegrid.xml" keywords="structure layout" level="document" name="columnset" type="environment" variantnumber="1">
<cd:arguments>
<cd:keywords optional="yes" ordinal="1">
<cd:keywordsdoc></cd:keywordsdoc>
<cd:constant type="cd:name"></cd:constant>
</cd:keywords>
<cd:assignments list="yes" optional="yes" ordinal="2">
<cd:assignmentsdoc></cd:assignmentsdoc>
<cd:inherit name="setupcolumnset"></cd:inherit>
</cd:assignments>
</cd:arguments>
</cd:command>
</cd:variants>
<cd:description>Start a column environment using the columnset mechanism.
</cd:description>
<cd:examples><cd:example title=""><context source="yes">
\starttext
\setuppapersize[A6,landscape]
\definecolumnset[TwoColumns][n=2]
\startcolumnset [TwoColumns]
\startalignment[justified,verytolerant]
\input knuth
\blank
\framed
[frame=off,
bottomframe=on,
width=\textwidth,
frameoffset=1mm,
foregroundstyle=small,
]{\copyright\ Donald E. Knuth}
\input zapf
\blank
\framed
[frame=off,
bottomframe=on,
width=\textwidth,
frameoffset=1mm,
foregroundstyle=small,
]{\copyright\ Hermann Zapf}
\stopalignment
\stopcolumnset
\stoptext
</context></cd:example><cd:example title="Overlapping lines problems">Using columnsets may cause overlapping lines at the end of columns.
To avoid this, <code>\setuplayout[grid=yes]</code> must be placed in the preamble of the document.
<context source="yes">
\setuppapersize[A6,landscape]
\definecolumnset[example][n=3,balancing=no]
\definecolumnsetspan[wide][n=2]
\setupexternalfigures[location=default]
\setuplayout[grid=yes] % Without this, last lines in the first column overlap
%
\starttext
\noheaderandfooterlines
\startcolumnset[example]
\startcolumnsetspan[wide]
\externalfigure[hacker][width=60mm]
\stopcolumnsetspan
\input knuth
\stopcolumnset
\stoptext
</context>
</cd:example></cd:examples>
<cd:notes></cd:notes>
<cd:seealso>
<cd:commandref name="definecolumnset" originator="system"></cd:commandref>
<cd:commandref name="setupcolumnset" originator="system"></cd:commandref>
<cd:source file="page-cst.mkiv" originator="system"></cd:source>
<cd:wikipage originator="system" page="Category:Columns"></cd:wikipage>
<cd:wikipage originator="system" page="Keywords:Layout"></cd:wikipage>
<cd:wikipage originator="system" page="Keywords:Structure"></cd:wikipage>
<cd:commandref name="startcolumns">for an alternative column mechanism</cd:commandref></cd:seealso>
</cd:commandgroup>
