aboutsummaryrefslogtreecommitdiff
path: root/plugins/xml
diff options
context:
space:
mode:
authorPaweł Marks <pmarks@virtuslab.com>2020-01-27 09:34:16 +0100
committerPaweł Marks <Kordyjan@users.noreply.github.com>2020-01-31 15:07:06 +0100
commit885ecd28153b484277c9ddcbf4a7f9d761a59545 (patch)
treedb453e66762ebebb3ee05c0301b38c4465ea20a3 /plugins/xml
parentc29605d92d1999434ecc79e774281a8280ae2823 (diff)
downloaddokka-885ecd28153b484277c9ddcbf4a7f9d761a59545.tar.gz
dokka-885ecd28153b484277c9ddcbf4a7f9d761a59545.tar.bz2
dokka-885ecd28153b484277c9ddcbf4a7f9d761a59545.zip
Unifing model for pages with content ant technical renderer specific pages
Diffstat (limited to 'plugins/xml')
-rw-r--r--plugins/xml/src/main/kotlin/XmlPlugin.kt68
1 files changed, 36 insertions, 32 deletions
diff --git a/plugins/xml/src/main/kotlin/XmlPlugin.kt b/plugins/xml/src/main/kotlin/XmlPlugin.kt
index 839929e6..998a56ea 100644
--- a/plugins/xml/src/main/kotlin/XmlPlugin.kt
+++ b/plugins/xml/src/main/kotlin/XmlPlugin.kt
@@ -12,48 +12,52 @@ import org.jetbrains.dokka.transformers.pages.PageNodeTransformer
class XmlPlugin : DokkaPlugin() {
val transformer by extending {
- CoreExtensions.pageTransformer with XmlTransformer
+ CoreExtensions.pageTransformer providing ::XmlTransformer
}
}
-object XmlTransformer : PageNodeTransformer {
+class XmlTransformer(private val dokkaContext: DokkaContext) : PageNodeTransformer {
+ private val commentsToContentConverter by lazy { dokkaContext.single(CoreExtensions.commentsToContentConverter) }
+
enum class XMLKind : Kind {
Main, XmlList
}
- override fun invoke(input: ModulePageNode, dokkaContext: DokkaContext): ModulePageNode =
- input.transformPageNodeTree { node ->
- if (node !is ClassPageNode) node
- else {
- val refs =
- node.documentable?.extra?.filterIsInstance<XMLMega>()?.filter { it.key == "@attr ref" }
- .orEmpty()
- val elementsToAdd = mutableListOf<Documentable>()
-
- refs.forEach { ref ->
- input.documentable?.dfs { it.dri == ref.dri }?.let { elementsToAdd.add(it) }
- }
- val platformData = node.platforms().toSet()
- val refTable = DefaultPageContentBuilder.group(
- node.dri,
- platformData,
- XMLKind.XmlList,
- dokkaContext.single(CoreExtensions.commentsToContentConverter),
- dokkaContext.logger
- ) {
- block("XML Attributes", 2, XMLKind.XmlList, elementsToAdd, platformData) { element ->
- link(element.dri, XMLKind.XmlList) {
- text(element.name ?: "<unnamed>", XMLKind.Main)
- }
- text(element.briefDocTagString, XMLKind.XmlList)
+ override fun invoke(input: RootPageNode): RootPageNode =
+ input.transformPageNodeTree { if (it is ModulePageNode) transformModule(it) else it }
+
+ private fun transformModule(module: ModulePageNode) = module.transformContentPagesTree { node ->
+ if (node !is ClassPageNode) node
+ else {
+ val refs =
+ node.documentable?.extra?.filterIsInstance<XMLMega>()?.filter { it.key == "@attr ref" }
+ .orEmpty()
+ val elementsToAdd = mutableListOf<Documentable>()
+
+ refs.forEach { ref ->
+ module.documentable?.dfs { it.dri == ref.dri }?.let { elementsToAdd.add(it) }
+ }
+ val platformData = node.platforms().toSet()
+ val refTable = DefaultPageContentBuilder.group(
+ node.dri,
+ platformData,
+ XMLKind.XmlList,
+ commentsToContentConverter,
+ dokkaContext.logger
+ ) {
+ block("XML Attributes", 2, XMLKind.XmlList, elementsToAdd, platformData) { element ->
+ link(element.dri, XMLKind.XmlList) {
+ text(element.name ?: "<unnamed>", XMLKind.Main)
}
+ text(element.briefDocTagString, XMLKind.XmlList)
}
-
- val content = node.content as ContentGroup
- val children = (node.content as ContentGroup).children
- node.modified(content = content.copy(children = children + refTable))
}
+
+ val content = node.content as ContentGroup
+ val children = (node.content as ContentGroup).children
+ node.modified(content = content.copy(children = children + refTable))
}
+ }
- private fun PageNode.platforms() = this.content.platforms.toList()
+ private fun ContentPage.platforms() = this.content.platforms.toList()
} \ No newline at end of file