gardener, Interface administrators, Administrators
1,544
edits
Changes
Jump to navigation
Jump to search
< {{todo|Add more examples of usage of textbackgrounds.}} == Basics == Pages, paragraphs, words can have a background color or [[Main PageOverlays|overlay]] | . ConTeXt creates these using [[VisualsMetaPost]] >. But a usual frame is only one object, its contents can’t flow over to the next page.
Pages, The `location` parameter changes the behaviour between `text` (highlighting running text) and `paragraph` (boxed paragraphs, words can have a background: color or screen. Note that "screen" is deprecated in MkIV).
== What if textbackground doesn’t work? ==
more intro
You can use {{todocmd|Add more examples of usage of textbackgroundsdefinetextbackground}} to define a named text background.The environment is based on {{cmd|framed}}and understands its parameters, but can contain several paragraphs and page breaks. After `\definetextbackground[Name]` you can use `\startName ... \stopName` (if there’s no name conflict) or `\starttextbackground[Name] ... \stoptextbackground`. Usually you won’t need {{cmd|setuptextbackground}}.
(See, eventually, the [[manual:details.pdf| details]] manual or the {{src|anch-bck.mkvi|source}} for further explanations.)
'''Beware''': The textbackground commands require [[write18]] to examples using {{cmd|startnarrower}} may be enabledmisleading – of course you can use {{cmd|startbackground}} without the `narrower` environment; see that page for more informationit behaves differently without `\starttext ... \stoptext`.
== Example: multi-page backgrounded text ==
frame=off,]
\input starttext\samplefile{knuth}
\startsecondary
\input samplefile{knuth}
\stopsecondary
\input samplefile{knuth}\stoptext
</context>
== backgroundoffset Background Offset ==
The options left, right, top, bottomoffset can be replaced by backgroundoffset yielding a different result:
frame=off,]
\input starttext\samplefile{knuth}
\startsecondary
\input samplefile{knuth}
\stopsecondary
\input samplefile{knuth}\stoptext</context> == Underlining with Text Backgrounds == Underlining is generally frowned upon by experienced TeXnicians. Occasionally,however, it is necessary and {{cmd|ul}} or {{cmd|underbar}} doesn’t do what you want. In thosecases using {{cmd|definetextbackground}} 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] \startTEXpageAn example with \startunderline underlined\stopunderline\ text.\stopTEXpage
</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] \startTEXpageAn example with \startunderline underlined\stopunderline\ text.\stopTEXpage</context> === Example: dashed underbar ===(by WS, 4/2011) ==
<context source="yes">
\startdashed
\input samplefile{ward}
\stopdashed
</context>
[[Category:Basics]]
