https://wiki.contextgarden.net/index.php?title=Command/showframe&feed=atom&action=historyCommand/showframe - Revision history2024-03-29T09:50:42ZRevision history for this page on the wikiMediaWiki 1.34.1https://wiki.contextgarden.net/index.php?title=Command/showframe&diff=33252&oldid=prevTaco at 14:20, 29 November 20212021-11-29T14:20:24Z<p></p>
<a href="https://wiki.contextgarden.net/index.php?title=Command/showframe&diff=33252&oldid=33251">Show changes</a>Tacohttps://wiki.contextgarden.net/index.php?title=Command/showframe&diff=33251&oldid=prevTaco: Created page with "Documentation for \showframe"2021-11-29T14:11:36Z<p>Created page with "Documentation for \showframe"</p>
<p><b>New page</b></p><div><cd:commandgroup name="showframe" xmlns:cd="http://wiki.contextgarden.net/commanddoc/20200807"><br />
<cd:shortdesc>The command <tt>\showframe</tt> shows a frame around page areas</cd:shortdesc><br />
<cd:variants><br />
<cd:command category="layout" file="page-run.mkiv" interfacedate="2020-07-14T09:24" interfacefile="i-layout.xml" level="document" name="showframe" variantnumber="1"><br />
<cd:arguments><br />
<cd:keywords list="yes" optional="yes" ordinal="1"><br />
<cd:keywordsdoc></cd:keywordsdoc><br />
<cd:constant type="top"></cd:constant><br />
<cd:constant type="header"></cd:constant><br />
<cd:constant type="text"></cd:constant><br />
<cd:constant type="footer"></cd:constant><br />
<cd:constant type="bottom"></cd:constant><br />
</cd:keywords><br />
<cd:keywords list="yes" optional="yes" ordinal="2"><br />
<cd:keywordsdoc></cd:keywordsdoc><br />
<cd:constant type="leftedge"></cd:constant><br />
<cd:constant type="leftmargin"></cd:constant><br />
<cd:constant type="text"></cd:constant><br />
<cd:constant type="rightmargin"></cd:constant><br />
<cd:constant type="rightedge"></cd:constant><br />
</cd:keywords><br />
</cd:arguments><br />
</cd:command><br />
</cd:variants><br />
<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. <br />
<br />
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]}}.<br />
<br />
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.</cd:description><br />
<cd:examples><cd:example title="Framing all areas"><context source="yes"><br />
\definepapersize[A11][height=26mm, width=18mm]<br />
\setuppapersize[A11]<br />
\setuplayout[<br />
% paperwidth - width - backspace<br />
% = 6mm outer space<br />
backspace=6mm, width=6mm,<br />
marginleft=2mm, marginright=2mm, <br />
leftedge=2mm, rightedge=2mm]<br />
\showframe<br />
\starttext<br />
asdf<br />
\stoptext<br />
</context><br />
</cd:example><cd:example title="Framing only the page"><context source="yes"><br />
\definepapersize[A11][height=26mm, width=18mm]<br />
\setuppapersize[A11]<br />
\setuplayout[<br />
% paperwidth - width - backspace<br />
% = 6mm outer space<br />
backspace=6mm, width=6mm,<br />
marginleft=2mm, marginright=2mm, <br />
leftedge=2mm, rightedge=2mm]<br />
\showframe[]<br />
\starttext<br />
asdf<br />
\stoptext<br />
</context><br />
</cd:example></cd:examples><br />
<cd:notes></cd:notes><br />
<cd:seealso><br />
<cd:source file="page-run.mkiv" originator="system"></cd:source><br />
<cd:wikipage originator="system" page="Category:Layout"></cd:wikipage><br />
<cd:commandref name="setupbackgrounds"></cd:commandref><br />
<cd:commandref name="showsetups">to print all the of the layout's various dimension variables.</cd:commandref></cd:seealso><br />
</cd:commandgroup></div>Taco