Changes

< [[Visuals]] | [[Layers]] | [[Columns]] | [[Visual Debugging]] | [[Paper sizes]] >

You can use these design == Typesetting areas in your page:==

<table> <tr style="background:#ccccff;"> <td style="background:#ffffff;"></td> <td style="text-align:center;">The 25 typesetting areas of a ConTeXt page are divided into 5 columns and 5 rows. From left to right, one encounters {{code|leftedge </td> <td style="text-align:center;width:15%;">}}, {{code|leftmargin </td> <td style="}}, {{code|text-align:center;width:50%;">text </td> <td style="text-align:center;width:15%;">}}, {{code|rightmargin </td> <td style="text-align:center;">}}, and {{code|rightedge </td> </tr> <tr style="background}}. From top to bottom, the areas are called:#cccccc;"> <td style="background:#ccccff;"> {{code|top </td> <td style="text-align:center;">. </td> <td style="text-align:center;">. </td> <td style="text-align:center;">&uarr; topspace &darr;</td> <td style="text-align:center;">. </td> <td style="text-align:center;">. </td> </tr> <tr style="background:#cccccc;"> <td style="background:#ccccff;"> }}, {{code|header </td> <td style="}}, {{code|text-align:center;">}}, {{code|footer}}, {{code|bottom}}. </td> <td style="text-align:center;">E. </td> <td style="text-align:center;background:#DDDDDD;">HEADER<br />&uarr; headerheight &darr;</td> <td style="text-align:center;">g. </td> <td style="{{code|leftmargin}} is the margin area to the left of the main text-align:center;">. </td> </tr> <tr style="background:#cccccc;"> <td style="background:#ccccff;"> text </td> <td style="text-align:center;">&larr;leftedgewidth&rarr;</td> <td style="text-align:center;background:#DDDDDD;">MARGINALS<br />&larr;leftmarginwidth&rarr;</td> <td style="text-align:centerarea;{{code|{leftmargin,bottom}|}} is below it, at the same height:20em;background:#EEEEEE;">TEXT<br />&larr;textwidth&rarr;<br />&times;<br />&uarr; textheight &darr;</td> <td style="text-align:center;background:#DDDDDD;">MARGINALS<br />&larr;rightmarginwidth&rarr;</td> <td style="text-align:center;">&larr;rightedgewidth&rarr;</td> </tr> <tr style="background:#cccccc;"> <td style="background:#ccccff;"> footer </td> <td style="text-align:center;">. </td> <td style="text-align:center;">. </td> <td style="text-align:center;background:#DDDDDD;">FOOTER<br />&uarr; footerheight &darr;</td> <td style="text-align:center;">. </td> <td style="text-align:center;">. </td> </tr> <tr style="background:#cccccc;"> <td style="background:#ccccff;"> as the {{code|bottom </td> <td style="text-align:center;">}} area. </td> <td style="text-align:center;">. </td> <td style="text-align:center;">&uarr; bottomspace &darr;</td> <td style="text-align:center;">. </td> <td style="text-align:center;">In between the two lies the area {{code|{leftmargin,footer}|}}. </td> </tr></table>

There's also a "distance" between each of The graphic below illustrates the areas, eand dimensions.gThe row and column names are writtenalong the edges of the page. <tt>leftedgedistance</tt>, <tt>leftmargindistance</tt> The arrows correspond to layout dimensions; themore important a dimension is (from i.e. the named area to more of the innerlayout is pushed aroundwhen you change it), the thicker its arrow and the larger its name.

[[Image:layout.svg||||Diagram of \setuplayout[] dimensions]] == Defining the layout == Positioning the areas is by setting the following dimensions using {{cmd|setuplayout|[backspace=5cm,...]}}. The dimensions are mentioned in order of how ‘primitive’ they are: e.g. altering the {{code|topspace}} pushes around all other vertical dimensions, but altering the {{code|header}} affects only the {{code|headerdistance}} and the {{code|textheight}}. You always define a right page; if you use a double page layout, 'right' and 'left' values are mirrored on a left page. Doublesided typesetting is activated with {{cmd|setuppagenumbering|[alternative= Table doublesided]}}. # Set the {{code|backspace}} and {{code|width}}, and the {{code|topspace}} and {{code|height}}. The {{code|width}} is the width of the main typesetting area; the {{code|backspace}} is its distance from the left edge of the page. The {{code|height}} is the distance ''from the top of the header to the bottom of the footer''; the {{code|topspace}} is the distance from the top edge of the page to the top of the header.# Set the {{code|header}} and {{code|headerdistance}}, and the {{code|footer}} and {{code|footerdistance}}. The {{code|header}} is the vertical size of the header area; the {{code|headerdistance}} is the distance from the header area to the text area. The {{code|footer}} and {{code|footerdistance}} work likewise.# Once the header(distance) and footer(distance) are subtracted from the {{code|height}}, what remains is the {{code|textheight}}: the height of the main typesetting area. Although it would be very useful, you cannot set this dimension directly.# If you want to typeset anything above the header, define {{code|topdistance}} (the distance from the top of the header to the bottom of the topmost typesetting area) and {{code|top}} (the height of Parameters the topmost typesetting area). For typesetting below the footer, define {{code|bottomdistance}} and {{code|bottom}}.# As for the horizontal dimensions apart from the {{code|width}}: starting at the left edge of the main text area, and moving away from the center, one first sets the {{code|leftmargindistance}}; then one sets the width {{code|leftmargin}} of the margin typesetting area; then one sets the {{code|leftedgedistance}}; and then there is the {{code|leftedge}} typesetting area. On the right: {{code|rightmargindistance}}, {{code|rightmargin}}, {{code|rightedgedistance}}, {{code|rightedge}}. == Paper size ==

<table><tr style="background:#cccccc;vertical-align=top;"><th>Parameter</th><th>Variable</th><th>Remarks</th></tr><tr> <td>paperheight</td> <td><Page size and paper size are set with {{cmd>paperheight</cmd></td> <td>height of |setuppapersize}}. Many paper page</td></tr><tr> <td>paperwidth</td> <td><cmd>paperwidth</cmd></td> <td>width sizes are already defined by name; see the list of paper page</td></tr><tr> <td>printpaperheight</td> <td><cmd>printpaperheight</cmd></td> <td>differs from paperheight when using [[Imposition]] (arranging)</td></tr><tr> <td>printpaperwidth</td> <td><cmd>printpaperwidth</cmd></td> <td>differs from paperwidth when using [[ImpositionPaperSizes|paper sizes]] (arranging)</td></tr><tr> <td>topspace</td> <td><cmd>topspace</cmd></td> <td>above header: from top rim of . To define a new paper to to top rim of header</td></tr><tr> <td>backspace</td> <td><cmd>backspace</cmd></td> <td>from left rim of paper to left rim of text area</td></tr><tr> <td>height</td> <td><cmd>makeupheight</cmd></td> <td>sum of heights of text areasize, header and footer (plus distances)</td></tr><tr> <td>width</td> <td><cmd>makeupwidth</use {{cmd></td> <td>normally same as textwidth</td></tr><tr> <td>top</td> <td><cmd>topheight</cmd></td> <td>??</td></tr><tr> <td>topdistance</td> <td><cmd>topdistance</cmd></td> <td>?? between topspace and header ??</td></tr><tr> <td>header</td> <td><cmd>headerheight</cmd></td> <td>height of header area</td></tr><tr> <td>headerdistance</td> <td><cmd>headerdistance</cmd></td> <td>between header and text</td></tr><tr> <td>textheight</td> <td><cmd>textheight</cmd></td> <td>height of text area</td></tr><tr> <td>footerdistance</td> <td><cmd>footerdistance</cmd></td> <td>between text and footer</td></tr><tr> <td>footer</td> <td><cmd>footerheight</cmd></td> <td>height of footer area</td></tr><tr> <td>bottomdistance</td> <td><cmd>bottomdistance</cmd></td> <td>?? between footer and bottom ??</td></tr><tr> <td>bottom</td> <td><cmd>bottomheight</cmd></td> <td>space below footer (but isn't calculated automatically)</td></tr><tr> <td>bottomspace</td> <td><cmd>bottomspace</cmd></td> <td>space from bottom footer to bottom rim of paper</td></tr><tr> <td>leftedge</td> <td><cmd>leftedgewidth</cmd></td> <td>from left rim of paper to left rim of left margin</td></tr><tr> <td>leftedgedistance</td> <td><cmd>leftedgedistance</cmd></td> <td>?? between leftegde and left margin ??</td></tr><tr> <td>leftmargin</td> <td><cmd>leftmarginwidth</cmd></td> <td>width of left margin (marginals space)</td></tr><tr> <td>leftmargindistance</td> <td><cmd>leftmargindistance</cmd></td> <td>between left margin and text</td></tr><tr> <td>textwidth</td> <td><cmd>textwidth</cmd></td> <td>width of text area</td></tr><tr> <td>rightmargindistance</td> <td><cmd>rightmargindistance</cmd></td> <td>between text area and right margin</td></tr><tr> <td>rightmargin</td> <td><cmd>rightmarginwidth</cmd></td> <td>width of right margin (marginals area)</td></tr><tr> <td>rightedgedistance</td> <td><cmd>rightedgedistance</cmd></td> <td>?? between right margin and right edge ??</td></tr><tr> <td>rightedge</td> <td><cmd>rightedgewidth</cmd></td> <td>from right margin to right rim of paper</td></tr></table>|definepapersize}}.

You define always a right page; if you use a double page == Example layout 'right' and 'left' values are mirrored on a left page.==

\setuppapersize[A4][A4] % this is the default and may be omitted

width=160mm, topspace=20mm, top=0mm, header=0mm, footer=0mm, height=250mm]</texcode> == Multiple layouts == If you need to use different layouts in some parts of the document, you can set up a global layout, and then define additional named layouts for the deviating parts. You only need to specify the dimensions that differ: unspecified dimensions will be inherited from the global layout. To switch to a different layout, call it up in the appropriate place in the document. To revert back to the global layout, use {{cmd|setuplayout|[reset]}}. <texcode>\setuplayout[...] % global layout\definelayout[wide][...] % layout of the first page \setuplayout[wide] % switch to layout called 'wide'\setuplayout[reset] % switch back to the global layout</texcode> To specify in advance that you want to change layouts starting from page 4 (e.g.), use {{cmd|definelayout|[4][...]}}. Resetting the layout must be done explicitly; else, the new layout will be used until the end of the document. <texcode>% different layout for first two pages\definelayout[1][wide]\definelayout[3][reset]</texcode> For the page numbers you can use absolute numbers (as above), relative numbers (like +1, -2) or the keywords odd, even, first and last. <texcode>\setuplayout[ % default layout (right page)...]\definelayout[even][ % different layout on left pages...]

You can make all If you define additional layouts in a doublepage (duplex) setup, remember to think mirrored: leftmargin defines the geometry information visible with right margin, backspace is the distance from the spine to the right edge of the text area etc. .<div style="border: 3px solid red; background: #ffcccc; padding: 0.4em;"><cmddiv style="font-size: 1.3em; fontweight: bold">showlayoutWarning!</cmddiv> At the moment a layoutchange (setuplayout) inside a page is not proper working in mkiv duplex mode.For more details and actual state see mailing list and the [[Visual Debugging|related commands]http://wiki.contextgarden.net/User_talk:Zenlima Bug Layoutchange inside page while duplexmode].</div>

See == Advanced features == * To allow Acrobat Reader users (among others?) to make layers visible/invisible at will, add the following command at the start of your file:<cmdtexcode>setuplayout\showlayoutcomponents</cmdtexcode> and < * If you have a certain run of text that you want to keep together, you can test for the number of lines available on the current page with {{cmd>setuppapersize</|testpage|[''n'']}}, where ''n'' is the number of lines required. If there are not ''n'' lines available, a page break will be inserted at the location of the {{cmd> in |testpage}} command. * If you need absolute positioning of objects (text, pictures) on the page, but ad-hoc rather than systematic, the manual[[Layers]] mechanism is more suitable. * For layout from a [[Formatting Objects|XML/FO]] perspective, with some descriptive pictures, see At [http://getfo.sourceforge.net/context_xml/index.html Paul Tremblay's] [[XML]] ConTeXt site. == Table of Parameters ==

If The first colum is the name by which the variable is set in {{cmd|setuplayout}}. The second column is the name by which TeX stores the variable. This name is usually the same, but sometimes different; knowing it allows you need an unusual paper size, use to invoke it with code like <cmdcode>definepapersizeThe paper's height is \the\paperheight.</cmdcode> and have Any remarks (usually a look at our list of [[PaperSizes|paper sizes]]short description) are given in the third column.

{| class== Keep ==wikitable! \setuplayout[...] !! dimension !! Remarks|-| paperheight| {{cmd|paperheight}}| height of paper page|-| paperwidth| {{cmd|paperwidth}}| width of paper page|-| printpaperheight| {{cmd|printpaperheight}}| differs from paperheight when using [[Imposition]] (arranging)|-| printpaperwidth| {{cmd|printpaperwidth}}| differs from paperwidth when using [[Imposition]] (arranging)|-| topspace| {{cmd|topspace}}| above header: from top rim of paper to to top rim of header|-| backspace| {{cmd|backspace}}| from left rim of paper to left rim of main text area|-| height| {{cmd|makeupheight}}| sum of heights of text area, header and footer (plus distances)|-| width| {{cmd|makeupwidth}}If you have a certain run | width of the main text that you want to keep togetherarea. {{cmd|makeupwidth}} is normally same as {{cmd|textwidth}}, you but it can test be different, for example in columns|-| top| {{cmd|topheight}}| height of the number top area|-| topdistance| {{cmd|topdistance}}| between top and header|-| header| {{cmd|headerheight}}| height of header area|-| headerdistance| {{cmd|headerdistance}}| between header and text|-| textheight| {{cmd|textheight}}| height of text area|-| footerdistance| {{cmd|footerdistance}}| between text and footer|-| footer| {{cmd|footerheight}}| height of lines available on the current page with \testpage[n] where n is the number footer area|-| bottomdistance| {{cmd|bottomdistance}}| between footer and bottom|-| bottom| {{cmd|bottomheight}}| space below footer (but isn't calculated automatically)|-| bottomspace| {{cmd|bottomspace}}| space from bottom footer to bottom rim of paper|-| cutspace| {{cmd|cutspace}}| from right rim of paper to right rim of main text area|-| leftedge| {{cmd|leftedgewidth}}| from left rim of paper to left rim of left margin|-| leftedgedistance| {{cmd|leftedgedistance}}| between leftegde and left margin|-| leftmargin| {{cmd|leftmarginwidth}}| width of left margin (marginals space)|-| leftmargindistance| {{cmd|leftmargindistance}}| between left margin and text|-| textwidth| {{cmd|textwidth}}| width of lines requiredtext area. If there when columns are not n lines availableused, a page break will be inserted at the location value of the testpage command.{{cmd|textwidth}} can differ from {{cmd|makeupwidth}}|-| rightmargindistance| {{cmd|rightmargindistance}}| between text area and right margin|-| rightmargin| {{cmd|rightmarginwidth}}| width of right margin (marginals area)|-| rightedgedistance| {{cmd|rightedgedistance}}| between right margin and right edge|-| rightedge| {{cmd|rightedgewidth}}| from right margin to right rim of paper|-| horoffset| ?| bleed from left of paper|-| voroffset| ?| bleed from top of paper|}

By using [[Layers]]*width=middle<code> if cutspace == 0pt then cutspace = backspace end makeupwidth = paperwidth- backspace -cutspace</code>*width=fit<code> if cutspace == 0pt then cutspace = backspace end makeupwidth = paperwidth-cutspace scratchdimen = backspace - leftedgewidth-leftedgedistance-leftmarginwidth-leftmargindistance if scratchdimen< 0pt then scratchdimen = 0pt end makeupwidth = makeupwidth - rightmargindistance-rightmarginwidth- rightedgedistance-rightedgewidth- scratchdimen</code>* otherwise:<code> makeupwidth=width if cutspace == 0pt then cutspace = paperwidth-makeupwidth-backspace else % A kind of inconsistent specification, you can also place elements at specific places, as done but used % in for instance s-pre-19.tex; the [[BusinessCard]] examplecutspace is % used only for determining some kind of right % margin; don't use this in doublesided mode pass end</code>(From {{src|page-lay.mkiv}}.)