[Gradle] Fix templates extraction

Previously templates were extracted as-is, but we also need to strip
prefix directory for Dokka to detect it.

Though I has to disable auto-provisioning of template as it does not
 work in standalone mode: KT-73082.

^KT-73076 In Progress

libraries/tools/gradle/documentation/Readme.md

@@ -0,0 +1,16 @@
+## Kotlinlang Gradle API reference
+
+This project assembles API reference for Kotlin Gradle plugins to publish it to https://kotlinlang.org.
+
+### Configuration
+
+- `build/templates` dir is used for Kotlinlang website templates. Currently, they should be put there manually.
+
+### Assembling
+
+To assemble API reference run:
+```shell
+$ ./gradlew :gradle:documentation:dokkaKotlinlangDocumentation -Pteamcity=true
+```
+
+Once build is finished - API reference is available in `build/documentation/kotlinlang` directory.

libraries/tools/gradle/documentation/build.gradle.kts

@@ -7,6 +7,7 @@ pluginsApiDocumentation {
     documentationOldVersions = layout.buildDirectory.dir("documentation/kotlinlangOld")
     templatesArchiveUrl = "https://github.com/JetBrains/kotlin-web-site/archive/refs/heads/master.zip"
     templatesArchiveSubDirectoryPattern = "kotlin-web-site-master/dokka-templates/**"
+    templatesArchivePrefixToRemove = "kotlin-web-site-master/dokka-templates/"
     gradlePluginsProjects = setOf(
         project(":kotlin-gradle-plugin-api"),
         project(":compose-compiler-gradle-plugin")

repo/gradle-build-conventions/gradle-plugins-documentation/src/main/kotlin/PluginsApiDocumentationExtension.kt

@@ -17,5 +17,6 @@ abstract class PluginsApiDocumentationExtension @Inject constructor(
     abstract val documentationOldVersions: DirectoryProperty
     abstract val templatesArchiveUrl: Property<String>
     val templatesArchiveSubDirectoryPattern: Property<String> = objectFactory.property(String::class.java).convention("")
+    val templatesArchivePrefixToRemove: Property<String> = objectFactory.property(String::class.java).convention("")
     abstract val gradlePluginsProjects: SetProperty<Project>
 }

repo/gradle-build-conventions/gradle-plugins-documentation/src/main/kotlin/gradle-plugins-documentation.gradle.kts

@@ -17,18 +17,33 @@ dependencies {
 val downloadTask = tasks.register<Download>("downloadTemplates") {
     src(documentationExtension.templatesArchiveUrl)
     dest(layout.buildDirectory.file("templateDist.zip"))
+    onlyIf(
+        "Kotlinlang Dokka template is not working in the standalone mode: KT-73082"
+    ) {
+        false
+    }
+
     onlyIfModified(true)
     overwrite(false)
 }
 
 val unzipTemplates = tasks.register<Copy>("unzipTemplates") {
     dependsOn(downloadTask)
+    onlyIf(
+        "Kotlinlang Dokka template is not working in the standalone mode: KT-73082"
+    ) {
+        false
+    }
+
+    val dirPrefix = documentationExtension.templatesArchivePrefixToRemove
     from(
         zipTree(downloadTask.map { it.dest })
             .matching {
                 include(documentationExtension.templatesArchiveSubDirectoryPattern.get())
             }
-    )
+    ).eachFile {
+        path = path.removePrefix(dirPrefix.get())
+    }
     into(layout.buildDirectory.dir("template"))
 }
 
@@ -54,12 +69,12 @@ tasks.register<org.jetbrains.dokka.gradle.DokkaMultiModuleTask>("dokkaKotlinlang
     dependsOn(unzipTemplates)
     pluginsMapConfiguration.put(
         "org.jetbrains.dokka.base.DokkaBase",
-        "{ \"templatesDir\": \"${unzipTemplates.map { it.destinationDir }.get()}\" }"
+        "{ \"templatesDir\": \"${unzipTemplates.map { it.destinationDir }.get().also { it.mkdirs() }}\" }"
     )
     pluginsMapConfiguration.put(
         "org.jetbrains.dokka.versioning.VersioningPlugin",
         documentationExtension.documentationOldVersions.map { olderVersionsDir ->
-            "{ \"version\":\"$version\", \"olderVersionsDir\":\"${olderVersionsDir.asFile}\" }"
+            "{ \"version\":\"$version\", \"olderVersionsDir\":\"${olderVersionsDir.asFile.also { it.mkdirs() }}\" }"
         }
     )