How to use Dokka to generate Docs like Kotlinlang.org

Question

AFAIK Kotlin's Documentation was made using Dokka. But the Examples stated in Dokka's Readme is only generating ultra basic webpages/markdown files with no elegance whatsoever.

It just looks like this

Here's another one by Atrium, docs link.

I'm wondering if I'm doing anything wrong.

I've also looked at the issues page and been browsing through other open source github projects that has used Dokka and the result is always the same.

Now a good example of how a tool that generates beautiful documentation would be Jazzy by Realm for Swift/Obj-C. Using it can be as easy as running one command on the terminal.

Here's an example documentation created using Jazzy

Further research with suggests that I may have to use third party tools like Gitbook or Jekyll to generate the kind of documentation I'm looking, is that really the only way?

are you asking how to use dokka, or are you asking for tool recommendations? — Tim, Jul 08 '19 at 09:47
Sadly no @Pabloku, the only way to beautify it, in my knowledge, is to use third party tools. — Zonily Jame, Jul 24 '19 at 02:16
And could you recomend any third party tool? I am trying https://orchid.netlify.com/ — Pabloku, Aug 01 '19 at 15:43
Right now I'm using Dokka to generate markdown files that I could use with mkdocs — Zonily Jame, Aug 03 '19 at 11:20

score 2 · Answer 1 · answered Feb 10 '20 at 17:03

2

Kotlinlang uses some custom styles for one of the dokka's output formats. Development on some better looking docs is underway

answered Feb 10 '20 at 17:03

Kamil Doległo

81
5

Avoid one liner comment as answer, Provide solution to question, else simply comment – this.girish Feb 10 '20 at 17:34
I would have commented but I don't not have enough reputation to do it – Kamil Doległo Feb 10 '20 at 18:10

How to use Dokka to generate Docs like Kotlinlang.org

1 Answers1