Skip to content

Switch documentation theme to Furo - #6

Merged
mtap-research merged 4 commits into
mainfrom
agent/switch-docs-to-furo
Jul 18, 2026
Merged

Switch documentation theme to Furo#6
mtap-research merged 4 commits into
mainfrom
agent/switch-docs-to-furo

Conversation

@mtap-research

Copy link
Copy Markdown
Collaborator

Summary

  • replace PyData Sphinx Theme with Furo 2025.12.19
  • preserve the existing Sphinx, autodoc, sphinx-design, and Read the Docs workflow
  • add branded light and dark color palettes
  • provide keyboard navigation and GitHub view/edit links
  • adapt custom landing-page styles to Furo selectors

Validation

  • sphinx-build -W --keep-going -b html docs/source /tmp/coremof-furo-html
  • all 11 documentation pages, module indices, search index, and source views built successfully with no warnings

@mtap-research
mtap-research merged commit 6af786f into main Jul 18, 2026
3 checks passed

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 6df04291dd

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +317 to +319
body[data-theme="dark"] .coremof-card.sd-card,
body[data-theme="dark"] .coremof-checklist > div,
body[data-theme="dark"] .coremof-resource.sd-card {

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Apply custom dark styles in Furo's auto mode

Furo normally leaves body[data-theme="auto"] in place and applies the OS dark preference through a media query, so these rules only run after a user explicitly selects dark mode. With the default automatic theme on a dark-preferring system, fixed light styles such as the checklist's background: #fff remain while Furo supplies dark foreground colors, and navy headings/sidebar branding stay on a dark background. Include the automatic dark-mode media-query case or derive these colors from Furo's theme variables.

Useful? React with 👍 / 👎.

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.

1 participant