Hi :slightly_smiling_face: This week I configured ...
# dokka
a
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
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.
👍 1
a
I see also this https://github.com/Kotlin/dokka/issues/2964 which is more or less what I was suggesting