\setuplist
Summary
The command \setuplist configures collected lists like for the TOC
Settings
Option | Explanation |
criterium |
|
width |
The width of the heading number (which is left aligned). |
|
margin |
Extra indent between the margin (where text would normally start) and the heading number. |
|
distance |
The gap between the heading number and the heading. |
|
interaction |
|
order |
title |
sorts the list by title |
|
alternative |
Overall layout of the list. The alternatives a, b, c, etc. are predefined. The most flexible solution to implement a custom layout is to define a new custom one which can be set as argument to alternative, see \definelistalternative for exact details. |
a |
number – title – pagenumber |
b |
number – title – spaces – pagenumber |
c |
number – title – dots – pagenumber |
d |
number – title – pagenumber (continuous) |
e |
title (framed) |
f |
title (left, middle or right aligned) |
g |
title (centered) |
command |
use with own 3-parameter macro, e.g command=\MyListEntry . removes linking and bookmarks in the parameters, unless added by the supplied macro. |
interactive |
use with own 3-parameter macro command=\MyListEntry . keeps linking and bookmarks in the parameters. |
|
Description
Examples
Unnumbered ToC items, with some shift
Sometimes we need to insert unnumbered items into the ToC, and to specify them horizontal shift to "keep the look" of the other (numbered) items. Here "margin" option comes into play:
\setuppapersize[A7,landscape]
\setuplist[alternative=c]
\setuphead[subsubsection][number=no]
\setuplist[subsubsection][margin=20mm]
\starttext
\placecontent
\hairline
\section{Section}
\subsection{Subsection}
\subsubsection{Subsubsection}
\stoptext
Use different alternatives for different levels in the same ToC
You can use different alternatives for different levels.
\setuppapersize[A7,landscape]
\setuplist[alternative=c]
\setuplist[subsection][alternative=d]
\starttext
\placecontent
\hairline
\section{Section}
\subsection{Subsection}
\subsubsection{Subsubsection}
\stoptext
Left-hand page numbers
The following example positions the page number to the left of the list entry title:
\define[3]\SectionToCEntry{
\leftaligned\bgroup
\hbox to 2em{#3}
\hskip 1em
\vtop{\hsize\dimexpr\textwidth-3em\relax#2}
\egroup
}
\setuplist
[section]
[alternative=interactive,
command=\SectionToCEntry,
after=\endgraf]
The alternative=interactive
is required to maintain hyperlinked page numbers when links are enabled in the document. Without the after=\endgraf
items would be displayed on one line.
Using tabular numbers
In a long TOC it looks awkward if proportional numbers are used. It is better to enable the font feature tabularnumbers:
\setuplist
[chapter]
[pagestyle={\feature[+][tabularnumbers]}]
Notes
See also
Help from ConTeXt-Mailinglist/Forum