From 2a1c55a0ed167019ae187cd2df93b069ae97e0ee Mon Sep 17 00:00:00 2001 From: Ignat Beresnev Date: Fri, 21 Apr 2023 20:19:06 +0200 Subject: Add source links to the dokka-multimodule-example project (#2966) --- .../parentProject/build.gradle.kts | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) (limited to 'examples/gradle/dokka-multimodule-example/parentProject') diff --git a/examples/gradle/dokka-multimodule-example/parentProject/build.gradle.kts b/examples/gradle/dokka-multimodule-example/parentProject/build.gradle.kts index da7b382e..7fb7c115 100644 --- a/examples/gradle/dokka-multimodule-example/parentProject/build.gradle.kts +++ b/examples/gradle/dokka-multimodule-example/parentProject/build.gradle.kts @@ -1,5 +1,6 @@ import org.jetbrains.dokka.DokkaConfiguration.Visibility import org.jetbrains.dokka.gradle.DokkaTaskPartial +import java.net.URL plugins { kotlin("jvm") @@ -17,6 +18,21 @@ subprojects { Visibility.PUBLIC, Visibility.PROTECTED )) + + // In multi-project builds, `remoteUrl` must point to that project's dir specifically, so if you + // want to configure sourceLinks at once in `subprojects {}`, you have to find the relative path. + // Alternatively, you can move this configuration up into subproject build scripts, + // and just hardcode the exact paths as demonstrated in the basic dokka-gradle-example. + // + // Read docs for more details: https://kotlinlang.org/docs/dokka-gradle.html#source-link-configuration + sourceLink { + val exampleDir = "https://github.com/Kotlin/dokka/tree/master/examples/gradle/dokka-multimodule-example" + val projectRelativePath = rootProject.projectDir.toPath().relativize(projectDir.toPath()) + + localDirectory.set(projectDir.resolve("src")) + remoteUrl.set(URL("$exampleDir/$projectRelativePath/src")) + remoteLineSuffix.set("#L") + } } } } -- cgit