139
edits
Changes
Jump to navigation
Jump to search
< [[Visuals]] | [[Layers]] | [[Columns]] | [[Visual Debugging]] >__TOC__
There is now a [http://context.aanhet.net/svn/contextman/context-reference/en/co-pagedesign.pdf manual chapter This page focuses on '''Basics of page designand layout'''. It will allow you to continue on [[#Further reading|further topics]!] like [[Presentations|Presentations layout]], [[Visual_Debugging|Visual debugging]], [[Floating Objects]], [[Columns]], [[Layers]], [[Grid typesetting]], [[PDF Boxes]]. But first, one needs to understand the basics of page layout by ConTeXt.
You can use these design The 25 typesetting areas in your of a ConTeXt pageare divided into 5 columns and 5 rows. From left to right, one encounters {{code|leftedge}}, {{code|leftmargin}}, {{code|text}}, {{code|rightmargin}}, and {{code|rightedge}}. From top to bottom, the areas are called:{{code|top}}, {{code|header}}, {{code|text}}, {{code|footer}}, {{code|bottom}}. E.g. {{code|leftmargin}} is the margin area to the left of the main text area; {{code|{leftmargin,bottom}|}} is below it, at the same height as the {{code|bottom}} area. In between the two lies the area {{code|{leftmargin,footer}|}}.
<table> <tr style="background:#ccccff;"> <td style="background:#ffffff;"></td> <td style="text-align:center;"><tt>leftedge</tt> </td> <td style="text-align:center;width:15%;"><tt>leftmargin</tt> </td> <td style="text-align:center;width:50%;"><tt>width</tt> </td> <td style="text-align:center;width:15%;"><tt>rightmargin</tt> </td> <td style="text-align:center;">rightedge </td> </tr> <tr style="background:#cccccc;"> <td style="background:#ccccff;"><tt>top</tt></td> <td style="text-align:center;">. </td> <td style="text-align:center;">. </td> <td style="text-align:center;">↑ topspace ↓</td> <td style="text-align:center;">. </td> <td style="text-align:center;">. </td> </tr> <tr style="background:#cccccc;"> <td style="background:#ccccff;"><tt>header</tt></td> <td style="text-align:center;">. </td> <td style="text-align:center;">. </td> <td style="text-align:center;background:#DDDDDD;">HEADER<br />↑ headerheight ↓</td> <td style="text-align:center;">. </td> <td style="text-align:center;">. </td> </tr> <tr style="background:#cccccc;"> <td style="background:#ccccff;"><tt>textheight</tt></td> <td style="text-align:center;">←leftedgewidth→</td> <td style="text-align:center;background:#DDDDDD;">MARGINALS<br />←leftmarginwidth→</td> <td style="text-align:center;height:20em;background:#EEEEEE;">TEXT<br />←textwidth→<br />×<br />↑ textheight ↓</td> <td style="text-align:center;background:#DDDDDD;">MARGINALS<br />←rightmarginwidth→</td> <td style="text-align:center;">←rightedgewidth→</td> </tr> <tr style="background:#cccccc;"> <td style="background:#ccccff;"><tt>footer</tt></td> <td style="text-align:center;">. </td> <td style="text-align:center;">. </td> <td style="text-align:center;background:#DDDDDD;">FOOTER<br />↑ footerheight ↓</td> <td style="text-align:center;">The graphic below illustrates the areas and dimensions. </td>The row and column names are written <td style="text-align:center;">along the edges of the page. </td> </tr> <tr style="background:#cccccc;"> <td style="background:#ccccff;"><tt>bottom</tt></td> <td style="text-align:centerThe arrows correspond to layout dimensions;">. </td>the <td style="text-align:center;">more important a dimension is (i. </td> <td style="text-align:center;">↑ bottomspace ↓</td> <td style="text-align:center;">e. </td>the more of the layout is pushed around <td style="text-align:center;">when you change it), the thicker its arrow and the larger its name. </td> </tr></table>
The names in = Defining the column and row headers are the keywords for <cmd>setuplayout</cmd>, the words inside of the table are given to clarify ConTeXT terminology. There are also keywords suffixed by "distance" to set the distancebetween each of the areas, e.g. <tt>leftedgedistance</tt>, <tt>leftmargindistance</tt> (from the named area to the inner). layout =
<tt>height</tt> Positioning the areas is normally used instead by setting the following dimensions using {{cmd|setuplayout|2=[backspace=5cm,...]}}. The dimensions are mentioned in order of <tt>textheight</tt>how ‘primitive’ they are: e.g. altering the {{code|topspace}} pushes around all other vertical dimensions, it is but altering the {{code|header}} affects only the {{code|headerdistance}} and the sum of <tt>footer + footerdistance + {{code|textheight + headerdistance + header</tt>}}.
The size of the margins does not affect the size of the text area. Control the size of the text area with backspaceWhen you define a page layout, topspaceit's always a right page that you're defining; if you use a double page layout, height 'right' and width'left' values are mirrored on a left page. Doublesided typesetting is activated with {{cmd|setuppagenumbering|2=[alternative=doublesided]}}.
== Table # Set the {{code|backspace}} and {{code|width}}, and the {{code|topspace}} and {{code|height}}. The {{code|width}} is the width of Parameters ==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 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}}.
<table><tr style="background:#cccccc;vertical-alignPaper size =top;"><th>Parameter</th><th>Variable</th><th>Remarks</th></tr><tr> <td>paperheight</td> <td><cmd>paperheight</cmd></td> <td>height of paper page</td></tr><tr> <td>paperwidth</td> <td><cmd>paperwidth</cmd></td> <td>width 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 [[Imposition]] (arranging)</td></tr><tr> <td>topspace</td> <td><cmd>topspace</cmd></td> <td>above header: from top rim of 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 main text area</td></tr><tr> <td>height</td> <td><cmd>makeupheight</cmd></td> <td>sum of heights of text area, header and footer (plus distances)</td></tr><tr> <td>width</td> <td><cmd>makeupwidth</cmd></td> <td>width of the main text area. <cmd>makeupwidth</cmd> is normally same as <cmd>textwidth</cmd>, but it can be different, for example in columns</td></tr><tr> <td>top</td> <td><cmd>topheight</cmd></td> <td>height of the top area</td></tr><tr> <td>topdistance</td> <td><cmd>topdistance</cmd></td> <td>between top 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>cutspace</td> <td><cmd>cutspace</cmd></td> <td>from right rim of paper to right rim of main text area</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. when columns are used, the value of <cmd>textwidth</cmd> can differ from <cmd>makeupwidth</cmd></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>'''Note:''' *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, but used % in for instance s-pre-19.tex; the cutspace is % used only for determining some kind of right % margin; don't use this in doublesided mode pass end</code>(from <tt>page-lay.mkiv</tt>, 2009-11-17 - 23:59).
== Setup / See the dedicated page [[PaperSetup|Paper Size ==setup]], it includes details on:* {{cmd|setuppapersize}}, to set the page size and paper size* {{cmd|definepapersize}}, to define a new paper size,* the [[PaperSetup#Predefined_Paper_Sizes|many paper sizes already defined by name]]. Their actual dimensions in mm are given by [[Paper sizes]] page.* [[PaperSetup#Changing paper setup mid-document|Changing paper setup mid-document]]* [[PaperSetup#Setting print size|Setting print size]]* [[PaperSetup#Fitting pages to their content|Fitting pages to their content]]
You define always a right page; if you use a double page = Example layout 'right' and 'left' values are mirrored on a left page.=
width=160mm, topspace=20mm, top=0mm, header=0mm, footer=0mm, height=250mm]
ConTeXt users in the United States might use<texcode>\setuppapersize[letter][letter]</texcode>for standard US Letter-sized paper (8.5" × 11.0")== Let's gather examples here ==
If you need a special paper size; Cover pages: [[Cover Pages]] (2013, have a look at our list of 2019); Other: [[PaperSizes|paper sizesExample photo page layout]] (ConTeXt's, standardized and traditional2010), and use <cmd>definepapersize</cmd> if it's not already defined.
You can make all the geometry information visible with <cmd>showlayout</cmd> and the = [[Visual Debugging|related commandsImposition]].=
See <cmd>setuplayout<Imposition is a prepress printing process. It consists of the arrangement of the printed product’s pages on the printer’s sheet, in order to obtain faster printing, simplify binding and reduce paper waste ([https://cmd> and <cmd>setuppapersize<en.wikipedia.org/wiki/cmd> in the manualImposition wikipedia]).
=== How We built a dedicated page about '''[[Imposition]]''', because making booklets, to setup your layout ===arrange pages in proper order for printing it's a topic in itself. This is where you will use {{cmd|setuppaper}} and {{cmd|setuparranging}}.
Define the placement and size of your type area by first defining '''backspace''', '''topspace''', '''width''' and '''height'''.The height includes header and footer.= Multiple layouts =
The width If you need to use different layouts in some parts of the margins has ''no'' influence on document, you can set up a global layout, and then define additional named layouts for the location of deviating parts. You only need to specify the dimensions that differ: unspecified dimensions will be inherited from the type area!global layout.
Details are 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|2=[http://context.aanhet.net/svn/contextman/context-reference/en/co-pagedesign.pdf page design chapterreset] of the new reference manual}}.
== Keep ==<texcode>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 \testpagesetuplayout[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 testpage command. == Multiple layouts == If you need to use different layouts in some parts of the document, you can set up a .] % global layout for the overall and then define additional named layouts for the deviating parts\definelayout[wide][... These settings go into ] % layout of the setup area of your document.first page
<texcode>\setuplayout[key=value,key=value,...] %global layout\definelayout[wide][key=value,key=value,...] %different switch to layout called 'wide'\definelayout[short]setuplayout[key=value,key=value,...reset]%different switch back to the global layout called 'short'
That takes care of the global layout. When To specify in advance that you want to switch to a different change layouts starting from page 4 (e.g.), use {{cmd|definelayout|2=[4][...]}}. Resetting the layoutmust be done explicitly; else, you just call it up in the appropriate place in new layout will be used until the end of the document:.
'''NoteFor the page numbers you can use absolute numbers (as above), relative numbers (like +1, -2) or the keywords odd, even, first and last.''' Use reset to revert back to the global layout:
''This text is based on [httpIf you define additional layouts in a doublepage (duplex) setup, remember to think mirrored://archive.contextgarden.net/message/20080926.111520.9db86904.en.html a thread on leftmargin defines the mailing list]right margin, answers and examples are given there by Hans and Wolfgang.'' Defining layouts with a number as their name allows backspace is the distance from the spine to specify the layout right edge of the page with that specific numbertext area etc. For example, to use a different layout for the first page, you can use this code:
Do not forget to reset the layout on the second page. Note Maybe using {{cmd|startlayout}}…{{cmd|stoplayout}} fixes that keys that are not set in the layout of the first page will be conveniently inherited from the global layoutissue.
A typical example = Table of the above is the following:<texcode>\setuplayout[% default layout for all the pages backspace=1cm, widthParameters =middle]
\definelayout[5][backspace=6cm] % use this layout starting from page 5'''Note:'''
\definelayout[9][reset] % reset to the default layout starting from * width=middle<texcode> if cutspace == 0pt then cutspace = backspace end makeupwidth = page 9paperwidth- backspace -cutspace</texcode>
\starttext* width=fit\showframe<texcode> \dorecurse{20}{\input dawkins \blank[big] \input knuth \page} if cutspace == 0pt then\stoptext 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
== Layout components == A hidden nice feature is * otherwise:
\showlayoutcomponents makeupwidth=width if cutspace == 0pt then cutspace = paperwidth-makeupwidth-backspace else % A kind of inconsistent specification, but used % in for instance s-pre-19.tex; the cutspace is % used only for determining some kind of right % margin; don't use this in doublesided mode pass end
By adding the above command at the beginning of your file you obtain a PDF file in which different components of the layout (such as layers) can be made visible or invisible in Acrobat Reader (or maybe a few other PDF viewers).= Further reading =
== Hints ==
By using * '''[[Presentations]]''': specifics requirements, specific pages (widgets, multimedia, ...)* [[Documentation|Manuals about layout]], and noticeably:** The basics with '''[http://context.aanhet.net/svn/contextman/context-reference/en/co-pagedesign.pdf Page design & Layout chapter]''' from the reference manual (2011)** The more advance '''[http://www.pragma-ade.nl/general/manuals/details.pdf It's in the Details]''' manual (2015), including grid typesetting.* '''[[Visual Debugging#Layout|Visual Debugging]]''': can greatly facilitate the set up of your layout.* After the layout, we can usually focus on the following subjects:** '''[[Floating Objects]]'''** '''[[Columns]]'''** '''[[Layers]]''', for absolute positioning of objects on the page, background, foreground etc.)** '''[[Grid typesetting]]''' (working with fixed distances)** '''[[Delimiter]]''', master line break and page break** '''[[Hiding Content]]'''* About PDF format** [[PDF Boxes]]: the size of PDF pages can have different meanings – e.g. the visible page, the printed page, the cropped printed page. ConTeXt can define the set of boxes defined by the PDF standard** [[PDF Print Options]]** [[Viewer Layers]] PDF has a concept of layers that you can also place elements enable and disable (at specific placesleast in a few viewers). This has nothing to do with ConTeXt’s [[Layers]].** [[PDF/A]], ConTeXt can create PDF/A compliant outputs** [[PDFX]], ConTeXt can create PDF/X compliant outputs, as done in the ISO standard.* 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] [[BusinessCardXML]] exampleConTeXt site.
At [http://getfo.sourceforge.net/context_xml/index.html Paul Tremblay's] [[XML]] ConTeXt site, there's a lot about layout from a [[Formatting Objects|XML/FO]] perspective with some descriptive pictures.
{{Todo|Unfortunately it's not that easy to define a layout. We need more documentation about which parameters define which length, what influences what else etc.}}[[Category:Layout]]
corrections
== Location of Areas =Typesetting areas =
[[Image:layout.svg||||Diagram of \setuplayout[] dimensions]]
<texcode>
\setuppapersize[A4][A4] % this is the default and may be omitted
\setuplayout[backspace=20mm,
</texcode>
</texcode>
<texcode>
% different layout for first two pages\setuplayoutdefinelayout[1][wide] % switches to layout called 'wide'\definelayout[3][reset]
</texcode>
<texcode>
\setuplayout[reset% default layout (right page)...]\definelayout[even] [ % reverts to the global different layouton left pages...]
</texcode>
.<texcodediv style="border: 3px solid red; background: #ffcccc; padding: 0.4em;">\setuplayout[key<div style=value,key=value,"font-size: 1.3em; fontweight: bold">Warning!</div>At the moment a layout change ({{cmd|setuplayout}}) inside a page is not proper working in mkiv duplex mode..] % global layout\definelayoutFor more details and actual state see mailing list and [1][key=value,key=value,http://wiki.contextgarden..] % layout of the first net/User_talk:Zenlima Bug Layout change inside page\definelayout[2while duplexmode][reset] % revert to the global layout starting from the second page.</texcodediv>
The first column 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 to invoke it with code like <code>The paper's height is \definelayout[1][% set this layout on the first page backspace=6cm]\paperheight.</code> Any remarks (usually a short description) are given in the third column.
{| class=wikitable! \definelayoutsetuplayout[2...]!! dimension !! Remarks|-| paperheight| {{cmd|paperheight}}| height of paper page|-| paperwidth| {{cmd|paperwidth}}| width of paper page|-| printpaperheight| {{cmd|printpaperheight}}| differs from paperheight when using [reset[Imposition] % reset ] (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}}| width of the main text area. {{cmd|makeupwidth}} is normally same as {{cmd|textwidth}}, but it can be different, for example in columns|-| top| {{cmd|topheight}}| height of the default layout starting 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 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 text area. when columns are used, the second pagevalue of {{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|}
</texcode>
<texcode>
</texcode>
(From {{src|page-lay.mkiv}}.)
