Files
pbakaus_impeccable/public/css/sub-pages.css
T
Paul Bakaus 88d647a555 Restructure /skills overview as a docs-browser layout
The old /skills was one long scrollable list. Replace it with a proper
app-shell layout: sticky left sidebar with every skill grouped by
category, main column on the right with an orientation piece (intro
+ 'how to pick one' callout + category sections with chip lists).

- scripts/build-sub-pages.js
  - renderSkillsSidebar(): the sticky left rail used across the /skills
    section. Takes an optional currentSkillId so we can mark the active
    skill with aria-current when detail pages adopt the same shell in a
    later commit
  - renderSkillsOverviewMain(): the right column. Editorial header,
    'how to pick one' callout that inlines 5 hot-link skill references,
    then one block per category (title, count, description, chip row
    of all skills in that category)
  - wrapInDocsLayout(): tiny helper that pastes the sidebar and main
    into a .skills-layout grid

- public/css/sub-pages.css
  - Copy .skip-link a11y styles over from main.css so the 'Skip to
    content' link is properly hidden until keyboard focus (was showing
    unstyled at the top-left of every generated page)
  - Add .skills-layout grid shell (260px sidebar + flex main column,
    max-width 1400px, clamp-based horizontal padding)
  - Add sticky .skills-sidebar with its own scroll-y overflow and a
    thin scrollbar; group titles + mono link list; aria-current styling
    with a 2px left accent bar
  - Add .skills-overview-howto callout, category sections with chip
    rows, and mobile collapse (sidebar becomes an inline block above
    the main column at <=920px)
  - Introduce --site-header-height and --skills-sidebar-width tokens

No detail page layout changes in this commit — those still use the
single-column .skill-detail shell.
2026-04-08 09:24:54 -07:00

920 lines
20 KiB
CSS

/*
* impeccable.style — shared styles for sub-pages and the site-wide header
*
* Imported by all generated pages under /skills, /anti-patterns, /tutorials,
* and by the hand-authored pages (index, cheatsheet, gallery, privacy) via
* a direct <link> tag so they all share the same header + prose typography.
*/
@import "./tokens.css";
/* ============================================
SKIP LINK (a11y)
============================================ */
.skip-link {
position: absolute;
top: -100%;
left: 50%;
transform: translateX(-50%);
z-index: 10000;
padding: var(--spacing-sm) var(--spacing-lg);
background: var(--color-ink);
color: var(--color-paper);
font-weight: 600;
text-decoration: none;
border-radius: 0 0 8px 8px;
transition: top 0.2s ease;
}
.skip-link:focus {
top: 0;
outline: 2px solid var(--color-accent);
outline-offset: 2px;
}
/* ============================================
BASE
============================================ */
html {
scroll-behavior: smooth;
}
body {
font-family: var(--font-body);
color: var(--color-ink);
background: var(--color-paper);
line-height: 1.6;
-webkit-font-smoothing: antialiased;
-moz-osx-font-smoothing: grayscale;
text-rendering: optimizeLegibility;
}
a {
color: inherit;
text-decoration: none;
}
/* ============================================
SHARED SITE HEADER
============================================ */
.site-header {
position: sticky;
top: 0;
z-index: 100;
display: flex;
align-items: center;
justify-content: space-between;
gap: var(--spacing-md);
padding: 14px clamp(var(--spacing-md), 4vw, var(--spacing-2xl));
background: color-mix(in oklch, var(--color-paper) 94%, transparent);
-webkit-backdrop-filter: saturate(1.4) blur(16px);
backdrop-filter: saturate(1.4) blur(16px);
border-bottom: 1px solid var(--color-mist);
}
/* Kill any inherited text-decoration from page-level `a` rules. */
.site-header a,
.site-header a:hover {
text-decoration: none;
text-decoration-thickness: 0;
}
.site-header-brand {
display: inline-flex;
align-items: center;
gap: 10px;
font-family: var(--font-display);
font-size: 1.25rem;
font-weight: 600;
letter-spacing: -0.01em;
color: var(--color-ink);
flex-shrink: 0;
transition: color var(--duration-fast) var(--ease-out);
}
.site-header-brand:hover {
color: var(--color-accent);
}
.site-header-brand-logo {
width: 26px;
height: 26px;
border-radius: 6px;
flex-shrink: 0;
}
.site-header-brand-name {
display: inline-block;
}
.site-header-right {
display: flex;
align-items: center;
gap: clamp(var(--spacing-sm), 2vw, var(--spacing-md));
min-width: 0;
}
.site-header-nav {
display: flex;
align-items: center;
gap: clamp(var(--spacing-sm), 2vw, var(--spacing-md));
font-family: var(--font-body);
font-size: 0.9375rem;
font-weight: 500;
min-width: 0;
}
.site-header-nav a {
position: relative;
display: inline-block;
white-space: nowrap;
color: var(--color-charcoal);
padding: 4px 0;
transition: color var(--duration-fast) var(--ease-out);
}
.site-header-nav a:hover {
color: var(--color-accent);
}
.site-header-nav a[aria-current="page"] {
color: var(--color-ink);
font-weight: 600;
}
.site-header-nav a[aria-current="page"]::after {
content: "";
position: absolute;
left: 0;
right: 0;
bottom: -4px;
height: 2px;
background: var(--color-accent);
border-radius: 2px;
}
/* GitHub star pill — subtle, inviting nudge without shouting */
.site-header-github {
display: inline-flex;
align-items: center;
gap: 6px;
padding: 4px 10px 4px 8px;
border-radius: 99px;
background: var(--color-cream);
border: 1px solid var(--color-mist);
font-family: var(--font-mono);
font-size: 0.8125rem;
font-weight: 500;
color: var(--color-charcoal);
flex-shrink: 0;
transition:
background var(--duration-fast) var(--ease-out),
border-color var(--duration-fast) var(--ease-out),
color var(--duration-fast) var(--ease-out);
}
.site-header-github svg {
width: 14px;
height: 14px;
flex-shrink: 0;
}
.site-header-github:hover {
background: var(--color-paper);
border-color: var(--color-ink);
color: var(--color-ink);
}
.site-header-github-star {
color: #f59e0b;
width: 12px;
height: 12px;
flex-shrink: 0;
}
@media (max-width: 820px) {
.site-header {
padding: 12px var(--spacing-md);
gap: var(--spacing-sm);
}
.site-header-brand {
font-size: 1.0625rem;
}
.site-header-brand-logo {
width: 22px;
height: 22px;
}
.site-header-right {
gap: var(--spacing-sm);
}
.site-header-nav {
font-size: 0.8125rem;
gap: var(--spacing-sm);
overflow-x: auto;
scrollbar-width: none;
-webkit-overflow-scrolling: touch;
/* fade the right edge so users see there's more to scroll */
mask-image: linear-gradient(to right, black 0%, black calc(100% - 24px), transparent 100%);
-webkit-mask-image: linear-gradient(to right, black 0%, black calc(100% - 24px), transparent 100%);
}
.site-header-nav::-webkit-scrollbar {
display: none;
}
.site-header-nav a[data-nav="home"] {
/* Brand already acts as home link on mobile */
display: none;
}
.site-header-github {
padding: 4px 8px;
}
.site-header-github-label {
display: none;
}
}
@media (max-width: 480px) {
.site-header-brand-name {
/* Logo alone on narrow screens */
display: none;
}
}
/* ============================================
SUB-PAGE LAYOUT SHELL
============================================ */
main#main {
display: block;
}
.sub-page-content,
.skill-detail {
max-width: 820px;
margin: 0 auto;
padding: clamp(2rem, 5vw, 4rem) clamp(1.25rem, 4vw, 2.5rem) 6rem;
}
.sub-page-header {
margin-bottom: clamp(2.5rem, 6vw, 4rem);
}
.sub-page-eyebrow {
font-family: var(--font-mono);
font-size: 0.75rem;
font-weight: 600;
text-transform: uppercase;
letter-spacing: 0.14em;
color: var(--color-accent);
margin-bottom: var(--spacing-sm);
}
.sub-page-title {
font-family: var(--font-display);
font-size: clamp(2.5rem, 6vw, 4.5rem);
font-weight: 400;
line-height: 1.05;
letter-spacing: -0.02em;
color: var(--color-ink);
margin-bottom: var(--spacing-md);
}
.sub-page-lede {
font-size: clamp(1.0625rem, 1.6vw, 1.25rem);
line-height: 1.55;
color: var(--color-charcoal);
max-width: 62ch;
}
/* ============================================
DOCS-BROWSER LAYOUT (used by /skills)
============================================ */
:root {
--site-header-height: 62px;
--skills-sidebar-width: 260px;
}
.skills-layout-page main#main {
/* Reset: the docs layout provides its own max-width container. */
max-width: none;
margin: 0;
padding: 0;
}
.skills-layout {
display: grid;
grid-template-columns: var(--skills-sidebar-width) minmax(0, 1fr);
gap: clamp(var(--spacing-lg), 4vw, var(--spacing-2xl));
max-width: var(--width-max);
margin: 0 auto;
padding: 0 clamp(1.25rem, 3vw, 2.5rem);
align-items: start;
}
/* ============================================
SIDEBAR
============================================ */
.skills-sidebar {
position: sticky;
top: var(--site-header-height);
align-self: start;
max-height: calc(100vh - var(--site-header-height));
overflow-y: auto;
padding: var(--spacing-lg) 0 var(--spacing-2xl);
border-right: 1px solid var(--color-mist);
scrollbar-width: thin;
scrollbar-color: var(--color-mist) transparent;
}
.skills-sidebar::-webkit-scrollbar {
width: 6px;
}
.skills-sidebar::-webkit-scrollbar-thumb {
background: var(--color-mist);
border-radius: 3px;
}
.skills-sidebar-inner {
padding-right: var(--spacing-md);
}
.skills-sidebar-label {
font-family: var(--font-mono);
font-size: 0.625rem;
font-weight: 600;
text-transform: uppercase;
letter-spacing: 0.14em;
color: var(--color-ash);
margin-bottom: var(--spacing-md);
padding-left: var(--spacing-sm);
}
.skills-sidebar-group {
margin-bottom: var(--spacing-lg);
}
.skills-sidebar-group-title {
font-family: var(--font-body);
font-size: 0.6875rem;
font-weight: 600;
text-transform: uppercase;
letter-spacing: 0.1em;
color: var(--color-ink);
margin-bottom: 6px;
padding: 0 var(--spacing-sm);
}
.skills-sidebar-list {
list-style: none;
padding: 0;
margin: 0;
}
.skills-sidebar-list li {
margin: 0;
}
.skills-sidebar-list a {
display: block;
padding: 6px var(--spacing-sm);
font-family: var(--font-mono);
font-size: 0.8125rem;
font-weight: 500;
color: var(--color-charcoal);
text-decoration: none;
border-radius: 4px;
transition: color var(--duration-fast) var(--ease-out),
background var(--duration-fast) var(--ease-out);
}
.skills-sidebar-list a:hover {
color: var(--color-accent);
background: var(--color-cream);
}
.skills-sidebar-list a[aria-current="page"] {
color: var(--color-ink);
font-weight: 600;
background: var(--color-cream);
box-shadow: inset 2px 0 0 var(--color-accent);
}
/* ============================================
OVERVIEW MAIN CONTENT
============================================ */
.skills-main {
min-width: 0;
padding: clamp(2rem, 4vw, 3.5rem) 0 clamp(4rem, 8vw, 6rem);
}
.skills-overview-content {
max-width: 720px;
}
.skills-overview-header {
margin-bottom: clamp(2.5rem, 5vw, 4rem);
}
.skills-overview-header .sub-page-lede a {
color: var(--color-ink);
text-decoration: underline;
text-decoration-thickness: 1px;
text-decoration-color: var(--color-accent);
text-underline-offset: 4px;
font-family: var(--font-mono);
font-weight: 500;
}
.skills-overview-howto {
padding: var(--spacing-lg) var(--spacing-lg);
background: var(--color-cream);
border: 1px solid var(--color-mist);
border-radius: 10px;
margin-bottom: clamp(2.5rem, 5vw, 4rem);
}
.skills-overview-howto-title {
font-family: var(--font-display);
font-size: 1.25rem;
font-style: italic;
font-weight: 500;
color: var(--color-ink);
margin-bottom: var(--spacing-sm);
}
.skills-overview-howto p {
font-size: 0.9375rem;
line-height: 1.7;
color: var(--color-charcoal);
max-width: 60ch;
}
.skills-overview-howto a {
color: var(--color-ink);
font-family: var(--font-mono);
font-size: 0.875em;
font-weight: 500;
text-decoration: none;
border-bottom: 1px solid var(--color-accent);
transition: color var(--duration-fast) var(--ease-out);
}
.skills-overview-howto a:hover {
color: var(--color-accent);
}
.skills-overview-categories {
display: flex;
flex-direction: column;
gap: clamp(2rem, 4vw, 3rem);
}
.skills-overview-category {
padding-bottom: clamp(2rem, 4vw, 2.5rem);
border-bottom: 1px solid var(--color-mist);
}
.skills-overview-category:last-child {
border-bottom: none;
}
.skills-overview-category-meta {
display: flex;
align-items: baseline;
justify-content: space-between;
gap: var(--spacing-md);
margin-bottom: 6px;
}
.skills-overview-category-title {
font-family: var(--font-display);
font-size: clamp(1.5rem, 3vw, 2rem);
font-weight: 500;
font-style: italic;
color: var(--color-ink);
letter-spacing: -0.01em;
}
.skills-overview-category-count {
font-family: var(--font-mono);
font-size: 0.6875rem;
font-weight: 600;
text-transform: uppercase;
letter-spacing: 0.12em;
color: var(--color-ash);
}
.skills-overview-category-desc {
font-size: 0.9375rem;
line-height: 1.7;
color: var(--color-charcoal);
max-width: 58ch;
margin-bottom: var(--spacing-md);
}
.skills-overview-chips {
display: flex;
flex-wrap: wrap;
gap: 8px;
}
.skills-overview-chip {
display: inline-flex;
align-items: center;
padding: 6px 12px;
font-family: var(--font-mono);
font-size: 0.8125rem;
font-weight: 500;
color: var(--color-ink);
background: var(--color-paper);
border: 1px solid var(--color-mist);
border-radius: 99px;
text-decoration: none;
transition: border-color var(--duration-fast) var(--ease-out),
color var(--duration-fast) var(--ease-out),
background var(--duration-fast) var(--ease-out);
}
.skills-overview-chip:hover {
color: var(--color-accent);
border-color: var(--color-accent);
background: var(--color-cream);
}
/* ============================================
MOBILE: collapse sidebar into inline block
============================================ */
@media (max-width: 920px) {
.skills-layout {
grid-template-columns: 1fr;
gap: 0;
}
.skills-sidebar {
position: static;
max-height: none;
overflow: visible;
border-right: none;
border-bottom: 1px solid var(--color-mist);
padding: var(--spacing-md) 0 var(--spacing-lg);
margin-bottom: var(--spacing-lg);
}
.skills-sidebar-inner {
padding-right: 0;
}
.skills-sidebar-group {
margin-bottom: var(--spacing-md);
}
}
/* ============================================
SKILL DETAIL
============================================ */
.skill-detail-header {
margin-bottom: clamp(2.5rem, 5vw, 3.5rem);
}
.skill-detail-eyebrow {
font-family: var(--font-mono);
font-size: 0.75rem;
font-weight: 500;
text-transform: uppercase;
letter-spacing: 0.12em;
color: var(--color-ash);
margin-bottom: var(--spacing-sm);
}
.skill-detail-eyebrow a {
color: inherit;
text-decoration: none;
}
.skill-detail-eyebrow a:hover {
color: var(--color-accent);
}
.skill-detail-title {
font-family: var(--font-mono);
font-size: clamp(2.25rem, 5vw, 3.5rem);
font-weight: 600;
letter-spacing: -0.02em;
color: var(--color-ink);
margin-bottom: var(--spacing-sm);
}
.skill-detail-tagline {
font-family: var(--font-display);
font-size: clamp(1.125rem, 2vw, 1.5rem);
font-style: italic;
font-weight: 400;
color: var(--color-charcoal);
line-height: 1.4;
max-width: 58ch;
margin-bottom: var(--spacing-md);
}
.skill-meta-strip {
display: flex;
flex-wrap: wrap;
gap: 8px;
margin-top: var(--spacing-sm);
}
.skill-meta-chip {
display: inline-flex;
align-items: center;
font-family: var(--font-mono);
font-size: 0.6875rem;
font-weight: 600;
text-transform: uppercase;
letter-spacing: 0.08em;
padding: 4px 10px;
border-radius: 99px;
background: var(--color-cream);
border: 1px solid var(--color-mist);
color: var(--color-charcoal);
}
.skill-meta-category[data-category="create"] {
background: var(--cat-create-bg);
border-color: var(--cat-create-border);
color: var(--cat-create-text);
}
.skill-meta-category[data-category="evaluate"] {
background: var(--cat-evaluate-bg);
border-color: var(--cat-evaluate-border);
color: var(--cat-evaluate-text);
}
.skill-meta-category[data-category="refine"] {
background: var(--cat-refine-bg);
border-color: var(--cat-refine-border);
color: var(--cat-refine-text);
}
.skill-meta-category[data-category="simplify"] {
background: var(--cat-simplify-bg);
border-color: var(--cat-simplify-border);
color: var(--cat-simplify-text);
}
.skill-meta-category[data-category="harden"] {
background: var(--cat-harden-bg);
border-color: var(--cat-harden-border);
color: var(--cat-harden-text);
}
.skill-meta-category[data-category="system"] {
background: var(--cat-system-bg);
border-color: var(--cat-system-border);
color: var(--cat-system-text);
}
.skill-meta-args {
font-family: var(--font-mono);
text-transform: none;
letter-spacing: 0;
font-weight: 500;
}
.skill-detail-editorial {
margin-bottom: clamp(3rem, 6vw, 4.5rem);
}
.skill-detail-divider {
display: flex;
align-items: center;
gap: var(--spacing-md);
margin: clamp(3rem, 6vw, 4.5rem) 0 clamp(2rem, 4vw, 3rem);
}
.skill-detail-divider::before,
.skill-detail-divider::after {
content: "";
flex: 1;
height: 1px;
background: var(--color-mist);
}
.skill-detail-divider span {
font-family: var(--font-mono);
font-size: 0.6875rem;
font-weight: 600;
text-transform: uppercase;
letter-spacing: 0.14em;
color: var(--color-ash);
flex-shrink: 0;
}
.skill-references {
margin-top: clamp(3rem, 6vw, 4.5rem);
padding-top: clamp(2rem, 4vw, 3rem);
border-top: 1px solid var(--color-mist);
}
.skill-references-heading {
font-family: var(--font-display);
font-size: 1.5rem;
font-style: italic;
font-weight: 500;
color: var(--color-ink);
margin-bottom: var(--spacing-md);
}
.skill-reference {
border-top: 1px solid var(--color-mist);
}
.skill-reference:last-child {
border-bottom: 1px solid var(--color-mist);
}
.skill-reference > summary {
list-style: none;
cursor: pointer;
padding: 16px 0;
display: flex;
align-items: center;
gap: var(--spacing-md);
transition: color var(--duration-fast) var(--ease-out);
}
.skill-reference > summary::-webkit-details-marker {
display: none;
}
.skill-reference > summary::before {
content: "+";
flex-shrink: 0;
width: 18px;
font-family: var(--font-display);
font-size: 1.5rem;
color: var(--color-accent);
line-height: 1;
transition: transform var(--duration-base) var(--ease-out);
}
.skill-reference[open] > summary::before {
transform: rotate(45deg);
}
.skill-reference > summary:hover {
color: var(--color-accent);
}
.skill-reference-label {
font-family: var(--font-mono);
font-size: 0.6875rem;
font-weight: 600;
text-transform: uppercase;
letter-spacing: 0.12em;
color: var(--color-ash);
flex-shrink: 0;
}
.skill-reference-title {
font-family: var(--font-display);
font-size: 1.125rem;
font-style: italic;
color: var(--color-ink);
}
.skill-reference-body {
padding: var(--spacing-sm) 0 var(--spacing-md) 34px;
max-width: 62ch;
}
/* ============================================
PROSE — rendered markdown bodies
============================================ */
.prose {
font-size: 1rem;
line-height: 1.7;
color: var(--color-charcoal);
max-width: 65ch;
}
.prose h1,
.prose h2,
.prose h3,
.prose h4 {
color: var(--color-ink);
font-weight: 600;
line-height: 1.25;
margin-top: 2em;
margin-bottom: 0.6em;
}
.prose h1 { font-family: var(--font-display); font-size: 1.875rem; font-weight: 500; font-style: italic; }
.prose h2 { font-family: var(--font-display); font-size: 1.5rem; font-weight: 500; font-style: italic; margin-top: 2.2em; }
.prose h3 { font-size: 1.125rem; margin-top: 1.8em; }
.prose h4 { font-size: 1rem; }
.prose h2:first-child,
.prose h3:first-child {
margin-top: 0;
}
.prose p {
margin-top: 0;
margin-bottom: 1.1em;
}
.prose ul,
.prose ol {
margin: 0 0 1.2em 0;
padding-left: 1.25rem;
}
.prose li {
margin-bottom: 0.4em;
}
.prose a {
color: var(--color-accent);
text-decoration: underline;
text-decoration-thickness: 1px;
text-underline-offset: 3px;
text-decoration-color: var(--color-accent-dim);
transition: text-decoration-color var(--duration-fast) var(--ease-out);
}
.prose a:hover {
text-decoration-color: var(--color-accent);
}
.prose strong {
color: var(--color-ink);
font-weight: 600;
}
.prose em {
font-style: italic;
}
.prose code {
font-family: var(--font-mono);
font-size: 0.875em;
background: var(--color-cream);
border: 1px solid var(--color-mist);
padding: 2px 6px;
border-radius: 4px;
color: var(--color-ink);
}
.prose .code-block {
margin: 1.25em 0;
padding: var(--spacing-md);
background: oklch(12% 0.005 350);
color: oklch(92% 0.005 350);
border-radius: 10px;
overflow-x: auto;
font-family: var(--font-mono);
font-size: 0.8125rem;
line-height: 1.55;
border: 1px solid oklch(20% 0.005 350);
}
.prose .code-block code {
background: transparent;
border: none;
padding: 0;
color: inherit;
font-size: inherit;
}
.prose blockquote {
margin: 1.5em 0;
padding: 0 0 0 var(--spacing-md);
border-left: 3px solid var(--color-mist);
color: var(--color-ash);
font-style: italic;
}
.prose hr {
border: none;
height: 1px;
background: var(--color-mist);
margin: 2.5em 0;
}