Difference between revisions of "Command/setupitemgroup"
< Command
Jump to navigation
Jump to search
m (explain a few options) |
(more options explained) |
||
Line 17: | Line 17: | ||
<cd:keywords list="yes" optional="yes" ordinal="3"> | <cd:keywords list="yes" optional="yes" ordinal="3"> | ||
<cd:keywordsdoc></cd:keywordsdoc> | <cd:keywordsdoc></cd:keywordsdoc> | ||
− | <cd:constant type="intro"></cd:constant> | + | <cd:constant type="intro">no page break in front of the itemgroup</cd:constant> |
<cd:constant type="random">randomize the order of items</cd:constant> | <cd:constant type="random">randomize the order of items</cd:constant> | ||
<cd:constant type="continue">continue numbering of previous itemgroup</cd:constant> | <cd:constant type="continue">continue numbering of previous itemgroup</cd:constant> | ||
Line 23: | Line 23: | ||
<cd:constant type="autointro"></cd:constant> | <cd:constant type="autointro"></cd:constant> | ||
<cd:constant type="broad"></cd:constant> | <cd:constant type="broad"></cd:constant> | ||
− | <cd:constant type="text"></cd:constant> | + | <cd:constant type="text">typeset items as running text</cd:constant> |
<cd:constant type="before"></cd:constant> | <cd:constant type="before"></cd:constant> | ||
<cd:constant type="after"></cd:constant> | <cd:constant type="after"></cd:constant> | ||
− | <cd:constant type="nowhite"> | + | <cd:constant type="nowhite">like "packed,joinedup", but also works if {{cmd|setupwhitespace}} is set to something</cd:constant> |
<cd:constant type="margin"></cd:constant> | <cd:constant type="margin"></cd:constant> | ||
− | <cd:constant type="inmargin"></cd:constant> | + | <cd:constant type="inmargin">place bullets or numbers in the margin</cd:constant> |
<cd:constant type="atmargin"></cd:constant> | <cd:constant type="atmargin"></cd:constant> | ||
<cd:constant type="intext"></cd:constant> | <cd:constant type="intext"></cd:constant> | ||
Line 36: | Line 36: | ||
<cd:constant type="nofit"></cd:constant> | <cd:constant type="nofit"></cd:constant> | ||
<cd:constant type="paragraph"></cd:constant> | <cd:constant type="paragraph"></cd:constant> | ||
− | <cd:constant type="joinedup">no whitespace after itemgroup</cd:constant> | + | <cd:constant type="joinedup">no whitespace before or after itemgroup, except if {{cmd|setupwhitespace}} is set to something</cd:constant> |
<cd:constant type="serried"></cd:constant> | <cd:constant type="serried"></cd:constant> | ||
<cd:constant type="stopper"></cd:constant> | <cd:constant type="stopper"></cd:constant> | ||
<cd:constant type="nostopper"></cd:constant> | <cd:constant type="nostopper"></cd:constant> | ||
− | <cd:constant type="unpacked"></cd:constant> | + | <cd:constant type="unpacked">adds whitespace between items if `packed` is default</cd:constant> |
<cd:constant type="repeat"></cd:constant> | <cd:constant type="repeat"></cd:constant> | ||
<cd:constant type="norepeat"></cd:constant> | <cd:constant type="norepeat"></cd:constant> | ||
<cd:constant type="reverse"></cd:constant> | <cd:constant type="reverse"></cd:constant> | ||
− | <cd:constant type="columns"></cd:constant> | + | <cd:constant type="columns">typeset items in 2 columns (only with {{cmd|startitem}}…`\stopitem`)</cd:constant> |
<cd:constant type="one"></cd:constant> | <cd:constant type="one"></cd:constant> | ||
− | <cd:constant type="two"></cd:constant> | + | <cd:constant type="two">typeset items in 2 columns (only with {{cmd|startitem}}…`\stopitem`)</cd:constant> |
− | <cd:constant type="three"></cd:constant> | + | <cd:constant type="three">typeset items in 3 columns (only with {{cmd|startitem}}…`\stopitem`)</cd:constant> |
− | <cd:constant type="four"></cd:constant> | + | <cd:constant type="four">typeset items in 4 columns (only with {{cmd|startitem}}…`\stopitem`)</cd:constant> |
− | <cd:constant type="five"></cd:constant> | + | <cd:constant type="five">typeset items in 5 columns (only with {{cmd|startitem}}…`\stopitem`)</cd:constant> |
− | <cd:constant type="six"></cd:constant> | + | <cd:constant type="six">typeset items in 6 columns (only with {{cmd|startitem}}…`\stopitem`)</cd:constant> |
− | <cd:constant type="seven"></cd:constant> | + | <cd:constant type="seven">typeset items in 4 columns (only with {{cmd|startitem}}…`\stopitem`)</cd:constant> |
− | <cd:constant type="eight"></cd:constant> | + | <cd:constant type="eight">typeset items in 8 columns (only with {{cmd|startitem}}…`\stopitem`)</cd:constant> |
− | <cd:constant type="nine"></cd:constant> | + | <cd:constant type="nine">typeset items in 9 columns (only with {{cmd|startitem}}…`\stopitem`)</cd:constant> |
<cd:constant type="standard"></cd:constant> | <cd:constant type="standard"></cd:constant> | ||
<cd:constant method="factor" prefix="cd:number" type="broad"></cd:constant> | <cd:constant method="factor" prefix="cd:number" type="broad"></cd:constant> | ||
Line 103: | Line 103: | ||
</cd:parameter> | </cd:parameter> | ||
<cd:parameter name="step"> | <cd:parameter name="step"> | ||
− | <cd:paramdoc></cd:paramdoc> | + | <cd:paramdoc>step size of numbering (e.g. 2 = use every second number)</cd:paramdoc> |
<cd:constant type="cd:dimension"></cd:constant> | <cd:constant type="cd:dimension"></cd:constant> | ||
</cd:parameter> | </cd:parameter> | ||
Line 158: | Line 158: | ||
</cd:parameter> | </cd:parameter> | ||
<cd:parameter name="start"> | <cd:parameter name="start"> | ||
− | <cd:paramdoc></cd:paramdoc> | + | <cd:paramdoc>start of numbering</cd:paramdoc> |
<cd:constant type="cd:number"></cd:constant> | <cd:constant type="cd:number"></cd:constant> | ||
</cd:parameter> | </cd:parameter> | ||
<cd:parameter name="symalign"> | <cd:parameter name="symalign"> | ||
− | <cd:paramdoc></cd:paramdoc> | + | <cd:paramdoc>alignment of the bullet/number</cd:paramdoc> |
<cd:constant type="left"></cd:constant> | <cd:constant type="left"></cd:constant> | ||
<cd:constant type="middle"></cd:constant> | <cd:constant type="middle"></cd:constant> | ||
Line 171: | Line 171: | ||
</cd:parameter> | </cd:parameter> | ||
<cd:parameter name="symbol"> | <cd:parameter name="symbol"> | ||
− | <cd:paramdoc></cd:paramdoc> | + | <cd:paramdoc>name of a symbol as bullet</cd:paramdoc> |
<cd:constant type="cd:name"></cd:constant> | <cd:constant type="cd:name"></cd:constant> | ||
</cd:parameter> | </cd:parameter> | ||
Line 232: | Line 232: | ||
</cd:parameter> | </cd:parameter> | ||
<cd:parameter name="style"> | <cd:parameter name="style"> | ||
− | <cd:paramdoc></cd:paramdoc> | + | <cd:paramdoc>style of the bullet/number</cd:paramdoc> |
<cd:constant type="cd:style"></cd:constant> | <cd:constant type="cd:style"></cd:constant> | ||
<cd:constant type="cd:command"></cd:constant> | <cd:constant type="cd:command"></cd:constant> | ||
</cd:parameter> | </cd:parameter> | ||
<cd:parameter name="color"> | <cd:parameter name="color"> | ||
− | <cd:paramdoc></cd:paramdoc> | + | <cd:paramdoc>color of the bullet/number</cd:paramdoc> |
<cd:constant type="cd:color"></cd:constant> | <cd:constant type="cd:color"></cd:constant> | ||
</cd:parameter> | </cd:parameter> | ||
Line 259: | Line 259: | ||
</cd:parameter> | </cd:parameter> | ||
<cd:parameter name="symstyle"> | <cd:parameter name="symstyle"> | ||
− | <cd:paramdoc></cd:paramdoc> | + | <cd:paramdoc>same as style</cd:paramdoc> |
<cd:constant type="cd:style"></cd:constant> | <cd:constant type="cd:style"></cd:constant> | ||
<cd:constant type="cd:command"></cd:constant> | <cd:constant type="cd:command"></cd:constant> | ||
</cd:parameter> | </cd:parameter> | ||
<cd:parameter name="symcolor"> | <cd:parameter name="symcolor"> | ||
− | <cd:paramdoc></cd:paramdoc> | + | <cd:paramdoc>same as color</cd:paramdoc> |
<cd:constant type="cd:color"></cd:constant> | <cd:constant type="cd:color"></cd:constant> | ||
</cd:parameter> | </cd:parameter> |
Revision as of 15:09, 15 January 2024
Contents
\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 | ||
---|---|---|---|
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 | ||
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 |
||
columns | typeset items in 2 columns (only with \startitem…\stopitem ) |
||
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 |
| ||
step |
| ||
start |
| ||
symalign |
| ||
symbol |
| ||
n |
| ||
items |
| ||
itemalign |
| ||
style |
| ||
color |
| ||
headstyle |
| ||
symstyle |
| ||
symcolor |
| ||
packcriterium |
| ||
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 |
|
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