Theme-based image display

[Andre601]

Couldn't find a setup/reference page about this and the insider page also didn't show any noticeable mention about that, so I suggest this now.

The idea is a way to define images to only display while using a specific scheme.

The reason is simple: Readability. When you allow people to toggle between the schemes could it become hard to look at or recognize images, because it may use colours that conflict with the scheme currently used, so having a way to only display the image if the specific scheme is used would be a neat addition to have.

The inspiration came from GitHub implementing a way to define a theme context for images in November 24th which allows you to only show specific images under specific themes.

As an example do I have here images used on the Primer Octicons Repository. One is only visible in dark and one only in light theme.

[squidfunk]

Using a hash fragment is a very interesting idea! Could you open an issue with a FR? I can look into it.

[squidfunk]

Added in e3fba7a. I just need to update the docs. You can now use #only-light and #only-dark as hash fragments on image URLs.

[squidfunk]

Docs added in a6d8e55.

[Andre601]

Should the docs already show the feature?

Because I can't see it working here...

[squidfunk]

Yes, they should and now they do 😅 I forgot to retrigger the build after doing the Insiders merge, which is what the documentation is built with. Sorry for the troubles, I've been on and off my notebook today.