Command/ section

From Wiki
< Command
Revision as of 13:53, 20 August 2020 by Taco (talk | contribs) (combined all the separate pages)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search


\section

Summary

The instances of \section produce a sectioning title.

Instances

\parthighest level of sectioning
\chapterlevel 2
\sectionlevel 3
\subsectionlevel 4
\subsubsectionlevel 5
\subsubsubsectionlevel 6
\subsubsubsubsectionlevel 7
\titlelevel 2, unnumbered
\subjectlevel 3, unnumbered
\subsubjectlevel 4, unnumbered
\subsubsubjectlevel 5, unnumbered
\subsubsubsubjectlevel 6, unnumbered
\subsubsubsubsubjectlevel 7, unnumbered

Settings instance

\SECTION[...,...]{...}
[...,...]reference
{...}text

OptionExplanation
reference Optional reference for referring to this sectioning head from elsewhere in the document
text The title to be typeset. Any numbering will be added automatically

Settings instance:assignment

\SECTION[...=...,...]
titletext
bookmarktext
markingtext
listtext
referencereference
ownnumbertext
placeholdertext

OptionExplanation
title
The title to be typeset
bookmark
The text for use in the table of contents and PDF bookmarks
marking
The text to use for subsequent use in header or footers
list
A list to use instead of the standard list (same name as command itself)
reference
A label to refer back to
ownnumber
Force a number
placeholder
Note sure what this does

Settings instance:ownnumber

\SECTION[...,...]{...}{...}
[...,...]reference
{...}number
{...}text

OptionExplanation
A label to refer back to
A forced number
The title to be typeset

Description

Any of the three macro calls above can be used. The #Settings instance:assignment gives the most control.

You can define heads yourself with \definehead. You can change the appearance with \setuphead.

Note: these instances are superseded by environments with the same basic name, see startsection.

Examples

Example 1


\setuphead[chapter][page=no]

\starttext

\chapter{Once Upon A Time}

This is the simplest form of using a chapter.

\chapter[mykey]{Once Upon A Time 2}

But what if you want to refer to this chapter at another time?
Give it a key! Before the chapter put something between brackets.
That's your key. Now you can refer to it. See the next chapter,
\in{chapter}[next].

\chapter[next]{After A While}

As we said earlier in chapter \in[mykey], we ...

As this example shows, use $\backslash$in[...] to refer to a chapter with
that name.

\stoptext

produces

Parts

By default \part generates no title because most of the times these require special attention and a specific design. In the background however the part numbering is active and carries out several initialisations. The other section commands are set up to typeset a title.

\setuppapersize[A7]

\part{One} % not typeset ...
\chapter{My chapter} % ... but this is Chapter 1 in Part 1

\part{Two}
\chapter{My chapter} % ... and this is Chapter 1 in Part 1

Unnumbered section heads

To remove the section number (as might be needed for Introduction) use one of the unnumbered instances (for example, use \subject instead of \section, or utilise the fact that no section numbers are used in the front matter:

\starttext

\startfrontmatter
    \section{Introduction}  % not numbered

    ...
\stopfrontmatter

\startbodymatter
    \section{Problem Statement}  % numbered
    ...
\stopbodymatter

\stoptext

Use of ownnumber

The options ownnumber in variant instance:assignment and [...] in variant instance:ownnumber both allow you to insert a specific number. Behind the scenes, numbering continues as normal:

\section[title={My first section}]
\section[title={My section},ownnumber={4}]
\section[title={My third section}]

Notes

See also

Help from ConTeXt-Mailinglist/Forum

All issues with: