Skip to content

fix: configure the atelier format instead of replacing it - #162

Merged
mcanouil merged 1 commit into
mainfrom
fix/atelier-format
Jul 26, 2026
Merged

fix: configure the atelier format instead of replacing it#162
mcanouil merged 1 commit into
mainfrom
fix/atelier-format

Conversation

@mcanouil

Copy link
Copy Markdown
Owner

The navbar tooltips never appeared, and none of the other atelier scripts did either.

docs/_quarto.yml declared format: html, which replaces the atelier-html format contributed by the project type rather than configuring it. Every formats.html contribution was dropped, with no warning at render time: the skip link, focus-ring and other accessibility fixes, the external-link treatment, the ordinal dates and the navbar tooltips were never injected, lang fell back to en from en-GB, and the extension stylesheet only came back because it was listed by an explicit path into _extensions/.

Declaring atelier-html restores all of it. The format supplies its own stylesheet again, so the hardcoded path can go, while the project stylesheet still comes last and wins the cascade.

Verified in the rendered output: all five scripts are injected, lang="en-GB", the dark syntax-highlighting stylesheet is linked, tippy is loaded, and the colour-scheme toggle carries the title the tooltip binds to.

The project declared `format: html`, which replaced the `atelier-html`
format set by the project type rather than configuring it. Every format
contribution was dropped without a warning: the skip link, focus ring,
external-link, ordinal-date and navbar-tooltip scripts were never
injected, the language fell back to `en` from `en-GB`, and the extension
stylesheet had to be listed by path to come back at all.

Declare `atelier-html` instead. The format supplies its own stylesheet
again, so the hardcoded path into the extension can go, and the project
layer still wins the cascade.
@mcanouil mcanouil added the Type: Bug 🐛 Issues related to bugs, errors, or mistakes label Jul 26, 2026
@mcanouil mcanouil self-assigned this Jul 26, 2026
@mcanouil
mcanouil enabled auto-merge (squash) July 26, 2026 17:25
@mcanouil
mcanouil merged commit 220cbca into main Jul 26, 2026
14 checks passed
@mcanouil
mcanouil deleted the fix/atelier-format branch July 26, 2026 17:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Type: Bug 🐛 Issues related to bugs, errors, or mistakes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant