Hi 🙂 This week I configured dokka on a project. I spent like an hour tweaking Gradle trying to figure out why the side bar was empty. It turns out one needs to load the html via a web server. Double clicking on
index.html
leaves the side bar empty. Something that would have saved me some frustration is including a
<!-- please load via a web server -->
HTML comment where the list should show up.
a
Adam Semenenko
07/28/2025, 8:01 AM
hey, thanks for sharing the feedback.
We do have an aim to improve the HTML site https://github.com/Kotlin/dokka/issues/1795, but I don't believe this is a high priority at present.
The need for a webserver is documented in some places (e.g. https://kotlinlang.org/docs/dokka-html.html says "HTML pages generated by this format need to be hosted on a web server in order to render everything correctly."), so adding a more visible message would help.