Repository navigation
Lighter navigation and assets, accessibility, header height variable, inline_styles option and CSS check - #4
Merged
Conversation
Sub-sections and pages are merged and sorted in a single expression (instead of merging an array at each iteration), and the ancestors ids of the current page are computed once for the whole sidebar. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
`apiKey` and `indexName` are also required: otherwise the header displayed an empty DocSearch container instead of falling back to FlexSearch. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
`--spacing-header` and `--spacing-header-offset` (`h-header`, `mt-header`, `scroll-pt-header-offset` utilities) replace hardcoded values, and tocbot reads its offset from the scroll padding. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- `inline_styles` (default: true) to load stylesheets with `<link>` in production, so they can be cached by the browser across pages - `styles_extra` of a template extending the docs layout is no longer overwritten - document `styles_extra` and the `styles` block Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Navigating on the change of a `<select>` is not accessible (WCAG 3.2.2): the selector is now a `<details>` dropdown of links (`hreflang`, `lang`, current language marked with `aria-current`), closed on outside click or Escape key, and an inline list in the sidebar. The `language_cookie` option still works. BREAKING CHANGE: the global `switchLanguage()` function and the `formselect` and `selector` utilities are removed. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
"Dark theme" toggle button with `aria-pressed`, instead of a "Change theme color" button without state. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ut waiting for load The ToC is computed once, outside of any block, and tocbot (stylesheet and script) is loaded only if it is not empty. Heading anchors are added as soon as the script runs, instead of waiting for all images to be loaded. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Already displayed in the page footer. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Light and dark `theme-color` from the `manifest` options, unless the PWA component theme is installed (it outputs them). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
`collapseDepth: 3`: the nested headings are no longer collapsed until their section is active (default behavior of tocbot, active since its stylesheet is loaded). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The `manifest` and `serviceworker` options at the root of the configuration are deprecated since the PWA component theme 3.0. Without it, the `theme-color` meta tags are output from `pwa.manifest` (detected by its `manifest` page). BREAKING CHANGE: requires the PWA component theme 3.x (2.x reads the root options). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The modal colors are set with the DocSearch variables (`:root.dark` overrides its dark variables), instead of overriding its classes. In the dark theme, the highlight color (hit source, matches, cancel button) is now readable and the backgrounds follow the theme palette. Only the selected hit background and the search box text are still set with classes (no dedicated variable). Tested with the statidocs.cecil.app index: light theme unchanged (pixel identical). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Changes
Navigation and assets
merge/filter/sort_by_weightexpression instead of merging an array at each iteration; the ancestors ids of the current page are computed once for the whole sidebar.collapseDepth: 3), nested headings are no longer collapsed until their section is active.loadevent).Accessibility
<select onchange>(navigation on change is not accessible, WCAG 3.2.2) is replaced by a<details>dropdown of links (hreflang,lang, current language marked witharia-current), closed on outside click or Escape key (focus back on its button); inline list in the mobile sidebar. Thelanguage_cookieoption still works.aria-pressed(was "Change theme color", without state). French translation updated (.poand.mo).Layouts
apiKeyandindexNameare also required). Before, a missingapiKeydisplayed an empty DocSearch container instead of falling back to FlexSearch.--spacing-header,--spacing-header-offset→h-header,mt-header,scroll-pt-header-offset); tocbot reads its offset from the scroll padding instead of a hardcoded70.inline_stylesoption (default:true, unchanged behavior): set it tofalseto load stylesheets with<link>in production, so they are cached by the browser across pages.styles_extra: no longer overwritten bydocs/page.html.twigwhen a template extends it; documented in the README, with thestylesblock.theme-color: light and dark meta tags from thepwa.manifestoptions, unless the PWA component theme is installed (detected by itsmanifestpage, it outputs them).pwakey (rootmanifestandserviceworkerare deprecated since the PWA component theme 3.0).CI
Check CSSworkflow, failing ifassets/styles.cssis not up to date with its sources.Breaking changes
switchLanguage()function is removed (templates overriding the theme and calling it must be updated).formselectandselectorCSS utilities are removed.Tests
docs/getting-started/,docs/faq/), not on the others (docs/,docs/guides/).<link>withinline_styles: false.aria-pressedupdated by the theme toggle.theme-colormeta tags output once (by the PWA theme), manifest colors from the theme options, no deprecation warning.🤖 Generated with Claude Code