A modern programming language that makes developers happier.

kotlinlang

I ~have~ had an issue with `###` path prefixes staying in the final Dokka HTML output.

I'm using Dokka `1.8.10-with-fixed-urls6`, with a few custom assets and some CSS overrides, with Gradle 8.2.1 like this:

```apply&lt;DokkaPlugin&gt;()

val docsDir = "$rootDir/buildSrc/src/main/kotlin/plugins/docs"
val logoStyleSheetPath = "$docsDir/logo-styles.css"
val assetPaths = File("$docsDir/assets").walk().map { it.absolutePath }.joinToString { "\"$it\"" }
val customCssPluginConfiguration = Pair(
    "org.jetbrains.dokka.base.DokkaBase",
    """
    {
      "customAssets": [
        $assetPaths
      ],
      "customStyleSheets": ["$logoStyleSheetPath"],
      "separateInheritedMembers": true
    }
    """
)

tasks.withType&lt;DokkaMultiModuleTask&gt;().configureEach {
    pluginsMapConfiguration.set(
        mutableMapOf(customCssPluginConfiguration)
    )

    File("$docsDir/landing-page.md").takeIf { it.exists() }?.let {
        includes.from(it.absolutePath)
    }
}```
(The mentioned `assets` directory contains only SVG files.) Now, all generated pages, _except_ the main `index.html`, still contain this breaking code, which results in completely unstyled HTML pages that are missing the entire navigation on the left:

```&lt;!--[+]cmd:{"@class":"org.jetbrains.dokka.base.templating.PathToRootSubstitutionCommand","pattern":"###","default":""}--&gt;&lt;script type="text/javascript" src="###scripts/sourceset_dependencies.js" async&gt;&lt;/script&gt;
&lt;link href="###styles/style.css" rel="Stylesheet"&gt;
&lt;link href="###styles/jetbrains-mono.css" rel="Stylesheet"&gt;
&lt;link href="###styles/main.css" rel="Stylesheet"&gt;
&lt;link href="###styles/prism.css" rel="Stylesheet"&gt;
&lt;link href="###styles/logo-styles.css" rel="Stylesheet"&gt;
&lt;script type="text/javascript" src="###scripts/clipboard.js" async&gt;&lt;/script&gt;
&lt;script type="text/javascript" src="###scripts/navigation-loader.js" async&gt;&lt;/script&gt;
&lt;script type="text/javascript" src="###scripts/platform-content-handler.js" async&gt;&lt;/script&gt;
&lt;script type="text/javascript" src="###scripts/main.js" defer&gt;&lt;/script&gt;
&lt;script type="text/javascript" src="###scripts/prism.js" async&gt;&lt;/script&gt;
&lt;script type="text/javascript" src="###scripts/symbol-parameters-wrapper_deferred.js" defer&gt;&lt;/script&gt;&lt;/head&gt;&lt;body&gt;
images/assets&lt;link href="###images/theme-toggle-dark.svg"&gt;
&lt;link href="###images/logo-icon.svg"&gt;
&lt;link href="###images/theme-toggle-light.svg"&gt;
&lt;link href="###styles/logo-styles.css" rel="Stylesheet"&gt;
&lt;!--[-]cmd--&gt;```
This looks very strange, with `&lt;/head&gt;&lt;body&gt;images/assets` somewhere in between.

I have not touched or toggled `delayTemplateSubstitution`, which was referred to <https://slack-chats.kotlinlang.org/t/8632542/i-m-working-on-the-dokka-gradle-plugin-refactor-and-i-ve-got|here>. Who can tell me what's going on here?

To answer my own question, this was the solution:

```val assetPaths =
    File("$docsDir/assets").walk().map { it.absolutePath }.filter { File(it).isFile }.joinToString { "\"$it\"" }```
The `assets` directory itself was taken along as an asset and evaluated but not passed on, leading to this oddly formatted output.