Issues with broken ToC layout

[fnesveda]

There are a few issues connected to the ToC in the right column on the page.

1. on some pages, it gets displayed under the main article
   • e.g. https://docs.apify.com/platform/actors/development/actor-definition/input-schema/specification/v1
   • it's probably because of some weird interaction between our docs theme, display: flex on the main layout and overflow: auto on code blocks
   • if you delete long lines in code blocks (e.g. lines 43 and 406 here), the layout gets fixed
2. on some pages, scrolling through the page makes the laout wider / narrower, resulting in the article jumping around
   • it might be connected to long subheadings being marked as current in the ToC

docs-scrolling-bug.mp4

Reported here: https://apify.slack.com/archives/C0L33UM7Z/p1725462627933989
cc @barjin

[barjin]

The more you know: The HEVC/H.256 codec is proprietary and isn't as widely supported as one might think (read: it doesn't work in Firefox on Linux). HEVC Advance also collects royalties for using the codec. Use AV1 instead (open, royalty-free, and slightly better supported); be the change! :)

[fnesveda]

Hah, I was actually thinking "which codec should I use? 🤔" when recording this video, but then I thought "it's 2024, H265 has to be supported everywhere by now". Thanks for pointing this out, I didn't think it won't work on Linux.

Anyway, AV1 is not widely supported on iOS devices and Safari on Macs (it only works on iPhone 15 Pro and the latest MacBooks), so I think I'll just stick with H264 for the next few years 😄

I reuploaded the video in H264, does it work for you now?

[barjin]

Perfect, cheers! (I downloaded the first one and played it in VLC, too, so no hard feelings 😄 ) H264 for the win, I guess :)