summaryrefslogtreecommitdiff
path: root/docs/modules/theme/pages/prose.adoc
diff options
context:
space:
mode:
Diffstat (limited to 'docs/modules/theme/pages/prose.adoc')
-rw-r--r--docs/modules/theme/pages/prose.adoc39
1 files changed, 39 insertions, 0 deletions
diff --git a/docs/modules/theme/pages/prose.adoc b/docs/modules/theme/pages/prose.adoc
new file mode 100644
index 00000000..e5d1f208
--- /dev/null
+++ b/docs/modules/theme/pages/prose.adoc
@@ -0,0 +1,39 @@
+= Prose Category Keys
+:navtitle: Prose
+
+The keys in the `prose` category control the spacing below paragraphs, lists, and index categories.
+The bottom margin is only added if the block is followed by an adjacent block within the same enclosure (e.g., a sidebar, a table cell, or the area outside a block).
+
+[#key-prefix-prose,cols="3,4,5l"]
+|===
+|Key |Value Type |Example
+
+|margin-bottom
+|xref:measurement-units.adoc[Measurement] +
+(default: 12)
+|prose:
+margin-bottom: $vertical-spacing
+
+|margin-inner^[1]^
+|xref:measurement-units.adoc[Measurement] +
+(default: $prose-margin-bottom)
+|prose:
+margin-inner: 0
+
+|text-indent
+|xref:measurement-units.adoc[Measurement] +
+(default: _not set_)
+|prose:
+text-indent: 18
+
+|text-indent-inner^[2]^
+|xref:measurement-units.adoc[Measurement] +
+(default: _not set_)
+|prose:
+text-indent-inner: 18
+|===
+1. Controls the margin between adjacent paragraphs.
+Useful when using indented paragraphs.
+2. Only applied to inner paragraphs.
+Inner paragraphs are paragraphs that follow an adjacent paragraph.
+