Changes

Jump to navigation Jump to search
m
→‎Description: another typo
}}
== [[Help:Reference|Syntax]] (autogenerated) ==
<syntax>setupbackgrounds</syntax>
== [[Help:Reference|Syntax]] ==
<table cellspacing="4" cellpadding="2" class="cmd">
</table>
== Description ==
{{cmd|setupbackgrounds}} is used to draw frames or backgrounds that cover specific areas of the page, under the text layer.
== Description == 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.
Because {{cmd|showframe}} and {{cmd|setupbackgrounds}} both draw frameboxes over parts of the page, the order in which they are invoked matters. In most cases, {{cmd|setupbackgrounds}} should come last.
Backgrounds are essential for working with [[Layers]]. You enable your defined layers like <code>\setupbackgrounds[page][background== Comment ==mylayer]</code>.
The first parameter sets the main layout area<tt>background</tt> key also takes a list, the second one specifies the linked subarea(s) and if you include "foreground", you can also set something on top of the prioryour general content, e. Not all main areas have such subareasg. <code>\setupbackgrounds[page][background={mybacklayer,foreground,mytoplayer}]</code>.
Note that backgrounds may not be rendered correctly if [[cmd:showframe|\showframe]] is used.== Example ==
<context source== Example ==yes>\setuppapersize[A10]\showframe % \setupbackgrounds should be placed *after* \showframe,
'''[text]''' has several linked subareas.<texcode>\setupbackgrounds[textfooter] [background=color,backgroundcolor=lightgrayblue]\setupbackgrounds[textfooter] [leftmargin] [background=color,backgroundcolor=red]</texcode>
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 ==
{{Forum|{{SUBPAGENAME}}}}
[[Category:Command/Backgrounds|setupbackgrounds]]

Navigation menu