Difference between revisions of "Command/setupheader"
< Command
Jump to navigation
Jump to search
(6 intermediate revisions by 4 users not shown) | |||
Line 3: | Line 3: | ||
|attributes= | |attributes= | ||
}} | }} | ||
+ | |||
+ | == [[Help:Reference|Syntax]] (autogenerated) == | ||
+ | <syntax>setupheader</syntax> | ||
== [[Help:Reference|Syntax]] == | == [[Help:Reference|Syntax]] == | ||
+ | |||
+ | <syntax>setupheader</syntax> | ||
+ | |||
<table cellspacing="4" cellpadding="2" class="cmd"> | <table cellspacing="4" cellpadding="2" class="cmd"> | ||
<tr> | <tr> | ||
Line 56: | Line 62: | ||
== Description == | == 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. | + | 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 <tt>state</tt>s and their effects: | The different <tt>state</tt>s and their effects: | ||
Line 84: | Line 90: | ||
|} | |} | ||
− | Note that when setting the state, before or after each applies to all parts of the page and it is therefore best set these by themselves as the first example below shows. For this reason state=high also affects the footer in that it | + | 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 == |
<texcode>\setupheader[state=empty]</texcode> | <texcode>\setupheader[state=empty]</texcode> | ||
<texcode>\setupheader[strut=yes,style=bold]</texcode> | <texcode>\setupheader[strut=yes,style=bold]</texcode> | ||
<texcode>\setupheader[text][after=\vskip 4pt \hrule]</texcode> | <texcode>\setupheader[text][after=\vskip 4pt \hrule]</texcode> | ||
+ | |||
+ | === Header with thin line below === | ||
+ | |||
+ | This is how to define header with thin line below, which does not appear on empty/blank page: | ||
+ | |||
+ | <context mode=mkiv source=yes> | ||
+ | \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 | ||
+ | </context> | ||
== See also == | == See also == | ||
<!-- something like {{cmd|goto}} --> | <!-- something like {{cmd|goto}} --> | ||
− | + | * {{cmd|setuplayouttext}} | |
− | {{cmd|setupheadertexts}} | + | * {{cmd|setupheadertexts}} |
− | {{cmd|setupfooter}} | + | * {{cmd|setupfooter}} |
− | {{cmd|setupfootertexts}} | + | * {{cmd|setupfootertexts}} |
== Help from ConTeXt-Mailinglist/Forum == | == Help from ConTeXt-Mailinglist/Forum == | ||
Line 102: | Line 127: | ||
{{Forum|{{SUBPAGENAME}}}} | {{Forum|{{SUBPAGENAME}}}} | ||
− | [[Category: | + | [[Category:Command/Layout|setupheader]] |
Latest revision as of 16:08, 12 November 2019
\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,]}, 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: