potiuk opened a new pull request, #1742:
URL: https://github.com/apache/airflow-site/pull/1742
Upgrades the landing pages from Docsy 0.12.0 to 0.18.1 (latest), with Hugo
0.170.0 and
Dart Sass, keeping the site visually the same. Unlike #1443 (reverted in
#1456), the
sidebar and dark-mode issues are properly fixed rather than worked around.
What changed:
- Theme path `docsy` → `docsy/theme` (Docsy moved into a `theme/` folder);
submodule now
points at the new `docsy/docsy` repository; theme deps installed with
`npm run install:theme-deps`.
- CSS is built with Dart Sass. CI installs it as `dart-sass`, which Hugo
looks up before
`sass`, so the pure-JS `sass` that `yarn run` puts first on PATH can't
shadow it.
Hugo and Dart Sass downloads are SHA-256 verified. CI moves to Node 24
(Docsy requirement).
- Our Bootstrap overrides (no link underlines, palette, fonts, heading
sizes) now go
through Docsy's `_variables_project` hooks. They previously reached
Docsy's CSS only
because our `_variables.scss` / `_colors.scss` / `_search.scss` shadowed
Docsy's own
files — Docsy 0.14 namespaced those under `td/`, which silently dropped
them.
- Fonts stay self-hosted: Docsy now hard-codes a Google Fonts URL,
overridden in
`_variables_project_after_bs.scss`.
- Code highlighting keeps the tango/onedark styles the blog has been using
(Docsy
switched to friendly/native).
- Issue item 3: `td/code-dark` import replaced by `_code-highlighting.scss`,
no
`$enable-dark-mode` band-aid.
- Issue item 2: the `sidebar-tree.html` override is deleted — it was never
actually used
in production (Docsy's `_partials` copy won). Other legacy
`layouts/partials/` copies
were removed too: newer Hugo would have activated them (double `main.js`
load,
different favicons).
- jQuery is no longer loaded — nothing on the site uses it (checked
statically and by
clicking through the interactive parts with the console open).
- Hugo deprecations fixed (`hugo.Data`, `Language.Label`, imaging quality,
HTML content
allow-list): the build has zero warnings.
Verification:
- Local production build (`hugo` 0.170.0 + Dart Sass 1.108.2): 118 pages, 0
warnings,
0 errors — same page count as the 0.12 baseline.
- Full-page screenshots of 15 representative pages (home, blog list,
code-heavy posts,
docs, community, use cases, ecosystem, meetups, roadmap, announcements,
404) in light
and dark mode, pixel-diffed against the current build: most within
anti-aliasing noise.
Intended differences:
- `/blog/agentic-workloads-airflow-3/` and `/blog/airflow-3.2.0/`:
production's KaTeX
mangles a code block into math (and logs parse errors); now rendered
correctly.
- Use-case pages and some older blog posts now consistently use the site's
own pager
instead of Docsy's.
- No console errors on any page in the new build.
closes: #1413
---
##### Was generative AI tooling used to co-author this PR?
- [X] Yes — Claude Opus 5
Generated-by: Claude Opus 5
🤖 Generated with [Claude Code](https://claude.com/claude-code)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]