Sidebar missing until mermaidjs finishes loading

[vlad-ngn]

Hi!

Previous discussion: erlang/erlang-org#150

Screenshot 1:
Sidebar missing, mermaidjs loading

Screenshot 2:
Sidebar appeared after mermaidjs loaded

This is a problem for me, because mermaidjs takes ~ 1 minute to load.

Browser:
Google Chrome
Version 126.0.6478.126 (Official Build) (64-bit)

@Benjamin-Philip

[voughtdq]

Not a browser expert, but I think the problem here might be that because html.js is loaded async, but mermaid isn't, the sidebar loads after mermaid.

Maybe changing the mermaid script to async will fix it 🤔

[voughtdq]

Actually, ExDoc is also the wrong place to submit this issue too. I'm researching how to fix the problem, but the Mermaid scripts are installed here: https://github.com/erlang/otp/blob/OTP-27.0.1/make/ex_doc.exs#L190

[josevalim]

Thank you @voughtdq! Can you also please send a PR updating the examples here? https://github.com/elixir-lang/ex_doc?tab=readme-ov-file#extensions

[Benjamin-Philip]

I'll patch the Erlang docs. Thanks @voughtdq.