From 54f84e20a22d0f3c2a664da076c3aa166039edc1 Mon Sep 17 00:00:00 2001
From: Sam Scholten
Date: Thu, 27 Aug 2026 14:39:10 +1000
Subject: tweak title h2/h3 sizing, note vspace margin collapse and custom
 spacers

---
 README    |  6 ++++++
 acarp.css | 10 +++++++---
 2 files changed, 13 insertions(+), 3 deletions(-)

diff --git a/README b/README
index 5e4c0b6..44922b5 100644
--- a/README
+++ b/README
@@ -117,6 +117,12 @@ def hello(name):
 </div>
 ```
 
+### Vertical Spacing
+```html
+<div class="vspace-large"></div>      <!-- classes: tiny 0.5em, small 1em, medium 2em, large 3em, xlarge 4em, xxlarge 5em, vspace-6..10 (em) -->
+<div style="height: 15em"></div>      <!-- custom sizes: use this instead (consecutive vspace divs don't stack - margins collapse) -->
+```
+
 ## Themes
 
 ## Customization
diff --git a/acarp.css b/acarp.css
index 2e4c05a..2a14e4a 100644
--- a/acarp.css
+++ b/acarp.css
@@ -312,7 +312,11 @@ section .math {
    Use these classes to add consistent spacing between content blocks.
    ============================================================================ */
 
-/* Vertical spacing utilities - add top margin */
+/* Vertical spacing utilities - add top margin.
+   For custom spacings, use an inline-height spacer div instead:
+     <div style="height: 15em"></div>
+   Note: consecutive vspace divs do NOT stack - adjacent margins collapse
+   to the larger value, so two .vspace-10 give 10em, not 20em. */
 .vspace-tiny { margin-top: 0.5em !important; }
 .vspace-small { margin-top: 1em !important; }
 .vspace-medium { margin-top: 2em !important; }
@@ -407,7 +411,7 @@ section.title > h1 {
 }
 
 section.title > h2 {
-  font-size: 1.2em !important;
+  font-size: 1.3em !important;
   color: #666;
   margin: 0.5em 0 0 0;
   padding: 0;
@@ -418,7 +422,7 @@ section.title > h2 {
 section.title > h3 {
   font-size: 0.9em !important;
   font-weight: normal !important;
-  color: #666;
+  color: #888;
   margin: 0.5em 0 0 0;
   padding: 0;
 }
-- 
cgit v1.2.3