blob: 1e4cc8dd4f0bdcb4b30994b3de720433467cf121 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
|
/*
* Copyright 2014-2023 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license.
*/
package org.jetbrains.dokka.base.resolvers.external
import org.jetbrains.dokka.base.resolvers.local.DokkaLocationProvider.Companion.identifierToFilename
import org.jetbrains.dokka.base.resolvers.shared.ExternalDocumentation
import org.jetbrains.dokka.links.DRI
import org.jetbrains.dokka.plugability.DokkaContext
open class DefaultExternalLocationProvider(
val externalDocumentation: ExternalDocumentation,
val extension: String,
val dokkaContext: DokkaContext
) : ExternalLocationProvider {
val docURL = externalDocumentation.documentationURL.toString().removeSuffix("/") + "/"
override fun resolve(dri: DRI): String? {
externalDocumentation.packageList.locations[dri.toString()]?.let { path -> return "$docURL$path" }
if (dri.packageName !in externalDocumentation.packageList.packages)
return null
return dri.constructPath()
}
protected open fun DRI.constructPath(): String {
val modulePart = packageName?.let { packageName ->
externalDocumentation.packageList.moduleFor(packageName)?.let {
if (it.isNotBlank())
"$it/"
else
""
}
}.orEmpty()
val docWithModule = docURL + modulePart
val classNamesChecked = classNames ?: return "$docWithModule${packageName ?: ""}/index$extension"
val classLink = (listOfNotNull(packageName) + classNamesChecked.split('.'))
.joinToString("/", transform = ::identifierToFilename)
val fileName = callable?.let { identifierToFilename(it.name) } ?: "index"
return "$docWithModule$classLink/$fileName$extension"
}
}
|
