Crystal docs dark theme

[j8r]

Some developers likes dark theme - more gentle on the eyes when codding at night 😄

The CSS media prefers-color-scheme can be used for auto-detection o the light/dark theme user preference

The prefers-color-scheme CSS media feature is used to detect if the user has requested the system use a light or dark color theme.

Other similar tools supporting it:

• https://devdocs.io
• https://doc.rust-lang.org/std/index.html

[straight-shoota]

Sure, sounds good enough to me.

But I would actually hold off on such non-essential features to the doc generator until we do a bigger refactor of the internal implementation. That will subsequently also make it easier to iterate on frontend features.

[Blacksmoke16]

Custom Properties could also be a cool future addition. It would abstract the coloring of things to a single CSS file that could be overridden to allow for custom styling.

[oprypin]

https://github.com/oprypin/mkdocstrings-crystal is an external doc generator that exposes theme customizations, including dark mode via https://squidfunk.github.io/mkdocs-material/setup/changing-the-colors/#color-scheme

[willhbr]

I was just about to file a duplicate of this. Would a PR adding a dark mode to the CSS be accepted?

I spent a few minutes tinkering with the styles to see what this could look like:

This would obviously require a bit more thought, but I think this direction would save some people's eyes at night.

[chances]

@willhbr Are your CSS sources available anywhere?

[willhbr]

I made that screenshot by tinkering directly in the browser, and didn't save them.