kaxil opened a new issue, #1413: URL: https://github.com/apache/airflow-site/issues/1413
The Docsy submodule (`landing-pages/site/themes/docsy`) is pinned to v0.12.0. The latest release is [v0.14.2](https://github.com/google/docsy/releases/tag/v0.14.2) ([upgrade guide](https://www.docsy.dev/blog/2026/0.14.0/)). ## Why upgrade - Bootstrap 5.3.6 → 5.3.8 - ScrollSpy TOC tracking - Better dark mode support - SCSS namespace cleanup (internal files moved under `td/`) - i18n improvements - Various navbar, sidebar, and layout fixes ## What needs to change ### 1. Hugo version bump (required) Docsy v0.14.0+ converted all i18n files from TOML to YAML. The YAML files contain bare `Yes`/`No` values (e.g. `feedback_positive: Yes`) which Hugo < 0.152.0 parses as booleans, causing build failure: ``` failed to load translations: unsupported file format bool ``` Hugo must be bumped from **0.146.0** to at least **0.152.0** in `.github/workflows/build.yml`. ### 2. `sidebar-tree.html` partial (required) Docsy v0.14.0 changed how `sidebar.html` calls `sidebar-tree.html`. Previously it passed the page context directly (`.`), now it passes a dict with `.context`, `.cacheSidebar`, `.sidebarRoot`, `.sidebarRootID`. Our custom `layouts/partials/sidebar-tree.html` assumes it receives the page directly. It needs to unwrap `.context` from the dict: ```go {{ $context := cond (isset . "context") .context . }} ``` Then use `$context` instead of `.` for `.FirstSection`, `.Permalink`, etc. ### 3. `$enable-dark-mode` SCSS variable (required) Our `main-custom.scss` imports `td/code-dark` from Docsy. In v0.14.2, that file wraps its content in `@if $enable-dark-mode { ... }`. This variable is defined by Bootstrap, but our custom SCSS pipeline doesn't import Bootstrap (it's compiled separately from Docsy's `main.scss`). Fix: add `$enable-dark-mode: true !default;` before the `@import "td/code-dark"` line in `main-custom.scss`. ### 4. Things that DON'T need changes - `.gitmodules` -- URL stays the same - `site.sh` -- build scripts unchanged - `config.toml` -- no config changes needed (site uses TOML, not YAML, so the yes/no token issue doesn't apply to our config) - Navbar -- we override with our own custom navbar, unaffected by Docsy's navbar refactor - `blocks/cover`, `td-offset-anchor`, Swagger UI -- not used -- 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]
