Changes

Jump to navigation Jump to search
4,171 bytes added ,  07:37, 21 August 2020
no edit summary
<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:sequence>
</cd:sequence>
<cd:instances>
<cd:constant value="part">highest level of sectioning</cd:constant> <cd:constant value="chapter">level 2</cd:constant> <cd:constant value="section">level 3</cd:constant> <cd:constant value="subsection">level 4</cd:constant> <cd:constant value="subsubsection">level 5</cd:constant> <cd:constant value="subsubsubsection">level 6</cd:constant> <cd:constant value="subsubsubsubsection">level 7</cd:constant> <cd:constant value="title">level 2, unnumbered</cd:constant> <cd:constant value="subject">level 3, unnumbered</cd:constant> <cd:constant value="subsubject">level 4, unnumbered</cd:constant> <cd:constant value="subsubsubject">level 5, unnumbered</cd:constant> <cd:constant value="subsubsubsubject">level 6, unnumbered</cd:constant> <cd:constant value="subsubsubsubsubject">level 7, unnumbered</cd:constant>
</cd:instances>
<cd:variants>
<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. </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.If you need a line break in a title, you can use <tt>\\</tt>, it will create a line break on location, but a space in list and marking context. Unfortunately it will appear literally in PDF bookmarks.</cd:paramdoc>
<cd:constant type="cd:text"></cd:constant>
</cd:parameter>
<cd:parameter name="bookmark">
<cd:paramdoc>is used in PDF bookmarks, if enabled (see {{cmd|setupinteraction}} and {{cmd|placebookmarks}}). </cd:paramdoc>
<cd:constant type="cd:text"></cd:constant>
</cd:parameter>
<cd:parameter name="marking">
<cd:paramdoc>is used in headers and footers.</cd:paramdoc>
<cd:constant type="cd:text"></cd:constant>
</cd:parameter>
<cd:parameter name="list">
<cd:paramdoc>is used in combined-lists (i.e. the table of contents).</cd:paramdoc>
<cd:constant type="cd:text"></cd:constant>
</cd:parameter>
<cd:parameter name="reference">
<cd:paramdoc>specifies the reference-key for use with cross-referencing commands (see {{cmd|at}} and {{cmd|in}}).</cd:paramdoc>
<cd:constant type="cd:reference"></cd:constant>
</cd:parameter>
<cd:parameter name="ownnumber">
<cd:paramdoc>a sectioning number to use instead of the calculated one.</cd:paramdoc>
<cd:constant type="cd:text"></cd:constant>
</cd:parameter>
</cd:assignments>
<cd:assignments list="yes" optional="yes" ordinal="2">
<cd:assignmentsdoc>The second, optional, argument allows section-local user-variables to be assigned. The values of these variables can be recalled with the {{cmd|structureuservariable}} command.</cd:assignmentsdoc>
<cd:parameter name="cd:key">
<cd:paramdoc></cd:paramdoc>
</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. Sectioning is hierarchical. Numbered ''parts'' are divided into numbered ''chapters'', themselves divided into numbered ''sections'', ''subsections'', and ''subsubsections'' etc. Chapters and sections etc. have unnumbered counterparts called ''titles'', ''subjects'', ''subsubjects'', and ''subsubsubjects'' etc., respectively. (There are actually a couple more sub- levels than listed here.) ''Chapters'' start a new page (by default—this is easily configurable). ''Parts'' are unusual in two respects: firstly, there is no unnumbered counterpart to parts; and secondly, the long description title of a part is not typeset automatically, as it will generally require special attention and design. Additional section types can be defined (based on one of the existing sections) with the {{cmd|definehead}} command goes . A user-defined section type will have its own \start- and \stop<i>section</i> commands, in addition to a traditional \<i>section</i> command. These new commands will behave as documented here  The typesetting of section types (both built-in and user->defined) can be controlled with the {{cmd|setupheads}} and {{cmd|setuphead}} commands.  
</cd:description>
<cd:examples>
<!-- command example(s)
<cd:example title="">
<context source="yes" text="produces">
\setuppapersize[A5]
\starttext
 
\startsection[
reference=sec:One,
title={Section One},
]
 
For a subsection, see \in{subsection}[sec:Two:Sec].
 
\stopsection
 
\startsection[
reference=sec:Two,
title={Section Two},
]
[a_variable={some value}]
 
a_variable=\quote{\structureuservariable{a_variable}}.
 
\startsubsection[
reference=sec:Two:Sec,
title={Here’s a subsection},
]
 
In this subsection there’s some text\ldots
 
\stopsubsection
\stopsection
\stoptext
</context>
</cd:example>
 
<cd:example title="">
<context source="yes" text="produces">
\setuppapersize[A5]
\setuphead[chapter][page=no]
\starttext
 
\startpart[title={Part}]
\startchapter[title={Chapter}]
\startsection[title={Section}]
\startsubsection[title={Subsection}]
\startsubsubsection[title={Subsubsection}]
\startsubsubsubsection[title={Subsubsubsection}]
\startsubsubsubsubsection[title={Subsubsubsubsection}]
 
\stopsubsubsubsubsection
\stopsubsubsubsection
\stopsubsubsection
\stopsubsection
\stopsection
\stopchapter
\stoppart
\stoptext
</context>
</cd:example>
-->
</cd:examples>
<cd:notes>
<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>

Navigation menu