hackertours/assets/css/fonts.css.tmpl
Vincent Mahnke e237cf2a06
All checks were successful
/ build (pull_request) Successful in 1m17s
/ accessibility (pull_request) Successful in 2m0s
fix: Avoids layout jitter while fonts load
The headings jumped when Jersey 10 arrived after the first paint: the monospace fallback is much wider, so the heading chips changed their width, and the page transition made it visible on every language switch. Reproduced with revalidated or slow fonts (hugo server sends no cache headers, so it revalidates them on every navigation) in Chromium, WebKit and, on cold loads, Firefox. In Safari the body text shifted as well, because its ui-monospace is the wider SF Mono.

- Embeds the Latin subset of Jersey 10 in the fonts stylesheet.
- Preloads Hack Regular and Bold.
- Generates the @font-face rules and the preload links from one fingerprinted template (assets/css/fonts.css.tmpl, head/fonts.html), so their URLs match and also work below a sub path like the PR previews.
- Drops ui-monospace and SF Mono from the body font stack: Menlo has the same width as Hack.

Frames with shifted elements while switching language on the tours page, with revalidated or slow fonts: 9 to 92 before, none after (Chromium and WebKit, desktop and mobile). Firefox cold loads: up to 48 before, none painted after. Rendering after loading is unchanged.

Trade-off: the first paint of a cold load on a slow connection (Slow 4G) is about 0.26 s later; later navigations are not affected.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-08 13:11:35 +01:00

60 lines
2.1 KiB
Go Template

{{- /* Rendered by layouts/_partials/head/fonts.html, which explains why. */ -}}
{{- $url := dict -}}
{{- range slice "Jersey10-latin-ext" "Hack-Regular" "Hack-Italic" "Hack-Bold" "Hack-BoldItalic" -}}
{{- $url = merge $url (dict . (resources.Get (printf "fonts/%s.woff2" .) | fingerprint).RelPermalink) -}}
{{- end -}}
{{- $jersey := (resources.Get "fonts/Jersey10-latin.woff2").Content | base64Encode -}}
/* 40C3 "MODEL_CITIZENS" styleguide fonts, self-hosted (SIL OFL / MIT, see static/fonts).
Jersey 10: headings. Hack: body text and subheads.
Hack is subset to Latin (Latin-1, Latin Extended-A, general punctuation). */
/* The Latin subset of Jersey 10 is embedded, so German and English headings are never drawn in the fallback font. */
@font-face {
font-family: 'Jersey 10';
src: url('data:font/woff2;base64,{{ $jersey }}') format('woff2');
font-weight: 400;
font-style: normal;
font-display: swap;
unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
}
@font-face {
font-family: 'Jersey 10';
src: url('{{ index $url "Jersey10-latin-ext" }}') format('woff2');
font-weight: 400;
font-style: normal;
font-display: swap;
unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C0, U+2113, U+2C60-2C7F, U+A720-A7FF;
}
@font-face {
font-family: 'Hack';
src: url('{{ index $url "Hack-Regular" }}') format('woff2');
font-weight: 400;
font-style: normal;
font-display: swap;
}
@font-face {
font-family: 'Hack';
src: url('{{ index $url "Hack-Italic" }}') format('woff2');
font-weight: 400;
font-style: italic;
font-display: swap;
}
@font-face {
font-family: 'Hack';
src: url('{{ index $url "Hack-Bold" }}') format('woff2');
font-weight: 700;
font-style: normal;
font-display: swap;
}
@font-face {
font-family: 'Hack';
src: url('{{ index $url "Hack-BoldItalic" }}') format('woff2');
font-weight: 700;
font-style: italic;
font-display: swap;
}