Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Migrated from napari/napari#5182
This adds support for showing a napari logo as a "favicon" (browser tab icon) on the docs page.
Based on discussion in #4897 a logo silhouette was preferred over full-color. This PR adds a few assets and configures them in the header according to what I could find for current favicon best practices:
<link rel="icon" href="_static/favicon/logo-silhouette-dark-light.svg" type="image/svg+xml">
sizes="any"
is needed for Chrome to prefer the SVG<link rel="icon" href="_static/favicon/logo-silhouette-192.png" sizes="any" type="image/png">
<link rel="apple-touch-icon" href="_static/favicon/logo-noborder-180.png" sizes="180x180" type="image/png">
macOS Safari and Chrome Dark Mode
macOS Safari and Chrome Light Mode
iOS “Save to Home Screen”
N.B. this also adds a dependency on sphinx-favicon for the documentation building step.
References
closes napari/napari#4897
https://stackoverflow.com/questions/54639192/change-the-favicon-of-the-sphinx-read-the-docs-theme/54665517#54665517
https://evilmartians.com/chronicles/how-to-favicon-in-2021-six-files-that-fit-most-needs
How has this been tested?
Tested documentation building and serving locally.