package org.jetbrains.dokka.jekyll import org.jetbrains.dokka.CoreExtensions import org.jetbrains.dokka.base.DokkaBase import org.jetbrains.dokka.base.renderers.PackageListCreator import org.jetbrains.dokka.base.renderers.RootCreator import org.jetbrains.dokka.base.resolvers.local.DokkaLocationProviderFactory import org.jetbrains.dokka.base.resolvers.shared.RecognizedLinkFormat import org.jetbrains.dokka.gfm.GfmPlugin import org.jetbrains.dokka.gfm.renderer.BriefCommentPreprocessor import org.jetbrains.dokka.gfm.renderer.CommonmarkRenderer import org.jetbrains.dokka.pages.ContentPage import org.jetbrains.dokka.plugability.* import org.jetbrains.dokka.renderers.PostAction import org.jetbrains.dokka.transformers.pages.PageTransformer class JekyllPlugin : DokkaPlugin() { val jekyllPreprocessors by extensionPoint() private val dokkaBase by lazy { plugin() } private val gfmPlugin by lazy { plugin() } val renderer by extending { (CoreExtensions.renderer providing { JekyllRenderer(it) } override plugin().renderer) } val rootCreator by extending { jekyllPreprocessors with RootCreator } val briefCommentPreprocessor by extending { jekyllPreprocessors with BriefCommentPreprocessor() } val packageListCreator by extending { jekyllPreprocessors providing { PackageListCreator(it, RecognizedLinkFormat.DokkaJekyll) } order { after(rootCreator) } } val locationProvider by extending { dokkaBase.locationProviderFactory providing ::DokkaLocationProviderFactory override listOf(gfmPlugin.locationProvider) } internal val alphaVersionNotifier by extending { CoreExtensions.postActions providing { ctx -> PostAction { ctx.logger.info( "The Jekyll output format is still in Alpha so you may find bugs and experience migration " + "issues when using it. You use it at your own risk." ) } } } @OptIn(DokkaPluginApiPreview::class) override fun pluginApiPreviewAcknowledgement(): PluginApiPreviewAcknowledgement = PluginApiPreviewAcknowledgement } class JekyllRenderer( context: DokkaContext ) : CommonmarkRenderer(context) { override val preprocessors = context.plugin().query { jekyllPreprocessors } override fun buildPage(page: ContentPage, content: (StringBuilder, ContentPage) -> Unit): String { val builder = StringBuilder() builder.append("---\n") builder.append("title: ${page.name}\n") builder.append("---\n") content(builder, page) return builder.toString() } }