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,"); +}