Command/setupheader

Syntax (autogenerated)

\setupheader[...][...=...,...]
[...]	text margin edge
state	start stop empty high none normal nomarking name
style	style command
color	color
strut	yes no
n	number
before	command
after	command
lefttext	text
middletext	text
righttext	text
leftstyle	style command
middlestyle	style command
rightstyle	style command
leftcolor	color
middlecolor	color
rightcolor	color
width	dimension
leftwidth	dimension
middlewidth	dimension
rightwidth	dimension

Syntax

\setupheader[...][...=...,...]
[...]	text margin edge
state	start stop empty high none normal nomarking name
style	style command
color	color
strut	yes no
n	number
before	command
after	command
lefttext	text
middletext	text
righttext	text
leftstyle	style command
middlestyle	style command
rightstyle	style command
leftcolor	color
middlecolor	color
rightcolor	color
width	dimension
leftwidth	dimension
middlewidth	dimension
rightwidth	dimension

\setupheader[...][...,...=...,...]
[...]	text margin edge
state	normal stop start empty high none nomarking name
strut	yes no
style	normal bold slanted boldslanted type cap small... command
leftstyle	normal bold slanted boldslanted type cap small... command
rightstyle	normal bold slanted boldslanted type cap small... command
leftwidth	dimension Limit the text inside the header to a certain dimension. Setting this value may interfere with any additional `\delimitatetext` or `\doboundtext` performed inside the headers
rightwidth	dimension
before	command
after	command

Description

The first argument is assumed to be "text" when it is left out. Text sets the position of the header and/or footer directly over or under the pagebody. Margin places the content in the margin of the document.

The different states and their effects:

`start`, `stop`	switch headings on and off
`none`	switch off for whole chapter
`empty`	no heading on the first chapter page
`high`	no heading on the first chapter page + expand textarea about space occupied by heading.
`text`	some 'text' defined by \definetext[text][footer][pagenumber] or \definetext[text][footer][left][right] which is valid on the first chapter page

Note that when setting the state, before or after each applies to all parts of the page and it is therefore best to set these by themselves as the first example below shows. For this reason state=high also affects the footer in that it removes the footer leaving no whitespace.

Examples

\setupheader[state=empty]

\setupheader[strut=yes,style=bold]

\setupheader[text][after=\vskip 4pt \hrule]

Header with thin line below

This is how to define header with thin line below, which does not appear on empty/blank page:

\setupheader
  [text]
  [before={\startframed[frame=off,bottomframe=on,framecolor=blue,offset=0pt,boffset=0.25ex,]},
   after={\stopframed},
  ]
\setupheadertexts[Text left][Text right]
 
\starttext
  Page 1
  \page[empty,blank]
  Page 2
\stoptext

(Note: The parameter offset=0pt is added to correct the (most of the) extension of the line beyond the text width on the right. The width of the line seems to still slightly exceed the text width; this can be corrected by adding a negative \kern before \stopframed, or using \hrule as shown above.)

Help from ConTeXt-Mailinglist/Forum

All issues with: