Skip to content

New document page for logo usage guide#30631

Draft
jeromefv wants to merge 23 commits into
matplotlib:mainfrom
jeromefv:logo_guide
Draft

New document page for logo usage guide#30631
jeromefv wants to merge 23 commits into
matplotlib:mainfrom
jeromefv:logo_guide

Conversation

@jeromefv

@jeromefv jeromefv commented Oct 3, 2025

Copy link
Copy Markdown
Contributor

PR summary

This is a new page for the About us section to cover logo usage guidelines for Matplotlib. It has links to the official NumFOCUS trademark guidelines as well as the gallery page to generate the logo. I've added a table with the official colors for the logo with swatches as well.

The new page has official references and guidelines for using the Matplotlib logo. Many others also have a page similar to this. It can be the authority on how to use the logo correctly and link to important references. This covers the issue here for adding a new page.

This is a draft pull request since I'm not able to figure out how to have the SVG reflect dark and light modes accurately. I'm hoping to get support from others on either a technical solution to have the logos work in either light or dark mode, or some other way to show them.

PR checklist

jeromefv and others added 22 commits August 1, 2025 15:59
This makes explicit calls to `autoscale_view()` or
`_request_autoscale_view()` unnecessary.

3D Axes have a special `auto_scale_xyz()`, also there's a mixture of
`add_collection()` and `add_collection3d()`. This needs separate sorting
. I've added a private value `autolim="_datalim_only"` to keep the
behavior for 3D Axes unchanged for now. That will be resolved by a
follow-up PR. I believe it's getting too complicated if we fold this
into the 2D change.
- use `color` kwarg instead of separate `add_color()`
- remove `autolim=True` from `add_collection()` calls as that is the
default anyway
@jeromefv

jeromefv commented Oct 3, 2025

Copy link
Copy Markdown
Contributor Author

@story645 Draft PR for reference!

@story645

story645 commented Oct 3, 2025

Copy link
Copy Markdown
Member

Thanks! Have you tried setting the background/custom CSS like it's sketched out here:

.dark-mode-card.sd-card-body{ background-color: rgb(33,37,41) } 
    .. card::
        :card-body:dark-mode-card

@story645 story645 linked an issue Jun 8, 2026 that may be closed by this pull request
@story645 story645 linked an issue Jun 17, 2026 that may be closed by this pull request
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.

[Doc]: logo example should include dark option and have names Logo Usage Guidelines

3 participants