gardener, Interface administrators, Administrators
1,539
edits
Changes
Jump to navigation
Jump to search
\setupcolors[state=start]
location=paragraph, background=color, backgroundcolor=middlegraylightgray, leftoffset=.5\bodyfontsize, rightoffset=.5\bodyfontsize, topoffset=.5\bodyfontsize, bottomoffset=.5\bodyfontsize, before={\startnarrower\switchtobodyfont[small]}, after={\stopnarrower}, frame=off,] \starttext
\input knuth
\stoptext
{{todo|The background does not show here using the live, online conTeXt processor. Why?}} == backgroundoffset Background Offset ==
\runMPgraphicsfalse %Needed because the wiki runs MkII and write18 is not enabled
\setupcolors[state=start]
location=paragraph, background=color, backgroundcolor=middlegraylightgray, backgroundoffset=.5\bodyfontsize, before={\startnarrower\switchtobodyfont[small]}, after={\stopnarrower}, frame=off,] \starttext
\input knuth
== Example: dashed underbar (by WSIf desired, 4/2011) ==the location of the line can also be adjusted.
voffset=-\strutdp, background=, frame=off, dash=1]
Moved and edited contents of Underlining_With_TextBackgrounds
{{todo|Add more examples of usage of textbackgrounds.}}
Pages, paragraphs, words can have a background: color or screenframe. ConTeXt creates these using [[MetaPost]].
(See, eventually, the [[manual:details.pdf| details]] manual or the {{src|anch-bck.mkvi|source}} for further explanations.) == What if textbackground doesn't work? == The textbackground commands require [[write18]] to be enabled; see that page for more information.
== Example: multi-page backgrounded text ==
In the following example, we also reduce the textwidth and bodyfont size.
<context source="yes">
\definetextbackground[secondary][
\input knuth
\startsecondary
\stopsecondary
\input knuth
</context>
The options left, right, top, bottomoffset can be replaced by backgroundoffset yielding a different result:
<context source="yes">
\definetextbackground[secondary][
\input knuth
\startsecondary
\stopsecondary
\input knuth
</context>
== Underlining with Text Backgrounds ==
Underlining is generally frowned upon by experienced TeXnicians. Occasionally,
however, it is necessary and <cmd>ul</cmd> or <cmd>underbar</cmd> doesn’t do what you want. In those
cases using <cmd>definetextbackground</cmd> for the underlining may also be tried.
<context source="yes">
\definetextbackground[underline]
[location=text,alternative=1,background=,frame=off]
\definestartstop[underline]
[before={\starttextbackground[underline]},
after=\stoptextbackground]
An example with \stoptextstartunderline underlined\stopunderline\ text.
</context>
<context source="yes">
\runMPgraphicsfalse startuseMPgraphic{mpos:par:columnset} % This is needed because the wiki runs MkII and write18 is not enabled.Shift underlining down a touch \iftracepositions show_multi_pars \else draw_multi_pars \fi ; path p ; p := boundingbox currentpicture ; currentpicture := currentpicture shifted (0,-StrutDepth/3) ; setbounds currentpicture to p ;\stopuseMPgraphic\definetextbackground[underline] [location=text,alternative=1,background=,frame=off]\setuppapersizedefinestartstop[B5underline] [before={\setupbodyfontstarttextbackground[10ptunderline]}, after=\stoptextbackground]An example with \startunderline underlined\stopunderline\ text.</context>
=== Example: dashed underbar ===
(by WS, 4/2011)
<context source="yes">
\definetextbackground
[dashed]
[ location=text, framecolor=black,
alternative=1,
\starttextstartdashed \startdashed\input ward \stopdashed\stoptext
</context>
== What if textbackground doesn’t work? (MkII) ==
The textbackground commands require [[write18]] to be enabled; see that page for more information.
