Skip to content

fix(docs): restore Mermaid theme configuration - #678

Merged
cofin merged 1 commit into
mainfrom
agent/fix-mermaid-dark-mode
Aug 4, 2026
Merged

fix(docs): restore Mermaid theme configuration#678
cofin merged 1 commit into
mainfrom
agent/fix-mermaid-dark-mode

Conversation

@cofin

@cofin cofin commented Aug 4, 2026

Copy link
Copy Markdown
Member

Summary

  • replace the removed mermaid_init_js setting with the supported mermaid_init_config API
  • configure Mermaid's native light and dark themes and update the bundled Mermaid version to 11.12.1
  • disable Shibuya's SVG inversion so it does not double-correct Mermaid's native dark theme

Why

sphinxcontrib-mermaid 2.x no longer registers mermaid_init_js, so Sphinx silently ignored SQLSpec's diagram configuration. The extension already renders and re-renders native light and dark themes, while Shibuya's dark-mode filter inverted the resulting dark SVG and produced washed-out diagrams.

Closes #675

@cofin
cofin marked this pull request as ready for review August 4, 2026 15:47
@cofin
cofin merged commit fd60841 into main Aug 4, 2026
9 checks passed
@cofin
cofin deleted the agent/fix-mermaid-dark-mode branch August 4, 2026 15:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs: Mermaid configuration is silently ignored, and dark mode double-corrects diagrams

1 participant