Skip to content

Commit db4648f

Browse files
committed
Fixed remaining issues and added docs for browser support
1 parent 48bb814 commit db4648f

File tree

12 files changed

+117
-30
lines changed

12 files changed

+117
-30
lines changed

docs/browser-support.md

+70
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
---
2+
template: overrides/main.html
3+
---
4+
5+
# Browser support
6+
7+
Material for MkDocs goes at great lengths to support the largest possible range
8+
of browsers while retaining the simplemost possibilities for customization via
9+
modern CSS features like [custom properties] and [mask images].
10+
11+
[custom properties]: https://caniuse.com/css-variables
12+
[mask images]: https://caniuse.com/mdn-css_properties_mask-image
13+
14+
## Supported browsers
15+
16+
The following table lists all browsers for which Material for MkDocs offers full
17+
support, so it can be assumed that all features work without degradation. If you
18+
find a feature not to be working in a browser in the supported version range,
19+
please [open an issue]:
20+
21+
<figure markdown>
22+
23+
| Browser | Version | Release date | | | Usage |
24+
| ------------------------------------ | ------: | -----------: | ------: | -----: | ---------: |
25+
| | | | desktop | mobile | overall |
26+
| :fontawesome-brands-chrome: Chrome | 49+ | 03/2016 | 25.65% | 38.33% | 63.98% |
27+
| :fontawesome-brands-safari: Safari | 10+ | 09/2016 | 4.63% | 14.96% | 19.59% |
28+
| :fontawesome-brands-edge: Edge | 79+ | 01/2020 | 3.95% | n/a | 3.95% |
29+
| :fontawesome-brands-firefox: Firefox | 53+ | 04/2017 | 3.40% | .30% | 3.70% |
30+
| :fontawesome-brands-opera: Opera | 36+ | 03/2016 | 1.44% | .01% | 1.45% |
31+
| | | | | | __92.67%__ |
32+
33+
<figcaption markdown>
34+
35+
Browser support matrix sourced from [caniuse.com].[^1]
36+
37+
</figcaption>
38+
</figure>
39+
40+
[^1]:
41+
The data was collected from [caniuse.com] in January 2022 and is primarily
42+
based on browser support for [custom properties], [mask images] and the
43+
[:is pseudo selector] which are not completely polyfillable.
44+
45+
Note that the usage data is based on global browser market share, so it could
46+
in fact be entirely different for your target demographic. It's a good idea to
47+
check the distribution of browser types and versions among your users.
48+
49+
[open an issue]: https://github.com/squidfunk/mkdocs-material/issues/new/choose
50+
[caniuse.com]: https://caniuse.com/
51+
[:is pseudo selector]: https://caniuse.com/css-matches-pseudo
52+
53+
## Other browsers
54+
55+
Albeit your site might not look as perfect as when viewed with a modern browser,
56+
the following older browser versions might work with some additional effort:
57+
58+
- :fontawesome-brands-firefox: __Firefox 31-52__ – icons will render as little
59+
boxes due to missing support for [mask images]. While this cannot be
60+
polyfilled, it might be mitigated by hiding icons with [additional CSS].
61+
- :fontawesome-brands-edge: __Edge 16-18__ – the spacing of some elements might be
62+
a little of due to missing support for the [:is pseudo selector], which can be
63+
mitigated with some [additional CSS].
64+
- :fontawesome-brands-internet-explorer: __Internet Explorer__ - no support,
65+
mainly due to missing support for [custom properties]. The last version of
66+
Material for MkDocs to support Internet Explorer is
67+
[:octicons-tag-24: 4.6.3][IE support].
68+
69+
[additional CSS]: customization.md#additional-css
70+
[IE support]: https://github.com/squidfunk/mkdocs-material/releases/tag/4.6.3

material/assets/stylesheets/main.8002f318.min.css

-9
This file was deleted.

material/assets/stylesheets/main.8002f318.min.css.map

-1
This file was deleted.

material/assets/stylesheets/main.eab66a73.min.css

+15
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

material/assets/stylesheets/main.eab66a73.min.css.map

+1
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

material/base.html

+1-1
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@
3434
{% endif %}
3535
{% endblock %}
3636
{% block styles %}
37-
<link rel="stylesheet" href="{{ 'assets/stylesheets/main.8002f318.min.css' | url }}">
37+
<link rel="stylesheet" href="{{ 'assets/stylesheets/main.eab66a73.min.css' | url }}">
3838
{% if config.theme.palette %}
3939
{% set palette = config.theme.palette %}
4040
<link rel="stylesheet" href="{{ 'assets/stylesheets/palette.e6a45f82.min.css' | url }}">

material/overrides/assets/stylesheets/main.de86b20e.min.css renamed to material/overrides/assets/stylesheets/main.c1d34250.min.css

+1-1
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)