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
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
|
package org.jetbrains.dokka
import com.google.inject.Inject
public class KotlinWebsiteFormatService @Inject constructor(locationService: LocationService,
signatureGenerator: LanguageService)
: JekyllFormatService(locationService, signatureGenerator) {
private var needHardLineBreaks = false
override fun appendFrontMatter(nodes: Iterable<DocumentationNode>, to: StringBuilder) {
super.appendFrontMatter(nodes, to)
to.appendln("layout: api")
}
override public fun formatBreadcrumbs(items: Iterable<FormatLink>): String {
items.drop(1)
if (items.count() > 1) {
return "<div class='api-docs-breadcrumbs'>" +
items.map { formatLink(it) }.joinToString(" / ") +
"</div>"
}
return ""
}
override public fun formatCode(code: String): String = if (code.length > 0) "<code>$code</code>" else ""
override fun formatStrikethrough(text: String): String = "<s>$text</s>"
override fun appendAsSignature(to: StringBuilder, node: ContentNode, block: () -> Unit) {
val contentLength = node.textLength
if (contentLength == 0) return
to.append("<div class=\"signature\">")
needHardLineBreaks = contentLength >= 62
try {
block()
} finally {
needHardLineBreaks = false
}
to.append("</div>")
}
override fun appendAsOverloadGroup(to: StringBuilder, block: () -> Unit) {
to.append("<div class=\"overload-group\">\n")
block()
to.append("</div>\n")
}
override fun formatLink(text: String, href: String): String {
return "<a href=\"${href}\">${text}</a>"
}
override fun appendTable(to: StringBuilder, body: () -> Unit) {
to.appendln("<table class=\"api-docs-table\">")
body()
to.appendln("</table>")
}
override fun appendTableHeader(to: StringBuilder, body: () -> Unit) {
to.appendln("<thead>")
body()
to.appendln("</thead>")
}
override fun appendTableBody(to: StringBuilder, body: () -> Unit) {
to.appendln("<tbody>")
body()
to.appendln("</tbody>")
}
override fun appendTableRow(to: StringBuilder, body: () -> Unit) {
to.appendln("<tr>")
body()
to.appendln("</tr>")
}
override fun appendTableCell(to: StringBuilder, body: () -> Unit) {
to.appendln("<td markdown=\"1\">")
body()
to.appendln("\n</td>")
}
override public fun appendBlockCode(to: StringBuilder, line: String, language: String) {
if (language.isNotEmpty()) {
super.appendBlockCode(to, line, language)
} else {
to.append("<pre markdown=\"1\">")
to.append(line.trimStart())
to.append("</pre>")
}
}
override fun formatSymbol(text: String): String {
return "<span class=\"symbol\">${formatText(text)}</span>"
}
override fun formatKeyword(text: String): String {
return "<span class=\"keyword\">${formatText(text)}</span>"
}
override fun formatIdentifier(text: String, kind: IdentifierKind): String {
return "<span class=\"${identifierClassName(kind)}\">${formatText(text)}</span>"
}
override fun formatSoftLineBreak(): String = if (needHardLineBreaks)
"<br/>"
else
""
override fun formatIndentedSoftLineBreak(): String = if (needHardLineBreaks)
"<br/> "
else
""
private fun identifierClassName(kind: IdentifierKind) = when(kind) {
IdentifierKind.ParameterName -> "parameterName"
IdentifierKind.SummarizedTypeName -> "summarizedTypeName"
else -> "identifier"
}
}
|
