Skip to content

Web figures: posters for light and dark pages; polished examples - #90

Merged
max-models merged 1 commit into
develfrom
web-figure-polish
Nov 8, 2026
Merged

max-models merged 1 commit into
develfrom
web-figure-polish

Conversation

@max-models

@max-models max-models commented Nov 8, 2026 •

Copy link
Copy Markdown
Owner
  • maxplotlib.web.write_posters(fig, stem, **hints) writes <stem>.png and <stem>.dark.png, pictures of a web figure for light and dark pages, with a test.
    • The docs theme's PlotlyFigure shows them (poster, posterDark, PlotlyFigure: calmer figures in the site's colours, caption and poster starlight-theme#64) until plotly.js has drawn the figure, and in its place without JavaScript.
    • They are drawn as the theme draws the figure: transparent, the theme's text and grid colours, its data palette for traces in a default colour, black as the text colour, and no buttons or slider.
    • Uses kaleido, which joins the docs extra.
    • plasma-plots will call it for its posters.
  • The "Web figures" guide:
    • captions and posters for the three examples;
    • the heatmap example is smooth (zsmooth="best", with a note to keep the cells for grid data);
    • a short section on captions and posters.
    • scripts/web_figure_examples.py writes the posters, and skips them, with a message, when kaleido can't run.

Checks:

  • The tests and the pre-commit hooks pass, and starlight-check-mdx compiles all 22 MDX files.
  • I looked at the guide in the dev server with the theme change installed: with JavaScript the figures and captions in both themes, and without it the posters in the theme's palette.

Copy link
Copy Markdown
Owner Author

docs / notebook (site, tutorial-05) and docs / notebook (site, tutorial-16-plotext-advanced) failed at the artifact upload, after their notebooks had run: GitHub's blob storage answered "The server is busy." Neither notebook is touched by this PR, so this is not its failure. I re-ran the failed jobs once.


Generated by Claude Code

@max-models
max-models merged commit 1086b13 into devel Nov 8, 2026
53 of 55 checks passed
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