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
random	randomize the order of items
continue	continue numbering of previous itemgroup
packed	no space between items
nowhite	no whitespace before/after itemgroup, even if \setupwhitespace is set to something
joinedup	no whitespace after itemgroup
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.
packcriterium	A number. Automatically change from normal spacing to packed spacing when the list contains this many items or more. Note: you need to specify the 'packed' option in argument 3.
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
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:

Change icon set default

\setupitemgroup[itemize:1][symbol=3] % option=3 also works, n=3 is not what you want

\startitemize
  \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

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