Skip to content

Comments

TEST: Switch to new quantecon-sphinx-theme (Theme #2) + collect Feedback#475

Open
mmcky wants to merge 1 commit intomainfrom
test/quantecon-sphinx-theme
Open

TEST: Switch to new quantecon-sphinx-theme (Theme #2) + collect Feedback#475
mmcky wants to merge 1 commit intomainfrom
test/quantecon-sphinx-theme

Conversation

@mmcky
Copy link
Contributor

@mmcky mmcky commented Feb 24, 2026

Test PR: New QuantEcon Sphinx Theme

This PR replaces quantecon-book-theme with the new quantecon-sphinx-theme.

Changes

  • environment.yml: Replaced quantecon-book-theme==0.15.1 with quantecon-sphinx-theme installed from the git main branch
  • lectures/_config.yml:
    • Changed html_theme from quantecon_book_theme to quantecon_sphinx_theme
    • Updated html_theme_options to use the new theme's configuration schema (color_scheme, dark_mode, toc_sticky, toc_autoexpand, etc.)
    • Removed old book-theme-specific options (authors, header_organisation, analytics, launch_buttons)

Purpose

This is a test PR to evaluate the new theme's rendering with our lecture content. Review the CI build output to assess compatibility.

DO NOT MERGE — This is for testing/evaluation only.

Replace quantecon-book-theme with quantecon-sphinx-theme from
https://github.com/QuantEcon/quantecon-sphinx-theme

Changes:
- environment.yml: Replace quantecon-book-theme==0.15.1 with
  quantecon-sphinx-theme installed from git main branch
- _config.yml: Update html_theme to quantecon_sphinx_theme and
  adapt theme options to match the new theme's configuration schema

This is a TEST PR to evaluate the new theme. DO NOT MERGE.
@github-actions
Copy link

@mmcky
Copy link
Contributor Author

mmcky commented Feb 24, 2026

Screenshot 2026-02-24 at 3 16 38 pm

@mmcky
Copy link
Contributor Author

mmcky commented Feb 24, 2026

This is a DEMO of a second theme that includes "features" of our theme, still minimal but is distinctively different to our current theme. This theme could serve two purposes:

  1. a theme that others can use on their projects (protecting the QE identity by restricting quantecon-book-theme)
  2. a theme to be used by a "contributors" series of lectures -- non primary QE lecture series.

@mmcky
Copy link
Contributor Author

mmcky commented Feb 24, 2026

I am not convinced about the name quantecon-sphinx-theme:

  • quantecon-minimal-sphinx-theme
  • ...

@mmcky mmcky changed the title TEST: Switch to new quantecon-sphinx-theme TEST: Switch to new quantecon-sphinx-theme (Theme #2) Feb 25, 2026
@mmcky
Copy link
Contributor Author

mmcky commented Feb 25, 2026

@kp992 I have been working on a second QuantEcon theme that we could use for non-core QuantEcon lectures - i.e. topic series. Here is a prototype. It has many of the same features from the QuantEcon theme but it is a bit more minimal and focuses on the content.

https://699d241d064feca2f249791b--epic-agnesi-957267.netlify.app/intro

If you had any time I would welcome any feedback on the design. What works? What doesn't work? What you like? What you don't like?

(cc: @HumphreyYang, @nisha617, @jstac)

@mmcky
Copy link
Contributor Author

mmcky commented Feb 25, 2026

Comments (please edit):

  • add in Authors and Translator Fields for each lecture

@mmcky mmcky changed the title TEST: Switch to new quantecon-sphinx-theme (Theme #2) TEST: Switch to new quantecon-sphinx-theme (Theme #2) + collect Feedback Feb 25, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant