Skip to content

Introduction to plugin development

In order to have an easier time developing plugins, it's a good idea to go through Dokka's internals first to learn more about its data model and extensions.

Setup

Template

The easiest way to start is to use the convenient Dokka plugin template. It has pre-configured dependencies, publishing and signing of your artifacts.

Manual

At a bare minimum, Dokka requires Kotlin Gradle Plugin and dokka-core dependencies:

plugins {
    kotlin("jvm") version "<kotlin_version>"
}

dependencies {
    compileOnly("org.jetbrains.dokka:dokka-core:<dokka_version>")
}

tasks.withType<KotlinCompile> {
    kotlinOptions.jvmTarget = "1.8"
}

In order to load a plugin into Dokka, your class must extend DokkaPlugin class. A fully qualified name of that class must be placed in a file named org.jetbrains.dokka.plugability.DokkaPlugin under resources/META-INF/services. All instances are automatically loaded during Dokka setup using java.util.ServiceLoader.

Extension points

Dokka provides a set of entry points for which you can create your own implementations. If you are not sure which extension point to use, have a look at core extensions and base extensions.

You can learn how to declare extension points and use extensions in Introduction to Extension points.

In case no suitable extension point exists for your use case, do share the details - it might be added in future versions of Dokka.

Example

You can follow the sample plugin tutorial which covers creation of a simple plugin: hide members annotated with your own @Internal annotation, that is exclude these members from generated documentation.

Fore more practical examples, have a look at sources of community plugins.

Help

If you have any further questions, feel free to get in touch with maintainers via Slack or GitHub.

Back to top