Command/setupitemgroup

\setupitemgroup

Summary

The command \setupitemgroup is used for configuring item groups.

Settings

\setupitemgroup[...][...,...][...,...][...=...,...]
[...]	name
[...,...]	each number
[...,...]	intro random continue packed autointro broad text before after nowhite margin inmargin atmargin intext headintext loose fit nofit paragraph joinedup serried stopper nostopper unpacked repeat norepeat reverse columns one two three four five six seven eight nine standard number*broad number*serried horizontal name
before	command
after	command
inbetween	command
beforehead	command
afterhead	command
lefttext	command
righttext	command
left	command
right	command
factor	number
step	dimension
width	dimension
distance	dimension
margin	yes no standard dimension
leftmargin	yes no standard dimension
rightmargin	yes no standard dimension
leftmargindistance	yes no standard dimension
rightmargindistance	yes no standard dimension
align	see \setupalign
indenting	see \setupindenting
start	number
symalign	left middle right flushleft center flushright
symbol	name
n	number
indentnext	yes no auto
inner	command
command	csname
items	number
maxwidth	dimension
itemalign	left right middle flushleft flushright inner outer
alignsymbol	yes no
textdistance	small medium big none space dimension
placestopper	yes no display inline
style	style command
color	color
headstyle	style command
headcolor	color
marstyle	style command
marcolor	color
symstyle	style command
symcolor	color
grid	see \definegridsnapping
packcriterium	number
...=...,...	inherits from \setupcounter

Option	Explanation
name of the itemgroup to change.
The nesting level to configure.
each	this setup will apply to all nesting levels
number	this setup will only influence a particular nesting level
intro	always prevent a page break before the item list
packed	no whitespace between items
autointro	prevent a page break before the item list only when the last paragraph has only one or two lines
inmargin	item separator in the margin
atmargin	item separator at the margin
joinedup	no white space before and after itemization
stopper	punctuation after item separator
repeat	repeat higher-level number at lower levels, to produce e.g. 1.a.4.
columns	typeset items in two columns
standard	use the default setup
number*broad	extra horizontal white space after symbol
number*serried	little horizontal white space after symbol
inbetween	command between items (e.g. spacing)
n	enter a number e.g. n=5
items	number of items when using \its
itemalign	Alignment of the number (if n is used)
headstyle	It works only if one uses \head instead of \item; the \head must stay as a paragraph, i.e. followed by an empty line or by the command \par.
see \setupcounter	To configure the counter used for this item group

Settings assignment

\setupitemgroup[...,...][...=...,...]
[...,...]	name name:number
before	command
after	command
inbetween	command
beforehead	command
afterhead	command
lefttext	command
righttext	command
left	command
right	command
factor	number
step	dimension
width	dimension
distance	dimension
option	intro random continue packed autointro broad text before after nowhite margin inmargin atmargin intext headintext loose fit nofit paragraph joinedup serried stopper unpacked repeat norepeat reverse columns one two three four five six seven eight nine standard number*broad number*serried horizontal name
margin	yes no standard dimension
leftmargin	yes no standard dimension
rightmargin	yes no standard dimension
leftmargindistance	yes no standard dimension
rightmargindistance	yes no standard dimension
align	see \setupalign
indenting	see \setupindenting
start	number
symalign	left middle right flushleft center flushright
symbol	name
n	number
indentnext	yes no auto
inner	command
command	csname
items	number
maxwidth	dimension
itemalign	left right middle flushleft flushright inner outer
alignsymbol	yes no
textdistance	small medium big none space dimension
placestopper	yes no display inline
style	style command
color	color
headstyle	style command
headcolor	color
marstyle	style command
marcolor	color
symstyle	style command
symcolor	color
grid	see \definegridsnapping
packcriterium	number
...=...,...	inherits from \setupcounter

Option	Explanation
name	See [...] in variant default, with an implied each for the second argument
name:number	See [...] in variant default, with the number part replacing [...,...] in variant default
See [...=...,...] in variant default
option	See [...,...] in variant default

Description

This command controls all of the formatting for the specified item group, for example the name itemize configures the item group that is the environment \startitemize). \setupitemgroup[itemize] and \setupitemize are equivalent.

TODO: There are a great many options here, and not nearly all of them are documented. (See: To-Do List)

Examples

Example 1

\setuppapersize[A8]

% generates itemization like "Idea a:  text text .."
\setupitemize
   [1]       % level of itemization
   [broad]
   [margin=no,
    distance=5em,
    stopper=,
    left=Idea ,
    right=:]

\starttext

\startitemize[a]
  \item Text Text Text Text Text Text Text Text Text Text Text Text
  \item Text Text Text Text Text Text Text Text Text Text Text Text
\stopitemize
\stoptext

Head style example

\starttext
  \startitemize[][headstyle=bold]
    \head Head 1

      \dorecurse{16}{some text }
    \head Head 2\par
      \dorecurse{10}{some other text }
  \stopitemize

  \startitemize[][headstyle=\em,afterhead={\blank[small]}]
    \head Head 3\par
      \dorecurse{10}{some closer text }

    \head Head 4\par
  \stopitemize
\stoptext

Gives:

See also

• \definecounter
• \definegridsnapping
• \defineindenting
• \defineitemgroup
• \setupalign
• \setupcounter
• \setupindenting
• strc-itm.mkvi
• \startitemgroup
• \startitemize

Help from ConTeXt-Mailinglist/Forum

All issues with:

• \setupitemgroup on the mailing list (all results)
• \setupitemgroup on the mailing list (subject only)
• \setupitemgroup on stack exchange
• \setupitemgroup in ConTeXt's source