From ConTeXt wiki



width dimension fit middle
height dimension fit middle
backspace dimension
topspace dimension
margin dimension
leftmargin dimension
rightmargin dimension
header dimension
footer dimension
top dimension
bottom dimension
leftedge dimension
rightedge dimension
headerdistance dimension
footerdistance dimension
topdistance dimension
bottomdistance dimension
leftmargindistance dimension
rightmargindistance dimension
leftedgedistance dimension
rightedgedistance dimension
horoffset dimension
veroffset dimension
style normal bold slanted boldslanted type cap small... command
color name
marking on off color screen text
location left middle right bottom top singlesided doublesided
scale dimension
nx number
ny number
dx dimension
dy dimension
lines number
columns number
columndistance dimension
grid yes no more see below
bottomspace dimension
cutspace dimension
textdistance dimension
textwidth number
textmargin dimension
clipoffset dimension
page name
paper name



If the document is singlesided, then the 'outside' is the right side and the 'inside' is the left side.

The width parameter sets \makeupwidth, the width of the text area.

  • width=middle solves the following equation to set the makeupwidth:
 paperwidth = \backspace + \makeupwidth+ \cutspace
    • backspace is the distance from the inside edge of the paper to the edge of the text area.
    • cutspace is the width from the outside edge of the text area to the edge of the paper. If cutspace is set to 0, it is taken to be equal to the backspace.
  • if width=fit, then the calculation is like for width=middle, but with the following additions:
    • leftmargin/rightmargin => width of leftmargin/rightmargin area
    • margin => width of outer margin
    • leftedge/rightedge => width of leftedge/rightedge area
    • *distance (like leftmargindistance) => space separates * area from the inner
    • horoffset is applied after the various width calculations to shift everything bodily to the outside.


What is needed is a picture of a page with each of these layout parameters indicated. (see Layout)

You can use the \showframe macro to see the results of your layout. Just put the command before the \starttext and lines will be drawn on your document showing the different areas.

Grid Setups

In MkIV, at least, a number of presets for the grid parameter were defined using \definegridsnapping; they can be invoked by e.g. \setuplayout[grid=normal]. The presets are all combinations of the following options:

none don't enlarge
halfline enlarge by halfline/halfline
line enlarge by line/line
strut enlarge by ht/dp (default)
first align to top line
last align to bottom line
mindepth round depth down
maxdepth round depth up
minheight round height down
maxheight round height up
local use local interline space
shift:-3tp vertical shift within box

These are the presets and their definitions.

\definegridsnapping[normal] [maxheight,maxdepth,strut]
\definegridsnapping[standard] [maxheight,maxdepth,strut]
\definegridsnapping[yes] [maxheight,maxdepth,strut]
\definegridsnapping[strict] [\v!maxdepth:0.8,maxheight:0.8,strut]
\definegridsnapping[tolerant] [\v!maxdepth:1.2,maxheight:1.2,strut]
\definegridsnapping[top] [minheight,maxdepth,strut]
\definegridsnapping[bottom] [maxheight,mindepth,strut]
\definegridsnapping[both] [minheight,mindepth,strut]
\definegridsnapping[broad] [maxheight,maxdepth,strut,0.8]
\definegridsnapping[fit] [maxheight,maxdepth,strut,1.2]
\definegridsnapping[first] [first]
\definegridsnapping[last] [last]
\definegridsnapping[high] [minheight,maxdepth,none]
\definegridsnapping[low] [maxheight,mindepth,none]
\definegridsnapping[line] [line]
\definegridsnapping[strut] [strut]
\definegridsnapping[max] [maxdepth,maxheight,strut]
\definegridsnapping[min] [mindepth,minheight,strut]



%% This is an example for showing the effect of the vertical parameters
%% top, topdistance, bottom, bottomdistance and topspace.
%% Just play around with these parameters.


%% Show the top and the bottom with blue color:
\setupbackgrounds[header, footer][background=color, backgroundcolor=blue]


  topspace=\dimexpr(\topheight + \topdistance),

    \input thuan

See also

Help from ConTeXt-Mailinglist/Forum

All issues with: