Command/setupdelimitedtext

From Wiki
< Command
Revision as of 09:28, 4 September 2020 by Hraban (talk | contribs) (Mark left/rightmargin quirks as MkII only)
Jump to navigation Jump to search

\setupdelimitedtext

Syntax (autogenerated)

\setupdelimitedtext[...,...][...=...,...]
[...,...]name name:number
beforecommand
aftercommand
languagelocal global language
methodfont
repeatyes no
locationtext paragraph margin
leftcommand
middlecommand
rightcommand
nextleftcommand
nextrightcommand
spacebeforesee \blank
spaceaftersee \blank
leftmarginyes no standard dimension
rightmarginyes no standard dimension
indentingsee \setupindenting
indentnextyes no auto
stylestyle command
colorcolor
symstylestyle command
symcolorcolor


Syntax

\setupdelimitedtext[name][n][...,...=...,...]
[name] name of the delimitedtext to set up
[n] (optional) nesting level to set up
(1 = outermost)
location margin text paragraph: function unknown
spacebefore dimension: space above delimitedtext fragment
spaceafter dimension, spacebefore by default: space below delimitedtext fragment
style normal bold italic, etc
color color
leftmargin dimension: distance to edge of the page's left margin area
rightmargin dimension, leftmargin by default
indentnext yes no
before command
after command
left text
middle text
right text
level=0, unknown, 0 by default
repeat no yes
method unknown

TODO: The above describes MkII syntax. MkIV syntax is different. See the parenthesis example below (See: To-Do List)


Description

Set up the appearance of a delimitedtext environment defined earlier with \definedelimitedtext. \quotation and \quote are delimitedtexts, too, so you can also set up those with this command; but for those you can also use the special commands \setupquotation and \setupquote.

Most of the parameters are self-explanatory, but two things should be borne in mind:

  • Nearly all of the parameters apply only if the new kind of text is invoked with \startmydelimitedtext: if one uses \mydelimitedtext{...}, only left and right have any effect.
  • MkII only: leftmargin contains the distance to the actual left margin, not to the edge of the body text. If the new delimitedtext inherits from quotation, the text will be indented a bit with respect to the body text; if you want to line them up, set the leftmargin to \leftmargindistance rather than to 0pt.

Example

\definedelimitedtext[mydt]
\setupdelimitedtext[mydt][left=\leftguillemot,right=\rightguillemot]

\quotation{Clancy of the Overflow}, by Banjo Paterson

\startmydt
  And an answer came directed in a manner unexpected, and I
  think the same was written with a thumbnail dipped in tar;
  't was his shearing-mate who wrote it, and verbatim I will quote it:
  \quotation{Clancy's gone to Queensland droving, and we don't know where he are.}
\stopmydt

Smart parenthesis

\definedelimitedtext[parenthesis][location=text]
\setupdelimitedtext [parenthesis:1] [left={(}, right={)}]
\setupdelimitedtext [parenthesis:2] [left={[}, right={]}]
\setupdelimitedtext [parenthesis:3] [left={\{}, right={\}}]

\starttext

\parenthesis{My outer layer \parenthesis{my inner layer \parenthesis{my innermost layer}}}

\stoptext

Multiparagraph quotations

In English typography there is a custom of opening each paragraph in a multiparagraph quotation with a “repeated” opening quotation sign. This behavior may be turned on using the repeat switch and middle key, for example:

\setupquotation[repeat=yes, middle=]                % or equivalently
\setupdelimitedtext[quotation][repeat=yes, middle=]

See also

Help from ConTeXt-Mailinglist/Forum

All issues with: