Changes

Jump to navigation Jump to search
1,351 bytes added ,  10:38, 5 February 2019
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">
\setupcolors[state=start]
 
\definetextbackground[secondary][
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
\startsecondary
\input knuth
\stopsecondary
\input knuth
 
\stoptext
</context>
{{todo|The background does not show here using the live, online conTeXt processor. Why?}} == backgroundoffset Background Offset ==
The options left, right, top, bottomoffset can be replaced by backgroundoffset yielding a different result:
<context source="yes">
\setupcolors[state=start]
 
\definetextbackground[secondary][
location=paragraph, background=color, backgroundcolor=middlegraylightgray, backgroundoffset=.5\bodyfontsize, before={\startnarrower\switchtobodyfont[small]}, after={\stopnarrower}, frame=off,\starttext
\input knuth
\startsecondary
\input knuth
\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 thosecases using <cmd>definetextbackground</cmd> for the underlining may also be tried. <context source="yes">\stoptextdefinetextbackground[underline] [location=text,alternative=1,background=,frame=off]\definestartstop[underline] [before={\starttextbackground[underline]}, after=\stoptextbackground] An example with \startunderline underlined\stopunderline\ text.</context> If desired, the location of the line can also be adjusted. <context source="yes">\startuseMPgraphic{mpos:par:columnset} % 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]\definestartstop[underline] [before={\starttextbackground[underline]}, 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, voffset=-\strutdp, background=, frame=off, dash=1] \startdashed\input ward\stopdashed
</context>
 
== What if textbackground doesn’t work? (MkII) ==
 
The textbackground commands require [[write18]] to be enabled; see that page for more information.

Navigation menu