= Code Block Category Keys
:description: Reference list of the available code block (listing, literal, and source) category keys and their value types.
:navtitle: Code Block
:source-language: yaml

[#code]
== code

The keys in the `code` category control the arrangement and style of literal, listing, and source blocks as well as literal table cells.

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

|background-color
|xref:color.adoc[Color] +
(default: _not set_)
|[source]
code:
  background-color: #F5F5F5

|border-color
|xref:blocks.adoc#border-color[Color] +
(default: `'EEEEEE'`)
|[source]
code:
  border-color: #CCCCCC

|border-radius
|xref:blocks.adoc#radius[Measurement] +
(default: _not set_)
|[source]
code:
  border-radius: 4

|border-style
|xref:blocks.adoc#border-style[Border style] +
(default: `solid`)
|[source]
code:
  border-style: dashed

|border-width
|xref:blocks.adoc#border-width[Measurement] {vbar} xref:blocks.adoc#border-width[Measurement[\]] +
(default: `0.5`)
|[source]
code:
  border-width: [0.75, 0]

|font-color
|xref:color.adoc[Color] +
(default: _inherit_)
|[source]
code:
  font-color: #333333

|font-family
|xref:font-support.adoc[Font family name] +
(default: `Courier`)
|[source]
code:
  font-family: M+ 1mn

|font-size
|xref:language.adoc#values[Number] +
(default: `10.8`)
|[source]
code:
  font-size: 11

|font-style
|xref:text.adoc#font-style[Font style] +
(default: _inherit_)
|[source]
code:
  font-style: italic

|<<line-gap,line-gap>>
|xref:language.adoc#values[Number] +
(default: `0`)
|[source]
code:
  line-gap: 3.8

|line-height
|xref:language.adoc#values[Number] +
(default: `1.2`)
|[source]
code:
  line-height: 1.25

|padding
|xref:blocks.adoc#padding[Measurement] {vbar} xref:blocks.adoc#padding[Measurement[\]] +
(default: `9`)
|[source]
code:
  padding: 12mm
|===

[#line-gap]
=== line-gap

The `line-gap` key is used to tune the height of the background color applied to a span of block text highlighted using Rouge.

[#highlight]
== code-highlight

The key in the `code-highlight` category only applies when you use Rouge as the source highlighter.
Otherwise, the background color is controlled by the source highlighter theme.

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

|background-color
|xref:color.adoc[Color] +
(default: `#FFFFCC`)
|[source]
code:
  highlight-background-color: #FFFF00
|===

[#linenum]
== code-linenum

The key in the `code-linenum` category only applies when you use Pygments as the source highlighter.
Otherwise, the font color of line numbers is controlled by the source highlighter theme.

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

|font-color
|xref:color.adoc[Color] +
(default: `#999999`)
|[source]
code:
  linenum-font-color: #CCCCCC
|===