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
e.g. "itemize"
item level
each	all levels
number	only one level
intro	no page break in front of the itemgroup
random	randomize the order of items
continue	continue numbering of previous itemgroup
packed	no space between items
text	typeset items as running text
before	if nowhite, insert whitespace before the itemgroup
after	if nowhite, insert whitespace after the itemgroup
nowhite	like packed,joinedup, but also works if \setupwhitespace is set to something
inmargin	place bullets or numbers in the margin
joinedup	no whitespace before or after itemgroup, except if \setupwhitespace is set to something
unpacked	adds whitespace between items if packed is default
repeat	in nested itemgroups, repeat the number(s) of the parent item
norepeat	opposite of repeat
columns	typeset items in 2 columns (only with \startitem … \stopitem), required for other columns settings
one	typeset items in 1 column (if some other setting is default), only if columns
two	typeset items in 2 columns (only with \startitem … \stopitem), only if columns
three	typeset items in 3 columns (only with \startitem … \stopitem), only if columns
four	typeset items in 4 columns (only with \startitem … \stopitem), only if columns
five	typeset items in 5 columns (only with \startitem … \stopitem), only if columns
six	typeset items in 6 columns (only with \startitem … \stopitem), only if columns
seven	typeset items in 4 columns (only with \startitem … \stopitem), only if columns
eight	typeset items in 8 columns (only with \startitem … \stopitem), only if columns
nine	typeset items in 9 columns (only with \startitem … \stopitem), only if columns
inbetween	command between items (e.g. spacing)
step	step size of numbering (e.g. 2 = use every second number)
start	start of numbering
symalign	alignment of the bullet/number
symbol	name of a symbol as bullet
n	number of columns if columns
items	number of items when using \its
itemalign	Alignment of the number (if n is used)
style	style of the bullet/number
color	color of the bullet/number
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.
symstyle	same as style
symcolor	same as color
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
  

  Produces:

• 

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
  

• 

Bullets

Here are some bullets:

• \starttabulate[|T|ch{\symbol}|T|ch{\symbol}|]
  \HL
  \NC 1 \HC {1} \VL bullet        \HC {bullet}            \NC\NR
  \NC 2 \HC {2} \VL dash          \HC {dash}            \NC\NR
  \NC 3 \HC {3} \VL star          \HC {star}            \NC\NR
  \NC   \NC     \VL asterisk      \HC {asterisk}          \NC\NR
  \NC 4 \HC {4} \VL triangle      \HC {triangle}        \NC\NR
  \NC   \NC     \VL blacktriangle \HC {blacktriangle}   \NC\NR
  \NC 5 \HC {5} \VL circle        \HC {circle}            \NC\NR
  \NC 6 \HC {6} \VL               \NC \NC\NR
  \NC 7 \HC {7} \VL               \NC \NC\NR
  \NC 8 \HC {8} \VL square        \HC {square} \NC\NR
  \NC   \NC     \VL blacksquare   \HC {blacksquare} \NC\NR
  \NC   \NC     \VL diamond       \HC {diamond}            \NC\NR
  \NC   \NC     \VL blackdiamond  \HC {blackdiamond}        \NC\NR
  \NC 9 \HC {9} \VL checkmark     \HC {checkmark}        \NC\NR
  \HL
  \stoptabulate
  

• 

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