= Callout List and Number Category Keys
:description: Reference list of the available callout list and callout number (conum) category keys and their value types.
:navtitle: Callout List and Number
:source-language: yaml

[#callout-list]
== callout-list

The keys in the `callout-list` category control the arrangement and style of callout lists and callout list item content.
These keys don't affect the callout list markers.
The appearance of the markers is controlled independently by the keys in <<conum,conum category>>.
Also see <<inherit>> for more information.

[cols="3,4,5a"]
|===
|Key |Value Type |Example

|<<inherit,font-color>>
|xref:color.adoc[Color] +
(default: _inherit_)
|[source]
callout-list:
  font-color: #555555

|<<inherit,font-family>>
|xref:font-support.adoc[Font family name] +
(default: _inherit_)
|[source]
callout-list:
  font-family: M+ 1p

|<<inherit,font-kerning>>
|`normal` {vbar} `none` +
(default: _inherit_)
|[source]
callout-list:
  font-kerning: none

|<<inherit,font-size>>
|xref:language.adoc#values[Number] +
(default: _inherit_)
|[source]
callout-list:
  font-size: 9

|<<inherit,font-style>>
|xref:text.adoc#font-style[Font style] +
(default: _inherit_)
|[source]
callout-list:
  font-style: italic

|item-spacing
|xref:measurement-units.adoc[Measurement] +
(default: `$list-item-spacing`)
|[source]
callout-list:
  item-spacing: 3

|<<inherit,line-height>>
|xref:language.adoc#values[Number] +
(default: _inherit_)
|[source]
callout-list:
  line-height: 1

|margin-top-after-code
|xref:measurement-units.adoc[Measurement] +
(default: `-6`)
|[source]
callout-list:
  margin-top-after-code: 0

|text-align
|xref:text.adoc#text-align[Text alignment] +
(default: `$list-text-align`)
|[source]
callout-list:
  text-align: left

|text-transform
|xref:text.adoc#transform[Text transform] +
(default: _inherit_)
|[source]
callout-list:
  text-transform: lowercase
|===

[#conum]
== conum

The keys in the `conum` category control the style of callout numbers inside verbatim blocks and in callout lists.
These keys don't affect the callout list item content.
The appearance of the callout list and the content of the list items are controlled independently by the keys in <<callout-list,callout-list category>>.
Also see <<inherit>> for more information.

[cols="2,5,5a"]
|===
|Key |Value Type |Example

|<<inherit,font-color>>
|xref:color.adoc[Color] +
(default: _inherit_)
|[source]
conum:
  font-color: #B12146

|<<glyphs,font-family>>
|xref:font-support.adoc[Font family name] +
(default: _inherit_)
|[source]
conum:
  font-family: M+ 1mn

|<<inherit,font-kerning>>
|`none` {vbar} `normal` +
(default: _inherit_)
|[source]
conum:
  font-kerning: none

|<<inherit,font-size>>
|xref:language.adoc#values[Number] +
(default: _inherit_)
|[source]
conum:
  font-size: $base-font-size

|<<inherit,font-style>>
|xref:text.adoc#font-style[Font style] +
(default: _inherit_)
|[source]
conum:
  font-style: normal

|<<glyphs,glyphs>>
|`circled` {vbar} `filled` {vbar} Unicode String ranges +
(default: `circled`)
|[source]
conum:
  glyphs: \u0031-\u0039

|<<inherit,line-height>>
|xref:language.adoc#values[Number] +
(default: `1.15`)
|[source]
conum:
  line-height: 4 / 3
|===

[#glyphs]
=== font-family and glyphs

When a font is assigned to the `conum-font-family` key, it must contain the circle numbers starting at glyph U+2460, otherwise you must also assign a range of Unicode numbers to the `conum-glyphs` key.
The glyphs can be specified as a comma-separated list of ranges, where the range values are Unicode numbers (e.g., \u2460).
Unicode escape sequences are recognized even if the value is not enclosed in double quotes.

[#inherit]
== font-* and line-height inheritance

When the `font-color`, `font-family`, `font-kerning`, `font-size`, `font-style`, and `line-height` keys are set on the `callout-list` category they apply solely to the callout list item content, not the callout list markers.
The inverse is also true.
When these properties are set under the `conum` category, they only affect the callout list markers.
This means that if you change the value of a font or line height key on the `callout-list` or `conum` category, then you likely need to change the value of the same key on the other category as well.