Command/setupbar

From Wiki
Jump to navigation Jump to search


\setupbar

Summary

The command \setupbar sets up parameters for rules (lines)

Settings

\setupbar[...,...][...=...,...]
[...,...]name
colorcolor
continueyes no all
emptyyes no
unitex em pt in cm mm sp bp pc dd cc nc
orderforeground background
rulethicknessdimension
methodnumber
offsetnumber
dynumber
maxnumber
foregroundstylestyle command
foregroundcolorcolor
mpname
lefttext
righttext
repeatyes no

OptionExplanation
Name of the bar.
color
color of the bar itself
continue
controls split based on words
yes split on words
no continuous bar
unit
unit to use for offset and dy
order
put the rules in front of, or behind the text.
method
switch between centred and baseline-based vertical aligment
number 0 = centred vertically. Leave empty / omit for offset to be based on the text's baseline.
offset
vertical shift
dy
vertical shift when used nested
max
maximum nesting level
foregroundstyle
useful if order=background
foregroundcolor
useful if order=background
mp
Use a named \startuseMPgraphic to create the bar. See the definition of e.g. underdash in node-rul.mkiv for an example.
repeat
Originally used for leader-style 'bars' (dotted or dashed). Used in combination with the (undocumented) option text. Replaced by the much more powerful mp option.

Description

Set up options for 'bars': rule- and dots based decorations for running text.

See bar for the predefined instances. You can define your own instances with \definebar.


Examples

Example 1

\setupbar[overstrike][color=red]
some \overstrike{stricken} text.

Notes

See also

Help from ConTeXt-Mailinglist/Forum

All issues with: