Changes

== Using Table of Contents Placing the ToC ==

One important quirk. If you do not start the document with \{{cmd|completecontent}}, but use it later –for example after the introduction–, you should use:

When \{{cmd|completecontent }} is at the end of the document you can use:

== Modifing Modifying the default Table of Contents ToC ==

The default head that \completecontent places can be altered with{{cmd|setupheadtext|[content=All my contents]}}. You can customize the appearance, number of shown levels and other attributes of predefined TOCToC. <span style="color:red; font-weight: bold;"> Please note that the <code>level</code> parameter has recently (02/2010) no effect in [[Mark IV]]</span>MkIV, however you can set the levels used in the table of contents with the list option. You may use <{{cmd>|placelist|[chapter,section]</cmd> }} (optionally adding <{{cmd>\|title|{Contents}</cmd> }} before) instead of <{{cmd>|setupcombinedlist|[content][level=2]</cmd>}}.

% TOC% level=4, \subsubsubsections are not listed in TOCToC

\setupcombinedlist[content][levellist=4{chapter,section,subsection,subsubsection},alternative=c,]% in MkII replace list with level=4: \subsubsubsections are not listed in ToC %\setuplist[chapter][width=5mm,style=bold]\setuplist[section][width=10mm,style=bold]

\setuplist[subsubsection][width=20mm,style=slanted,pagestyle=normal] \starttext \startcolor[darkgreen]\completecontent\stopcolor\page[yes] \section{First section}\subsection{First subsection}\subsubsection{First subsubsection}\subsubsubsection{First subsubsubsection}\section{Second section}\subsection{Second subsection}\subsubsection{Second subsubsection}\subsubsubsection{Second subsubsubsection}\stoptext</context> == Setting the number of sections in the ToC == To set the number of sections included in the table of contents you can explicitly set the list of items included in the 'contents' list. To include chapter, section, and subsection, in the table of contents use: <context mode=mkiv source="yes">

Or to include subsubsection in the table of contents as well use: <context mode=mkiv source="yes">\starttext \setupcombinedlist[content][list={chapter,section,subsection,subsubsection}] \startcolor[darkgreen]\completecontent\stopcolor\page[yes] \section{First section}\subsection{First subsection}\subsubsection{First subsubsection}\subsubsubsection{First subsubsubsection}\section{Second section}\subsection{Second subsection}\subsubsection{Second subsubsection}\subsubsubsection{Second subsubsubsection}\stoptext</context> In MkII this was achieved with the <code>level</code> parameter. == Including unnumbered heads in the ToC == ConTeXts head mechanism is designed in such a way that heads are stored in a list when they have an incrementing counter, so you must activate this for the 'unnumbered' heads (title, subject, subsubject, etc.) In addition, the {{cmd|placecontent}} command is an aggregate of only the numbered heads; to place a list that also includes unnumbered heads, you must manually specify all the heads you want. <context mode=mkii source=yes>% mode=mkii\setuphead[subject] [incrementnumber=yes, % keep track of the number number=no] % but don't show it % Set area in which number is placed: % distance from margin to left edge of title% NB: MkIV may ignore `width` % for unnumbered entries, and may require % you to set `margin`, instead.\setuplist[section][width=2cm]\setuplist[subject][width=2cm] \setupcombinedlist[content][list={chapter,subject,subsubject,section,subsection}] \setuppapersize[A7][A7]\starttext  \placecontent  \page  \chapter{One} \section{Sec A} \subject{Sub B} \section{Sec C}\stoptext</context> Quite probably, the un-numbered sections to be included are at the beginning or end of the document (e.g. a Preface and a Bibliography) and should *not* modify the enumeration of the actual numbered sections. In this case youhave to use "incrementnumber=list" instead. A slightly modified example would be: <context mode=mkiv source=yes>% mode=mkiv\setuppapersize[A7][A7] %list the "subject" sections in the ToC but don't modify the "section" counter:\setuphead[subject] [incrementnumber=list] %"width": distance between number and text in the ToC entry, "margin" : indent of ToC entry relative to left page margin\setuplist[section][width=1.5em] \setuplist[subsection][width=2.5em, margin=1.5em] \setuplist[subject][margin=1.5em] \setupcombinedlist[content][list={subject,section,subsection}] \starttext\completecontent\subject{Preface}\section{One}\subsection{Sec A}\section{Two}\subject{Bibliography}\stoptext</context> == Explicitly excluding headings from the ToC == To exclude headings from the table of contents, create a new heading that is a copy of the current heading. The new heading will not be in the list of heading that are printed to the table of contents (see previous section). The command to create a copy of a heading is {{cmd|definehead}}. Below is an example of excluding some subheadings from the table of contents. Note that typically this would be done for all subsections under a specific section, but as seen below this is not required: <context source="yes">\starttext % The first parameter is the new heading name, and the second is the% name of the heading that is copied.\definehead[mysubsection][subsection] \startcolor[darkgreen]\completecontent\stopcolor\page[yes] \section{First section}\subsection{First subsection}\mysubsection{Second subsection}\subsection{Third subsection}\stoptext</context>  == Page Numbering numbering in Table of Contents ToC ==

<span style="color:red; font-weight: bold;">'''The above method does not work in MkIV (not anymore at least).</span> ''' Hence the code below illustrates how to get it working under MkIV. (Seems the example got lost?) It should be noted that MkIV and MkII are incompatible with respect to this feature.

As an example, consider that the frontmatter uses roman numerals and bodymatter remains unchanged. To reflect the romannumerals of the front matter in the TOCToC,

== Forced Adjusting spacing between lines in ToC == Sometimes you want your ToC to be denser than the interlinespace used in the document in general. You can achieve this by wrapping the ToC. <texcode>\start\setupinterlinespace[small]\placecontent\stop</texcode> See {{cmd|setupinterlinespace}} for more options. == Swap Page Number and Title == To move the page break in number to the left of the section title, consider using a TOC command: <texcode>\define[3]\SectionListEntry {\par \leftaligned\bgroup \hbox to 2em{\color[red]{#3}}% \hskip 1em \vtop{\hsize\dimexpr\textwidth-3em\relax#2} \egroup \par} \setuplist[chapter][headnumber=no,pagenumber=no,style=\bfc]\setuplist[section][alternative=command,command=\SectionListEntry]</texcode> == Forced Page Break ==

Then, when you place your TOCToC, you have to call for the extras and define the spot for the break:

\placecontent[extras={6=page}] %puts break before Chapter 6 list item

Solution (MkIV solution given by Hans on the mailing list on September 2010-09-29, 2010, and applies to MKIV (at least.).

You can write "everything" desired items to the ToC or an other list (see below) using <{{cmd>|writetolist</cmd>}}.

Generally all "Table (List) of ..." are defined with <{{cmd>|definelist</cmd> }} and <{{cmd>|setuplist</cmd>}}.You can "collect" several section levels in one list using <{{cmd>|definecombinedlist</cmd>}}, that's even explained in "ConTeXt, an excursion" (see [[Official_ConTeXt_DocumentationManuals]]).

To have some parts of your title texts ''not'' appear in the table of contents, use <{{cmd>|nolist</cmd> }} and have a look at [http://www.pragma-ade.com/general/magazines/mag-0001.pdf mag-0001.pdf].

== How ConTeXt MkII generates the table of contents is generated by ConTeXt ToC == 

== Tables of contents (MkIV uses *.tuc files and other lists) via project structures ==uses less runs.

As of November 25, 2011, == ToC (and other lists) via project structures == ConTeXt [[Mark IV]] supports the generation of lists via [[Project structure]]. Thus, given a product (possibly within some project), and given two or more components in that product with its own sections (chapters, sections, etc) or floats (figures, tables, etc); then each component can have its own list of contents independent of the other. This is done by setting ''criterium=component''. For example, create three files, one product and two components (slightly modified version of a sample posted by Hansin 2011):