Changes

Jump to navigation Jump to search
6,355 bytes added ,  14:22, 29 November 2021
no edit summary
</cd:command>
</cd:variants>
<cd:description>Draw a rectangle around, e.g, the right margin area's footer. If no arguments are specified, all text areas are outlined; if one argument is specified, it must specify one or more of the horizontal components; if both arguments are specified, any vertical part(s) of interest can be specified, too.
In every case a green rectangle is drawn around the page edge. To change the color of that rectangle, use e.g. {{cmd|definepalet|2=[layout][page=blue]}}.
If you define a background eg. in a layer and want to preserve its output, you have to put the <tt>\showframe</tt> command before those {{cmd|setupbackgrounds}} commands in your document, because <tt>\showframe</tt> is merely a wrapper around several calls to {{cmd|setupbackgrounds}} so it may alter your layer's background. The table below shows what the horizontal and vertical components of {{cmd|showframe}} highlight. The table's rows and columns ought to be transposed, really - currently the [header] is in the leftmost column, instead of the topmost row - but the table wouldn't fit that way round. The examples all use the same page design:<texcode>\definepapersize[A11][height=26mm, width=18mm]\setuppapersize[A11] \setuplayout[ backspace=6mm, width=6mm, marginleft=2mm, marginright=2mm, leftedge=2mm, rightedge=2mm]</texcode> {| class=wikitable! (one argument) !! [header] !! [text] !! [footer]|-| [leftedge]<context>\definepapersize[A11][height=26mm, width=18mm]\setuplayout[ backspace=6mm, width=6mm, marginleft=2mm, marginright=2mm, leftedge=2mm, rightedge=2mm]\setuppapersize[A11]\showframe[leftedge]\starttext asdf \stoptext</context>| [header][leftedge]<context>\definepapersize[A11][height=26mm, width=18mm]\setuppapersize[A11]\setuplayout[ backspace=6mm, width=6mm, marginleft=2mm, marginright=2mm, leftedge=2mm, rightedge=2mm]\showframe[header][leftedge]\starttext asdf \stoptext</context>| [text][leftedge]<context>\definepapersize[A11][height=26mm, width=18mm]\setuplayout[ backspace=6mm, width=6mm, marginleft=2mm, marginright=2mm, leftedge=2mm, rightedge=2mm]\setuppapersize[A11]\showframe[text][leftedge]\starttext asdf \stoptext</context>| [footer][leftedge]<context>\definepapersize[A11][height=26mm, width=18mm]\setuplayout[ backspace=6mm, width=6mm, marginleft=2mm, marginright=2mm, leftedge=2mm, rightedge=2mm]\setuppapersize[A11]\showframe[footer][leftedge]\starttext asdf \stoptext</context>|-| [leftmargin]<context>\definepapersize[A11][height=26mm, width=18mm]\setuplayout[ backspace=6mm, width=6mm, marginleft=2mm, marginright=2mm, leftedge=2mm, rightedge=2mm]\setuppapersize[A11]\showframe[leftmargin]\starttext asdf \stoptext</context>| [header][leftmargin]<context>\definepapersize[A11][height=26mm, width=18mm]\setuplayout[ backspace=6mm, width=6mm, marginleft=2mm, marginright=2mm, leftedge=2mm, rightedge=2mm]\setuppapersize[A11]\showframe[header][leftmargin]\starttext asdf \stoptext</context>| [text][leftmargin]<context>\definepapersize[A11][height=26mm, width=18mm]\setuplayout[ backspace=6mm, width=6mm, marginleft=2mm, marginright=2mm, leftedge=2mm, rightedge=2mm]\setuppapersize[A11]\showframe[text][leftmargin]\starttext asdf \stoptext</context>| [footer][leftmargin]<context>\definepapersize[A11][height=26mm, width=18mm]\setuplayout[ backspace=6mm, width=6mm, marginleft=2mm, marginright=2mm, leftedge=2mm, rightedge=2mm]\setuppapersize[A11]\showframe[footer][leftmargin]\starttext asdf \stoptext</context>|-| [text]<context>\definepapersize[A11][height=26mm, width=18mm]\setuplayout[ backspace=6mm, width=6mm, marginleft=2mm, marginright=2mm, leftedge=2mm, rightedge=2mm]\setuppapersize[A11]\showframe[text]\starttext asdf \stoptext</context>| [header][text]<context>\definepapersize[A11][height=26mm, width=18mm]\setuplayout[ backspace=6mm, width=6mm, marginleft=2mm, marginright=2mm, leftedge=2mm, rightedge=2mm]\setuppapersize[A11]\showframe[header][text]\starttext asdf \stoptext</context>| [text][text]<context>\definepapersize[A11][height=26mm, width=18mm]\setuplayout[ backspace=6mm, width=6mm, marginleft=2mm, marginright=2mm, leftedge=2mm, rightedge=2mm]\setuppapersize[A11]\showframe[text][text]\starttext asdf \stoptext</context>| [footer][text]<context>\definepapersize[A11][height=26mm, width=18mm]\setuplayout[ backspace=6mm, width=6mm, marginleft=2mm, marginright=2mm, leftedge=2mm, rightedge=2mm]\setuppapersize[A11]\showframe[footer][text]\starttext asdf \stoptext</context>|-| [rightmargin]<context>\definepapersize[A11][height=26mm, width=18mm]\setuplayout[ backspace=6mm, width=6mm, marginleft=2mm, marginright=2mm, leftedge=2mm, rightedge=2mm]\setuppapersize[A11]\showframe[rightmargin]\starttext asdf \stoptext</context>| [header][rightmargin]<context>\definepapersize[A11][height=26mm, width=18mm]\setuplayout[ backspace=6mm, width=6mm, marginleft=2mm, marginright=2mm, leftedge=2mm, rightedge=2mm]\setuppapersize[A11]\showframe[header][rightmargin]\starttext asdf \stoptext</context>| [text][rightmargin]<context>\definepapersize[A11][height=26mm, width=18mm]\setuplayout[ backspace=6mm, width=6mm, marginleft=2mm, marginright=2mm, leftedge=2mm, rightedge=2mm]\setuppapersize[A11]\showframe[text][rightmargin]\starttext asdf \stoptext</context>| [footer][rightmargin]<context>\definepapersize[A11][height=26mm, width=18mm]\setuplayout[ backspace=6mm, width=6mm, marginleft=2mm, marginright=2mm, leftedge=2mm, rightedge=2mm]\setuppapersize[A11]\showframe[footer][rightmargin]\starttext asdf \stoptext</context>|-| [rightedge]<context>\definepapersize[A11][height=26mm, width=18mm]\setuplayout[ backspace=6mm, width=6mm, marginleft=2mm, marginright=2mm, leftedge=2mm, rightedge=2mm]\setuppapersize[A11]\showframe[rightedge]\starttext asdf \stoptext</context>| [header][rightedge]<context>\definepapersize[A11][height=26mm, width=18mm]\setuplayout[ backspace=6mm, width=6mm, marginleft=2mm, marginright=2mm, leftedge=2mm, rightedge=2mm]\setuppapersize[A11]\showframe[header][rightedge]\starttext asdf \stoptext</context>| [text][rightedge]<context>\definepapersize[A11][height=26mm, width=18mm]\setuppapersize[A11]\setuplayout[ backspace=6mm, width=6mm, marginleft=2mm, marginright=2mm, leftedge=2mm, rightedge=2mm]\showframe[text][rightedge]\starttext asdf \stoptext</context>| [footer][rightedge]<context>\definepapersize[A11][height=26mm, width=18mm]\setuppapersize[A11]\setuplayout[ backspace=6mm, width=6mm, marginleft=2mm, marginright=2mm, leftedge=2mm, rightedge=2mm]\showframe[footer][rightedge]\starttext asdf \stoptext</context>|-|}</cd:description>
<cd:examples><cd:example title="Framing all areas"><context source="yes">
\definepapersize[A11][height=26mm, width=18mm]
% paperwidth - width - backspace
% = 6mm outer space
top=2mm, bottom=2mm,
backspace=6mm, width=6mm,
marginleft=2mm, marginright=2mm,
leftedge=2mm, rightedge=2mm]
\showframe
% = 6mm outer space
backspace=6mm, width=6mm,
marginleft=2mm, marginright=2mm,
leftedge=2mm, rightedge=2mm]
\showframe[]
\stoptext
</context>
</cd:example><cd:example title="Framing part of the page"><context source="yes">\definepapersize[A11][height=26mm, width=18mm]\setuppapersize[A11]\setuplayout[ backspace=6mm, width=6mm, marginleft=2mm, marginright=2mm, leftedge=2mm, rightedge=2mm]\showframe[header, footer][leftmargin, rightmargin]\starttextasdf\stoptext</context></cd:example></cd:examples>
<cd:notes></cd:notes>
<cd:seealso>

Navigation menu