93
edits
Changes
Showed how to recall the argument values.
<cd:commandgroup generated="yes" name="section" type="environment" xmlns:cd="http://wiki.contextgarden.net/commanddoc/20200807">
<cd:shortdesc><!-- a short command summary goes here -->
The instances of <tt>\start<i>section</i> ... \stop<i>section</i></tt> are used for wrapping a section text in an environment and typesetting its title.
</cd:shortdesc>
<cd:arguments>
<cd:assignments list="yes" optional="yes" ordinal="1">
<cd:assignmentsdoc>The first argument defines the visible and cross-referencing properties of the section. The argument values can be recalled with the {{cmd|namedstructurevariable}} command. </cd:assignmentsdoc>
<cd:parameter name="title">
<cd:paramdoc>is the title that will be used to create the section heading. Alternative versions of the title may also be specified, as explained below. The main title is used if these are not specified.
</cd:command>
</cd:variants>
<cd:description>This family of commands are only available in ConTeXt MkIV. They supersede the sectioning commands {{cmd|part}}, {{cmd|chapter}}, {{cmd|section}}, {{cmd|subsection}}, {{cmd|subsubsection}}, {{cmd|title}}, {{cmd|subject}}, {{cmd|subsubject}}, and {{cmd|subsubsubject}}.
The new commands, collectively documented here, are {{cmd|startpart}}, {{cmd|startchapter}}, {{cmd|startsection}}, {{cmd|startsubsection}}, {{cmd|startsubsubsection}}, {{cmd|starttitle}}, {{cmd|startsubject}}, {{cmd|startsubsubject}}, and {{cmd|startsubsubsubject}}. These more verbose commands apply an environment (\start- and \stop-) approach to sectioning, which is more friendly to tagged-PDF, ePUB and XML output.
</cd:description>
<cd:examples><cd:example title=""><context source="yes" text="produces">
\setuppapersize[A6,landscape]
\starttext
\stoptext
</context>
</cd:example> <cd:example title=""><context source="yes" text="produces">
\setuppapersize[A6,landscape]
\setuphead[chapter][page=no]
\stoptext
</context>
</cd:example></cd:examples><cd:notes><!-- this is for special remarks that do not fit elsewhere, like discovered bugs in specific context versions<cd:note author="..." date="..."></cd:note>--></cd:notes>
<cd:seealso>
<cd:commandref name="_section" originator="system">for the superceded commands</cd:commandref>
<cd:commandref name="definehead" originator="system"></cd:commandref>
<cd:commandref name="setuphead" originator="system"></cd:commandref>
<cd:commandref name="setupheads"></cd:commandref>
<cd:source file="strc-sec.mkiv" originator="system"></cd:source> <cd:wikipage originator="system" page="Category:Structure"></cd:wikipage> <cd:wikipage page="Titles"></cd:wikipage> </cd:seealso>
</cd:commandgroup>