Dokkatoo Gradle Plugin/dev.adamko.dokkatoo.dokka.parameters/DokkaSourceLinkSpec

DokkaSourceLinkSpec

abstract class DokkaSourceLinkSpec @DokkatooInternalApi @Inject constructor(layout: ProjectLayout) : Serializable(source)

Configuration builder that allows adding a source link to each signature which leads to remoteUrl with a specific line number (configurable by setting remoteLineSuffix), letting documentation readers find source code for each declaration.

Example in Gradle Kotlin DSL:

sourceLink {
  localDirectory.set(projectDir.resolve("src"))
  remoteUrl.set(URI("https://github.com/kotlin/dokka/tree/master/src"))
  remoteLineSuffix.set("#L")
}

Constructors

DokkaSourceLinkSpec

@DokkatooInternalApi

@Inject

constructor(layout: ProjectLayout)

Properties

localDirectory

@get:Internal

abstract val localDirectory: DirectoryProperty

Path to the local source directory. The path must be relative to the root of current project.

remoteLineSuffix

@get:Optional

@get:Input

abstract val remoteLineSuffix: Property<String>

Suffix used to append source code line number to the URL. This will help readers navigate not only to the file, but to the specific line number of the declaration.

remoteUrl

@get:Input

abstract val remoteUrl: Property<URI>

URL of source code hosting service that can be accessed by documentation readers, like GitHub, GitLab, Bitbucket, etc. This URL will be used to generate source code links of declarations.

Functions

remoteUrl

fun remoteUrl(value: String)

fun remoteUrl(value: Provider<String>)

Set the value of remoteUrl.