feat: enhance user experience with custom 404 page, breadcrumbs, and mobile ToC; add callout styles and language labels
This commit is contained in:
interlope committed
1 parent
deba0bf3f9
commit
72a45c1b7f
6 files changed
+420
-84
No files matched your search
+214
-63
@@ -1718,82 +1718,67 @@ footer.footer-modern a:hover {
|
||||
}
|
||||
|
||||
/* ========================================
|
||||
COPY-TO-CLIPBOARD ON CODE BLOCKS
|
||||
CODE BLOCKS — header bar (language label + copy button)
|
||||
======================================== */
|
||||
.code-block {
|
||||
position: relative;
|
||||
margin: var(--space-md) 0;
|
||||
border: 1px solid var(--border-color);
|
||||
border-radius: var(--radius-sm);
|
||||
overflow: hidden;
|
||||
}
|
||||
|
||||
/* The frame is owned by .code-block, so the inner <pre> drops its own */
|
||||
.code-block pre {
|
||||
margin: 0;
|
||||
border: none;
|
||||
border-radius: 0;
|
||||
}
|
||||
|
||||
.code-header {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: space-between;
|
||||
gap: 0.5rem;
|
||||
padding: 0.3rem 0.5rem 0.3rem 0.9rem;
|
||||
background: var(--bg-subtle);
|
||||
border-bottom: 1px solid var(--border-color);
|
||||
}
|
||||
|
||||
.code-lang {
|
||||
font-size: var(--font-size-xs);
|
||||
font-weight: 600;
|
||||
text-transform: uppercase;
|
||||
letter-spacing: 0.05em;
|
||||
color: var(--text-muted);
|
||||
font-family: var(--font-sans);
|
||||
}
|
||||
|
||||
.code-copy {
|
||||
position: absolute;
|
||||
top: 0.5rem;
|
||||
right: 0.5rem;
|
||||
z-index: 2;
|
||||
width: 32px;
|
||||
height: 32px;
|
||||
padding: 0;
|
||||
display: grid;
|
||||
place-items: center;
|
||||
border: 1px solid var(--border-color);
|
||||
border-radius: var(--radius-sm);
|
||||
background: var(--bg-subtle);
|
||||
color: var(--text-secondary);
|
||||
cursor: pointer;
|
||||
opacity: 0;
|
||||
transition: opacity 0.15s ease, color 0.15s ease, background 0.15s ease, border-color 0.15s ease;
|
||||
}
|
||||
|
||||
.code-block:hover .code-copy,
|
||||
.code-copy:focus {
|
||||
opacity: 1;
|
||||
}
|
||||
|
||||
.code-copy:hover {
|
||||
color: var(--text-primary);
|
||||
border-color: var(--accent);
|
||||
}
|
||||
|
||||
.code-copy.is-copied {
|
||||
opacity: 1;
|
||||
color: var(--accent-contrast);
|
||||
background: var(--accent);
|
||||
border-color: var(--accent);
|
||||
}
|
||||
|
||||
.code-copy svg {
|
||||
display: block;
|
||||
}
|
||||
|
||||
/* "Copied" toast — pops up just left of the button */
|
||||
.code-copy-toast {
|
||||
position: absolute;
|
||||
top: 0.5rem;
|
||||
right: calc(0.5rem + 32px + 8px); /* clears the 32px button + gap */
|
||||
height: 32px;
|
||||
display: flex;
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
padding: 0 0.6rem;
|
||||
gap: 0.35rem;
|
||||
padding: 0.25rem 0.6rem;
|
||||
border: 1px solid transparent;
|
||||
border-radius: var(--radius-sm);
|
||||
background: var(--accent);
|
||||
color: var(--accent-contrast);
|
||||
background: transparent;
|
||||
color: var(--text-secondary);
|
||||
font-size: var(--font-size-xs);
|
||||
font-weight: 600;
|
||||
white-space: nowrap;
|
||||
pointer-events: none;
|
||||
opacity: 0;
|
||||
transform: translateX(6px);
|
||||
transition: opacity 0.15s ease, transform 0.15s ease;
|
||||
font-family: var(--font-sans);
|
||||
cursor: pointer;
|
||||
transition: color 0.15s ease, background 0.15s ease, border-color 0.15s ease;
|
||||
}
|
||||
|
||||
.code-copy-toast.is-visible {
|
||||
opacity: 1;
|
||||
transform: translateX(0);
|
||||
.code-copy:hover { color: var(--text-primary); background: var(--bg-hover); }
|
||||
|
||||
.code-copy.is-copied {
|
||||
color: var(--accent-contrast);
|
||||
background: var(--accent);
|
||||
border-color: var(--accent);
|
||||
}
|
||||
|
||||
/* Touch devices have no hover — keep the button discoverable */
|
||||
@media (hover: none) {
|
||||
.code-copy { opacity: 0.7; }
|
||||
}
|
||||
.code-copy svg { display: block; }
|
||||
.code-copy-label { line-height: 1; }
|
||||
|
||||
/* ========================================
|
||||
GPU HINTS — promote animated layers ahead of time
|
||||
@@ -2086,6 +2071,172 @@ button:focus:not(:focus-visible) {
|
||||
line-height: 1.3;
|
||||
}
|
||||
|
||||
/* ========================================
|
||||
CALLOUTS / ADMONITIONS (> [!NOTE] etc.)
|
||||
======================================== */
|
||||
.callout {
|
||||
margin: var(--space-md) 0;
|
||||
padding: var(--space-sm) var(--space-md);
|
||||
border-left: 4px solid var(--cl-color, var(--accent));
|
||||
border-radius: var(--radius-sm);
|
||||
background: var(--cl-bg, var(--bg-subtle));
|
||||
color: var(--text-primary);
|
||||
font-style: normal;
|
||||
}
|
||||
|
||||
.callout > :last-child { margin-bottom: 0; }
|
||||
|
||||
.callout-title {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 0.45rem;
|
||||
margin-bottom: 0.4rem;
|
||||
font-weight: 700;
|
||||
color: var(--cl-color, var(--accent));
|
||||
}
|
||||
|
||||
.callout-icon { flex: 0 0 auto; }
|
||||
|
||||
.callout-note { --cl-color: #3b82f6; --cl-bg: rgba(59, 130, 246, 0.08); }
|
||||
.callout-tip { --cl-color: #22c55e; --cl-bg: rgba(34, 197, 94, 0.08); }
|
||||
.callout-important { --cl-color: #a855f7; --cl-bg: rgba(168, 85, 247, 0.08); }
|
||||
.callout-warning { --cl-color: #f59e0b; --cl-bg: rgba(245, 158, 11, 0.10); }
|
||||
.callout-caution { --cl-color: #ef4444; --cl-bg: rgba(239, 68, 68, 0.09); }
|
||||
|
||||
/* ========================================
|
||||
BREADCRUMBS
|
||||
======================================== */
|
||||
.breadcrumbs {
|
||||
display: flex;
|
||||
flex-wrap: wrap;
|
||||
align-items: center;
|
||||
gap: 0.35rem;
|
||||
margin-bottom: var(--space-sm);
|
||||
font-size: var(--font-size-sm);
|
||||
color: var(--text-muted);
|
||||
}
|
||||
|
||||
.breadcrumbs a { color: var(--text-secondary); }
|
||||
.breadcrumbs a:hover { color: var(--accent); text-decoration: none; }
|
||||
.breadcrumb-sep { color: var(--text-muted); }
|
||||
.breadcrumb-current {
|
||||
color: var(--text-muted);
|
||||
max-width: 50ch;
|
||||
overflow: hidden;
|
||||
text-overflow: ellipsis;
|
||||
white-space: nowrap;
|
||||
}
|
||||
|
||||
/* ========================================
|
||||
CUSTOM 404
|
||||
======================================== */
|
||||
.page-404 .error-body {
|
||||
text-align: center;
|
||||
padding: var(--space-xl) var(--space-md);
|
||||
}
|
||||
|
||||
.error-code {
|
||||
margin: 0;
|
||||
font-size: 5rem;
|
||||
font-weight: 800;
|
||||
line-height: 1;
|
||||
color: var(--accent);
|
||||
}
|
||||
|
||||
.error-text { color: var(--text-secondary); margin-bottom: var(--space-lg); }
|
||||
.error-search { max-width: 420px; margin: 0 auto var(--space-lg); }
|
||||
.error-home { display: inline-flex; align-items: center; gap: 0.4rem; }
|
||||
|
||||
/* ========================================
|
||||
FIGURES (image + caption)
|
||||
======================================== */
|
||||
.content figure,
|
||||
.content-figure {
|
||||
margin: var(--space-md) 0;
|
||||
text-align: center;
|
||||
}
|
||||
|
||||
.content figcaption,
|
||||
.content-figure figcaption {
|
||||
margin-top: 0.5rem;
|
||||
font-size: var(--font-size-sm);
|
||||
font-style: italic;
|
||||
color: var(--text-muted);
|
||||
}
|
||||
|
||||
/* ========================================
|
||||
MOBILE TABLE OF CONTENTS (floating button + drawer)
|
||||
======================================== */
|
||||
.toc-fab {
|
||||
position: fixed;
|
||||
left: 1.5rem;
|
||||
bottom: 1.5rem;
|
||||
z-index: 1035;
|
||||
width: 44px;
|
||||
height: 44px;
|
||||
display: grid;
|
||||
place-items: center;
|
||||
border: none;
|
||||
border-radius: 50%;
|
||||
background: var(--accent);
|
||||
color: var(--accent-contrast);
|
||||
box-shadow: var(--shadow-md);
|
||||
cursor: pointer;
|
||||
}
|
||||
|
||||
.toc-fab svg { display: block; }
|
||||
|
||||
.toc-drawer {
|
||||
position: fixed;
|
||||
inset: 0;
|
||||
z-index: 2000;
|
||||
display: flex;
|
||||
align-items: flex-end;
|
||||
background: rgba(0, 0, 0, 0.5);
|
||||
opacity: 0;
|
||||
visibility: hidden;
|
||||
transition: opacity 0.2s ease, visibility 0s linear 0.2s;
|
||||
}
|
||||
|
||||
.toc-drawer.is-open {
|
||||
opacity: 1;
|
||||
visibility: visible;
|
||||
transition: opacity 0.2s ease;
|
||||
}
|
||||
|
||||
.toc-drawer-panel {
|
||||
width: 100%;
|
||||
max-height: 70vh;
|
||||
overflow-y: auto;
|
||||
padding: var(--space-lg);
|
||||
background: var(--bg-surface);
|
||||
border-top-left-radius: var(--radius-lg);
|
||||
border-top-right-radius: var(--radius-lg);
|
||||
transform: translateY(100%);
|
||||
transition: transform 0.25s ease;
|
||||
}
|
||||
|
||||
.toc-drawer.is-open .toc-drawer-panel { transform: translateY(0); }
|
||||
|
||||
.toc-drawer-title {
|
||||
margin-bottom: var(--space-sm);
|
||||
font-size: var(--font-size-xs);
|
||||
font-weight: 700;
|
||||
text-transform: uppercase;
|
||||
letter-spacing: 0.08em;
|
||||
color: var(--text-muted);
|
||||
}
|
||||
|
||||
.toc-drawer .toc-list { list-style: none; padding: 0; margin: 0; }
|
||||
.toc-drawer .toc-link { display: block; padding: 0.5rem 0; color: var(--text-secondary); }
|
||||
.toc-drawer .toc-link:hover { color: var(--accent); text-decoration: none; }
|
||||
|
||||
/* The sidebar ToC covers desktop, so the floating button is mobile-only */
|
||||
@media (min-width: 768px) {
|
||||
.toc-fab,
|
||||
.toc-drawer { display: none !important; }
|
||||
}
|
||||
|
||||
/* ========================================
|
||||
RESPONSIVE
|
||||
======================================== */
|
||||
|
||||
Reference in new issue
Block a user