Command/setupheader

From Wiki
Jump to navigation Jump to search

\setupheader

Syntax (autogenerated)

\setupheader[...][...=...,...]
[...]text margin edge
statestart stop empty high none normal nomarking name
stylestyle command
colorcolor
strutyes no
nnumber
beforecommand
aftercommand
lefttexttext
middletexttext
righttexttext
leftstylestyle command
middlestylestyle command
rightstylestyle command
leftcolorcolor
middlecolorcolor
rightcolorcolor
widthdimension
leftwidthdimension
middlewidthdimension
rightwidthdimension


Syntax

\setupheader[...][...=...,...]
[...]text margin edge
statestart stop empty high none normal nomarking name
stylestyle command
colorcolor
strutyes no
nnumber
beforecommand
aftercommand
lefttexttext
middletexttext
righttexttext
leftstylestyle command
middlestylestyle command
rightstylestyle command
leftcolorcolor
middlecolorcolor
rightcolorcolor
widthdimension
leftwidthdimension
middlewidthdimension
rightwidthdimension


\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,]},
   after={\stopframed},
  ]
\setupheadertexts[Text left][Text right]
 
\starttext
  Page 1
  \page[empty,blank]
  Page 2
\stoptext

See also

Help from ConTeXt-Mailinglist/Forum

All issues with: