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
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)
one typeset items in 1 column (if some other setting is default)
two typeset items in 2 columns (only with \startitem … \stopitem)
three typeset items in 3 columns (only with \startitem … \stopitem)
four typeset items in 4 columns (only with \startitem … \stopitem)
five typeset items in 5 columns (only with \startitem … \stopitem)
six typeset items in 6 columns (only with \startitem … \stopitem)
seven typeset items in 4 columns (only with \startitem … \stopitem)
eight typeset items in 8 columns (only with \startitem … \stopitem)
nine typeset items in 9 columns (only with \startitem … \stopitem)
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
enter a number e.g. n=5
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
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

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

Notes

See also

Help from ConTeXt-Mailinglist/Forum

All issues with: