Defer javascript load

[chrisjsewell]

Heya, at the moment the javascript load blocks the initial page render.

This is acutely problematic, if for example unpkg.com is being slow, as I just experienced in the MyST documentation 😒

You need to add the loading_method="defer":
https://www.sphinx-doc.org/en/master/extdev/appapi.html#sphinx.application.Sphinx.add_js_file

You then need to account for this in the initialisation, something like:

window.onload = function () {mermaid.initialize({startOnLoad:true})}

Ideally even, I see that you use html-page-context to load the JS, but here you should also only load it on pages where mermaid is actually used

[Belmogodx]

+1 would love to see this fixed!

[sscherfke]

Any updates on this?