Changes

Jump to navigation Jump to search
m
→‎Description: another typo
<!-- please remove this and the following line if you have checked this page -->
{{Reference_Cleanup}}
{{Reference
|name=setupbackgrounds
}}
== [[Help:Reference|Syntax]] (autogenerated) ==
<syntax>setupbackgrounds</syntax>
== [[Help:Reference|Syntax]] ==
<table cellspacing="4" cellpadding="2" class="cmd">
</tr>
<tr valign="top" class="third">
<td class="cmd">[[Reference/enCommand/keyword:state|state]]</td> <td>[[Reference/enCommand/value:start|start]] [[Reference/enCommand/value:stop|stop]] [[Reference/enCommand/value:repeat|repeat]] </td>
</tr>
<tr valign="top" class="third">
<td class="cmd">[...,...=...,...]</td>
<td>see [[Reference/enCommand/setupframed|\setupframed]] </td>
</tr>
</table>
== Description ==
{{cmd|setupbackgrounds}} is used to draw frames or backgrounds that cover specific areas of the page, under the text layer.
== Description == == comment ==The first parameter sets the main layout area; the optional second one specifies the linked subarea(s) of the prior. Not all main areas have such subareas.
The first parameter sets Because {{cmd|showframe}} and {{cmd|setupbackgrounds}} both draw frameboxes over parts of the main layout areapage, the second one specifies the linked subarea(s) of the priororder in which they are invoked matters. Not all main areas have such subareasIn most cases, {{cmd|setupbackgrounds}} should come last.
Backgrounds are essential for working with [[Layers]]. You enable your defined layers like <code>\setupbackgrounds[page][background=mylayer]</code>.
The <tt>background</tt> key also takes a list, and if you include "foreground", you can also set something on top of your general content, e.g. <code>\setupbackgrounds[page][background={mybacklayer,foreground,mytoplayer}]</code>.
== Example ==
 
<context source=yes>
\setuppapersize[A10]
\showframe
== Example ==% \setupbackgrounds should be placed *after* \showframe,
'''[text]''' has several linked subareas.<pre class="example">\setupbackgrounds[textfooter] [background=color,backgroundcolor=lightgrayblue]\setupbackgrounds[textfooter] [leftmargin] [background=color,backgroundcolor=red]</pre>
sets a light gray \setupbackgrounds[text] [background for the =color, backgroundcolor=lightgray]\setupbackgrounds[text area and a red ] [rightmargin] [background for the left margin area.=color, backgroundcolor=yellow]
I paint modern
</context>
== See also ==
<!-- something like * [[Layers]]* {{cmd:goto|setupframed}}, which is the mechanism used by \goto]] setupbackgrounds. == Help from ConTeXt-->Mailinglist/Forum ==All issues with:{{Forum|{{SUBPAGENAME}}}}
[[Category:ReferenceCommand/enBackgrounds|setupbackgrounds]]

Navigation menu