Docs.rs: Monospace fonts are broken again

[jyn514]

Mostly likely by #981.

https://docs.rs/pulldown-cmark/0.7.2/pulldown_cmark/struct.Parser.html#method.new_with_broken_link_callback
Before:
Currently (but system-dependent):

The culprit is style.css, which, now that all CSS is in one file, is not particularly helpful.

code, kbd, pre, samp {
    font-family: monospace,monospace;
    font-size: 1em;
}

cc @Kixiron

[cynecx]

According to https://github.com/rust-lang/docs.rs/pull/981#issuecomment-678305912, that PR should've been reverted, no? (I can't find the revert actually.)

[jyn514]

It was reverted in prod but not in the code. The PR was redeployed after #987.

[cynecx]

Well something is very broken currently. It seems that style.css contains a redundant copy of normalize.css which is overwriting the custom styles.

EDIT: Apparently https://github.com/rust-lang/docs.rs/blob/master/vendor/pure-css/css/pure-min.css ships their own normalize.css which is the problem. These vendored css should get included first, followed by rustdoc.css, and finally style.css.

[jyn514]

I really wish we hadn't combined our own styles into the rest of the vendored styles 🤦

[cynecx]

Possible solution approach: Extract vendored css (purecss and fontawesome) into a separate file and use the following css order:

• normalize.css (from rustdoc)
• vendored.css (purecss and fontawesome)
• rustdoc.css
• light.css + dark.css
• style.css

EDIT: I could try implementing this, if it's something we'd like to try.

[jyn514]

@cynecx are you interested in making a PR for that? The relevant code is https://github.com/rust-lang/docs.rs/blob/master/templates/base.html

[cynecx]

@jyn514 Sure. I'll try.

[cynecx]

Oh, one question tho. It seems that purecss already contains a version of normalize.css. Should we just keep that with the one from rustdoc? Or remove the normalize.css from rustdoc?

[jyn514]

We can't change rustdoc styles. Ideally we would get rid of the one in purecss, but I don't know how to do that cleanly.

[cynecx]

@jyn514 We could just remove this line? https://github.com/rust-lang/docs.rs/blob/944e7fc7c30f8df171c4e1d35efbcb7c1a07d9db/templates/base.html#L13

[jyn514]

Hmm ... I guess that would work, but then our styles are out of sync with rustdoc if it changes the version of normalize. But if it fixes the issue I'm willing to try it.

[cynecx]

@jyn514 Well we could just keep both for now and do the removal in a future PR. Does that sound okay?