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]

Reply via email to