From 99c5481f17d8a86bfc6baec054d7f0c1e8929b0d Mon Sep 17 00:00:00 2001
From: Alan Grainger <16197738+alangrainger@users.noreply.github.com>
Date: Fri, 9 Oct 2026 11:06:33 +1300
Subject: [PATCH] Update docs
---
docs/.vitepress/theme/custom.css | 70 ++++++++++++++++++++++++++++++++
1 file changed, 70 insertions(+)
diff --git a/docs/.vitepress/theme/custom.css b/docs/.vitepress/theme/custom.css
index 16b9b34..d292a60 100644
--- a/docs/.vitepress/theme/custom.css
+++ b/docs/.vitepress/theme/custom.css
@@ -44,3 +44,73 @@
transform: none;
}
}
+
+/* ===== Callouts =====
+ GitHub-style alerts (`> [!NOTE]` and friends) render as VitePress custom
+ blocks: a flat tinted box with an all-caps label. Restyle them as a card
+ with a coloured left rule, an icon and a sentence-case title, in the colour
+ the default theme already assigns each kind. Icons are Material Design,
+ drawn through a mask so they take the title colour in both themes. */
+
+.vp-doc .custom-block {
+ --ipp-callout: var(--vp-c-default-1);
+ --ipp-callout-icon: var(--ipp-icon-note);
+ position: relative;
+ margin: 20px 0;
+ padding: 14px 18px 6px 48px;
+ border: 1px solid var(--vp-c-divider);
+ border-left: 4px solid var(--ipp-callout);
+ border-radius: 8px;
+ background-color: color-mix(in srgb, var(--ipp-callout) 6%, var(--vp-c-bg-soft));
+ color: var(--vp-c-text-1);
+}
+
+.vp-doc .custom-block.info { --ipp-callout: var(--vp-c-default-1); }
+.vp-doc .custom-block.note { --ipp-callout: var(--vp-c-note-1); }
+.vp-doc .custom-block.tip { --ipp-callout: var(--vp-c-tip-1); --ipp-callout-icon: var(--ipp-icon-tip); }
+.vp-doc .custom-block.important { --ipp-callout: var(--vp-c-important-1); --ipp-callout-icon: var(--ipp-icon-important); }
+.vp-doc .custom-block.warning { --ipp-callout: var(--vp-c-warning-1); --ipp-callout-icon: var(--ipp-icon-warning); }
+.vp-doc .custom-block.danger,
+.vp-doc .custom-block.caution { --ipp-callout: var(--vp-c-danger-1); --ipp-callout-icon: var(--ipp-icon-danger); }
+
+/* "WARNING" becomes "Warning" */
+.vp-doc .custom-block-title {
+ margin: 0 0 4px;
+ font-size: 15px;
+ font-weight: 600;
+ line-height: 24px;
+ color: var(--ipp-callout);
+ text-transform: lowercase;
+}
+
+.vp-doc .custom-block-title::first-letter {
+ text-transform: uppercase;
+}
+
+.vp-doc .custom-block-title::before {
+ content: '';
+ position: absolute;
+ top: 16px;
+ left: 16px;
+ width: 20px;
+ height: 20px;
+ background-color: var(--ipp-callout);
+ -webkit-mask: var(--ipp-callout-icon) center / contain no-repeat;
+ mask: var(--ipp-callout-icon) center / contain no-repeat;
+}
+
+.vp-doc .custom-block p {
+ margin: 4px 0 8px;
+}
+
+.vp-doc .custom-block code {
+ background-color: color-mix(in srgb, var(--ipp-callout) 10%, var(--vp-c-bg-soft));
+}
+
+:root {
+ --ipp-icon-note: url("data:image/svg+xml,");
+ --ipp-icon-tip: url("data:image/svg+xml,");
+ --ipp-icon-important: url("data:image/svg+xml,");
+ --ipp-icon-warning: url("data:image/svg+xml,");
+ --ipp-icon-danger: url("data:image/svg+xml,");
+}