racket/scribble

table of contents toggle breaks layout on at least some browsers

Closed this issue · 6 comments

This commit causes the layout of the "top prev up next" section of the documentation to be garbled for me (on Safari on a mac, with a full-width browser). It looks okay in firefox (same window size, same os), tho.

Here's what I see:

Screen Shot 2021-10-06 at 9 44 24 AM

and here's what it looks like when I revert the commit, rebuild, and reload the page:

Screen Shot 2021-10-06 at 10 18 56 AM

Ping @jryans in case you know what's going on.

Ah, thanks for the ping, I'll take a look!

I can indeed reproduce the issue here, and it seems to only affect desktop Safari somehow. Anyway, I'll work on a fix.

Did this PR make to 8.3? docs.racket-lang.org currently looks like this on Firefox.

Screen Shot 2021-11-08 at 3 28 39 AM

Note that I don't notice this problem in my raco docs -- and my Racket is currently at git HEAD.

@sorawee Yes, the above markup change has been included correctly in the deployed markup for 8.3.

I believe the visual issue you're seeing is related to a short-lived caching bug with the deployment, as this morning I noticed that the CSS and JS files on docs.racket-lang.org didn't appear to be updated, but when I added a random query string (e.g. ?123), the newer version came through. After a few hours, the updated files eventually came through as part of a regular page load.

On my side, things are now looking correct here.

  • Firefox

image

  • Safari

image

If you're still seeing issues after a few hours, I think it would be good to open a new issue to track this.

Yes, it renders correctly now! :)