简体   繁体   中英

How to use Dokka to generate Docs like Kotlinlang.org

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?

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

The technical post webpages of this site follow the CC BY-SA 4.0 protocol. If you need to reprint, please indicate the site URL or the original address.Any question please contact:yoyou2525@163.com.

 
粤ICP备18138465号  © 2020-2024 STACKOOM.COM