= Verse Category Keys
:description: Reference list of the available verse block category keys and their value types.
:navtitle: Verse
:source-language: yaml

[#verse]
== verse

The keys in the `verse` category control the arrangement and style of verse blocks.

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

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

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

|<<border-width,border-left-width>>
|xref:blocks.adoc#border-width[Measurement] +
(default: `4`)
|[source]
verse:
  border-left-width: 5

|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]
verse:
  border-style: dashed

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

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

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

|font-kerning
|none {vbar} normal +
(default: _inherit_)
|[source]
verse:
  font-kerning: none

|font-size
|xref:text.adoc#font-size[Font size] +
(default: _inherit_)
|[source]
verse:
  font-size: 10

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

|padding
|xref:blocks.adoc#padding[Measurement] {vbar} xref:blocks.adoc#padding[Measurement[\]] +
(default: `[3, 12, 3, 14]`)
|[source]
verse:
  padding: 3

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

[#border-width]
=== border-width and border-left-width

If `border-left-width` is non-zero, the border is only applied to the left side.
Otherwise, if `border-width` is non-zero, the border is drawn around the whole block.

[#font-family]
=== font-family

The verse block doesn't use a fixed-width font by default, which can affect the layout if the content relies on columns.
You can change verse blocks to use a fixed-width font (not necessarily a monospaced font) using this setting.

[#cite]
== verse-cite

The keys in the `verse-cite` category control the arrangement and style of the citation in verse blocks.

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

|font-color
|xref:color.adoc[Color] +
(default: _inherit_)
|[source]
verse:
  cite:
    font-color: #999999

|font-family
|xref:font-support.adoc[Font family name] +
(default: _inherit_)
|[source]
verse:
  cite:
    font-family: Noto Serif

|font-kerning
|`none` {vbar} `normal` +
(default: _inherit_)
|[source]
verse:
  cite:
    font-kerning: none

|font-size
|xref:text.adoc#font-size[Font size] +
(default: _inherit_)
|[source]
verse:
  cite:
    font-size: 9

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

|text-transform
|xref:text.adoc#transform[Text transform] +
(default: _inherit_)
|[source]
verse:
  cite:
    text-transform: uppercase
|===
