quicksilver / manual

Quicksilver Manual
3 stars 2 forks source link

CSS issues with latest mkdocs (1.3.0) #15

Open pjrobertson opened 2 years ago

pjrobertson commented 2 years ago

If I use mkdocs 1.3.0 to build the site, the custom qs.css CSS gets over-ridden by the bootstrap.css styles.

Right now the fix is to switch back to using python3.6 + mkdocs 1.0.3, which works.

In the future we may want to look at supporting mkdocs 1.3.0 and fixing the CSS there.

n8henrie commented 2 years ago

Kind of a pain, they're using !important in a bunch of the styles

https://github.com/mkdocs/mkdocs/blob/master/mkdocs/themes/mkdocs/css/bootstrap.min.css

n8henrie commented 2 years ago

Python3.6 is unsupported by now, and the only way I can think of that the python version would make a difference is if it results in constraining the version of mkdocs (due to incompatibility with newer mkdocs). Should be able to just specify an older mkdocs while keeping newer python I would think.

n8henrie commented 2 years ago

(Also, just to note -- anything older than 3.7 can be a true pain for me and I assume @skurfer, as the M1 macs didn't exist at that time, so it's tough to even get a working installation of 3.6 on an M1 Mac. I think you can do it through nix and through pyenv with some patches.)

n8henrie commented 2 years ago

Bootstrap 4 has the !important built-in on .bg-primary (this isn't something mkdocs did): https://cdn.jsdelivr.net/npm/bootstrap@4.1.3/dist/css/bootstrap.min.css

Others are just using their own !important, which I know isn't a good thing... https://stackoverflow.com/questions/46736264/overriding-bootstrap-default-important-color-codes

It looks like fonts and size are being overridden as well. Gah.