Changes

Jump to navigation Jump to search
432 bytes added ,  12:11, 29 December 2005
added some text; changed order of items, because "own styles" got too big
==Default==
 
Titles define the structure of your document. Decide yourself, how deep you want to nest them:
<table>
<tr bgcolor="#CCCCCC"><th>numbered</th><th>unnumbered</th></tr>
<tr><td><cmd>part</cmd></td><td>--&#151;</td></tr>
<tr><td><cmd>chapter</cmd></td><td><cmd>title</cmd></td></tr>
<tr><td><cmd>section</cmd></td><td><cmd>subject</cmd></td></tr>
<tr><td>...</td><td>...</td></tr>
</table>
 
The "unnumbered" versions don't appear in a table of contents! But you can switch off the numbering of the "numbered" versions with <cmd>setuphead</cmd> to get unnumbered titles ''and'' a toc (confusing?).
 
===Referencing Titles===
Every heading command can take an optional parameter as reference:
(see <cmd>at</cmd>)
==Titling Style== see <cmd>setuphead</cmd> and some enhanced samples below. A FAQ is how to get a line under the title:<texcode>\setupbackgrounds[header][text][bottomframe=on]</texcode> ==Your Own Titling Levels== Of course you can switch off numbering even for a define your own titling commands and probably must adapt the default settings. <texcode>\definehead[myheader][section] \setuphead[myheader][numberstyle=bold,textstyle=cap,before=\hairline\blank,after=\nowhitespace\hairline] \myheader[hasselt-ref]{Hasselt makes headlines}</texcode> A new header <cmd>myheader</cmd> is defined and it inherits the properties of <cmd>section</cmd> (title, subject, whatever).You can "numbereddefine" several headers at once! ==Table(s) of Contents== Default:<texcode>\completecontent % with title, see \placecontent % without title</texcode> Define your own "table of somewhat" with <cmd>definelist</cmd> and <cmd>setuplist</cmd>!You can "collect" several section levels in one list using <cmd>setupheaddefinecombinedlist</cmd>, that's even explained in "ConTeXt, an excursion" (see [[Official_ConTeXt_Documentation]]).
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. ===Page Numbering in Tables of Contents=== If you have a special page numbering style it won't automatically be reflected in the table of contents. You need to set the parameters of the table of contents separately. For example,  <texcode>\starttext\startfrontmatter\placecombinedlist[MyContentsList]\stopfrontmatter\startbodymatter\setuppagenumbering[way=bychapter, left=A, chapternumber=yes, numberseparator=/]...\stopbodymatter</texcode> will give you pagenumbering such as A1/1, A1/2 etc. on the pages in the bodymatter. In the table of contents, however, these will show up as 1-1, 1-2 etc. The ToC needs to be formatted separately.  To get a prefix to the page numbering (like "A"), use <texcode>\def\ChapterPrefix#1{A#1}\setuplist[chapter][pagecommand=\ChapterPrefix]</texcode> To get the numberseparator working, you need to know that the ToC will use the separator that is active ''at the time the ToC is output''. So you need to set it immediately before you call the ToC command, e.g. <texcode>\setuppagenumbering[numberseparator=/]\placecombinedlist[MyContentsList]</texcode> ==Your own title stylesOwn Title Styles==
Sometimes the possibilities of <cmd>setuphead</cmd> aren't enough.
<texcode>
\def\MyChapterCommand#1#2{\framed[frame=off, bottomframe=on, topframe=on]{\vbox{\headtext{chapter} \vbox{#1\blank#2}}}
% #1 is number, #2 is text
% \vbox is needed for \blank to work
 
\setuphead[chapter][command=\MyChapterCommand, style={\ss\bfa}]
 \setupheadtext[chapter=Chapter]% used by \headtext
</texcode>
so <tt>\chapter{My First Chapter}</tt> looks like:
</context>
Willi Egger posted the following two examples of a simple line under the chapter title, and a complex graphical element under the chapter title.
Here's ===A complex graphical element under the simple line:<texcode>\setupbackgrounds[header][text][bottomframechapter title===on]</texcode>
Here's the graphical element:
<texcode>
\setupcolors[state=start]
It looks like:
 
<context>
\setupcolors[state=start]
\startuseMPgraphic{HeaderDeco}
numeric w, h, repeats;
\stoptext
</context>
 
==Your own titling levels==
 
Of course you can define your own titling commands and probably must adapt the default settings.
 
<texcode>
\definehead[myheader][section]
 
\setuphead[myheader]
[numberstyle=bold,
textstyle=cap,
before=\hairline\blank,
after=\nowhitespace\hairline]
 
\myheader[hasselt-ref]{Hasselt makes headlines}
</texcode>
 
A new header <tt>\myheader</tt> is defined and it inherits the properties of <tt>section</tt> (title, subject, whatever).
You can "define" several headers at once!
 
 
==Table(s) of Contents==
 
Default:
<texcode>
\completecontent % with title
\placecontent % without title
</texcode>
 
Define your own tables of somewhat with <cmd>definelist</cmd> and <cmd>setuplist</cmd>!
 
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.
 
==Page numbering in tables of contents==
 
If you have a special page numbering style it won't automatically be reflected in the table of contents. You need to set the parameters of the table of contents separately. For example,
 
<texcode>
\starttext
\startfrontmatter
\placecombinedlist[MyContentsList]
\stopfrontmatter
\startbodymatter
\setuppagenumbering[way=bychapterleft=A,chapternumber=yes,numberseparator=/]
...
\stopbodymatter
</texcode>
 
will give you pagenumbering such as A1/1, A1/2 etc. on the pages in the bodymatter. In the table of contents, however, these will show up as 1-1, 1-2 etc. The ToC needs to be formatted separately.
 
To get a prefix to the page numbering (like "A"), use
 
<texcode>
\def\ChapterPrefix#1{A#1}
\setuplist[chapter][pagecommand=\ChapterPrefix]
</texcode>
 
To get the numberseparator working, you need to know that the ToC will use the separator that is active ''at the time the ToC is output''. So you need to set it immediately before you call the ToC command, e.g.
 
<texcode>
\setuppagenumbering[numberseparator=/]
\placecombinedlist[MyContentsList]
</texcode>

Navigation menu