docs: self-host fonts, eliminate layout shift, add SPA navigation#534

Merged

tony merged 22 commits intomasterfrom

Mar 14, 2026

Commits on Mar 14, 2026

docs(style[toc,body]): refine right-panel TOC and body typography
tony
committed
docs(style[toc,content]): flexible TOC width with inner-panel padding
tony
committed
docs(style[toc]): increase TOC font size from 81.25% to 87.5%
tony
committed
docs(style[headings]): refine heading hierarchy — scale, spacing, eyebrow labels
tony
committed
docs(fonts): self-host IBM Plex via Fontsource CDN
tony
committed
docs(fonts[css]): fix variable specificity — use body instead of :root
tony
committed
docs(fonts[preload]): add <link rel="preload"> for critical font weights
tony
committed
docs(fonts[css]): add kerning, ligatures, and code rendering overrides
tony
committed
docs(images[cls]): prevent layout shift and add non-blocking loading
tony
committed
docs(nav[spa]): add SPA-like navigation to avoid full page reloads
tony
committed
docs(fonts[fallback]): add fallback font metrics to eliminate FOUT reflow
tony
committed
docs(images[badges]): add placeholder sizing for external badge images
tony
committed
docs(sidebar[projects]): prevent active link flash with visibility gate
tony
committed
docs(nav[spa]): wrap DOM swap in View Transitions API for smooth crossfade
tony
committed
docs(css[structure]): move view transitions section after image rules
tony
committed
docs(fonts[loading]): switch to font-display block with inline CSS
tony
committed
docs(fonts[lint]): add docstrings to sphinx_fonts extension
tony
committed
test(docs[sphinx_fonts]): add tests for sphinx_fonts extension
tony
committed
test(docs[sphinx_fonts]): fix ruff lint errors in test_sphinx_fonts
tony
committed
test(docs[sphinx_fonts]): apply ruff format to test_sphinx_fonts
tony
committed
test(docs[sphinx_fonts]): remove type: ignore comments for mypy compat
tony
committed
pyproject(mypy): add sphinx_fonts to ignore_missing_imports
tony
committed