Command/setupitemgroup

From Wiki
< Command
Revision as of 17:28, 20 September 2020 by Benjamin (talk | contribs)
Jump to navigation Jump to search


\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
beforecommand
aftercommand
inbetweencommand
beforeheadcommand
afterheadcommand
lefttextcommand
righttextcommand
leftcommand
rightcommand
factornumber
stepdimension
widthdimension
distancedimension
marginyes no standard dimension
leftmarginyes no standard dimension
rightmarginyes no standard dimension
leftmargindistanceyes no standard dimension
rightmargindistanceyes no standard dimension
alignsee \setupalign
indentingsee \setupindenting
startnumber
symalignleft middle right flushleft center flushright
symbolname
nnumber
indentnextyes no auto
innercommand
commandcsname
itemsnumber
maxwidthdimension
itemalignleft right middle flushleft flushright inner outer
alignsymbolyes no
textdistancesmall medium big none space dimension
placestopperyes no display inline
stylestyle command
colorcolor
headstylestyle command
headcolorcolor
marstylestyle command
marcolorcolor
symstylestyle command
symcolorcolor
gridsee \definegridsnapping
packcriteriumnumber
...=...,...inherits from \setupcounter

OptionExplanation
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
beforecommand
aftercommand
inbetweencommand
beforeheadcommand
afterheadcommand
lefttextcommand
righttextcommand
leftcommand
rightcommand
factornumber
stepdimension
widthdimension
distancedimension
optionintro 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
marginyes no standard dimension
leftmarginyes no standard dimension
rightmarginyes no standard dimension
leftmargindistanceyes no standard dimension
rightmargindistanceyes no standard dimension
alignsee \setupalign
indentingsee \setupindenting
startnumber
symalignleft middle right flushleft center flushright
symbolname
nnumber
indentnextyes no auto
innercommand
commandcsname
itemsnumber
maxwidthdimension
itemalignleft right middle flushleft flushright inner outer
alignsymbolyes no
textdistancesmall medium big none space dimension
placestopperyes no display inline
stylestyle command
colorcolor
headstylestyle command
headcolorcolor
marstylestyle command
marcolorcolor
symstylestyle command
symcolorcolor
gridsee \definegridsnapping
packcriteriumnumber
...=...,...inherits from \setupcounter

OptionExplanation
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

Notes

See also

Help from ConTeXt-Mailinglist/Forum

All issues with: