Skip to content

fix: prevent documentation font shifts - #30

Merged
jlc488 merged 1 commit into
mainfrom
fix/docs-atomic-font-loading
Oct 29, 2026
Merged

jlc488 merged 1 commit into
mainfrom
fix/docs-atomic-font-loading

Conversation

@jlc488

@jlc488 jlc488 commented Oct 29, 2026

Copy link
Copy Markdown
Collaborator

When documentation fonts load after the first text, headings and paragraphs change width (up to 39.125px in the observed production page). Keep Inter and JetBrains Mono while serving verified complete upstream variable fonts from the documentation site, with one matching Inter preload and optional display so a slow download keeps the first rendered fallback for that navigation.

Disable Material's external Google Fonts loader. Preserve normal/italic weights, the existing system fallback stacks, publisher attribution, metadata and theme styling. Content-hashed asset names and unchanged OFL1.1 licenses/provenance accompany the unmodified upstream files; no local font source or Unicode subset can change selection by installed fonts or individual glyph chunks. The four font files total 1,352,248 bytes; only normal Inter is preloaded. Slow visits may retain system fonts until the next navigation.

Validation:

  • mkdocs build --strict passed before and after the change; existing informational documentation-anchor messages are unchanged.
  • Existing npm run check --prefix tools/publisher passed. No dependency/lock changes.
  • 1440/320/375px cold/warm/slow, with and without local font sources: 18 English cases; Korean slow/local-disabled: 3 cases. All200/fonts-ready, no overflow, zero observed first-to-final text Range width/x/y changes.
  • Generated English/Korean/nested/404 pages each have one valid local-font preload; asset bytes/SHA256 match verified official upstream files.
  • Independent source review found no blocking issue. No Java or security/authentication behavior changed.

GitHub Pages deployment is left to the existing main-branch workflow after coordinated merge.

@jlc488
jlc488 marked this pull request as ready for review October 29, 2026 07:31
@jlc488
jlc488 merged commit 3270a9b into main Oct 29, 2026
2 checks passed
@jlc488
jlc488 deleted the fix/docs-atomic-font-loading branch October 29, 2026 07:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant