Is this a known issue with `code` blocks by any ch...

# dokka

[Edoardo Luppi]

Is this a known issue with code blocks by any chance?

[solonovamax]

is the issue here that it's doing a line break?

afaik by default dokka will make code blocks wrap if the lines are too long. it seems that it's wrapping at the following positions:

<dependencies>
    <dependency>
        <groupId>com.hcl.mainframe.proto</groupId>
       ^----------------------------
        <artifactId>zproto</artifactId>
        <version>1.0.0-SNAPSHOT</version>
                      ^--------------
    </dependency>
</dependencies>

[Edoardo Luppi]

@solonovamax yes exactly, I think those line breaks are unwanted

[solonovamax]

it's not particularly an "issue" with it, it's more "intended behaviour"

[Edoardo Luppi]

@solonovamax any way to change it that you know of? In mobile it wraps and it looks awful

[solonovamax]

you could perhaps add a custom style that includes the following css:

.symbol:not(.token), code {
    overflow: scroll;
    white-space: nowrap;
}

[solonovamax]

this causes a very long line to render like this:

[solonovamax]

image.png

[Edoardo Luppi]

Unfortunately no wrap does not respect line breaks anymore. Multiple lines will be folded into a single one, at least based on my test a couple hours ago

[solonovamax]

hmmm, let me check css shit, 1 sec

[solonovamax]

setting white-space to pre might work

[solonovamax]

try that

[Edoardo Luppi]

That did the trick indeed! Thanks 🐕

[solonovamax]

np

I might make a plugin at some point that fixes a bunch of minor issues like this (with configurable settings) because I've noticed quite a few of them with dokka tbh

I'm currently working on a small little plugin that allows you to add custom scripts (because I want to modify the version of prism.js they ship to support more languages)

[solonovamax]

@Edoardo Luppi I've finally created that plugin with a bunch of tweaks for dokka

you can use it by adding

dependencies {
    dokkaPlugin("ca.solo-studios:dokka-style-tweaks-plugin:0.1.1")
}

to your build.gradle.kts file.
It can then be configured using the type-safe plugin configuration:

tasks {
    withType<AbstractDokkaTask>().configureEach {
        pluginConfiguration<DokkaStyleTweaksPlugin, DokkaStyleTweaksConfiguration> {
            minimalScrollbar = true
            darkPurpleHighlight = true
            improvedBlockquoteBorder = true
            lighterBlockquoteText = true
            sectionTabFontWeight = "500"
            sectionTabTransition = true
            improvedSectionTabBorder = true
            disableCodeWrapping = true
        }
    }
}

or via json:

tasks {
    withType<AbstractDokkaTask>().configureEach {
        val dokkaTweaksConfiguration = """
            {
                "minimalScrollbar": true,
                "darkPurpleHighlight": true,
                "improvedBlockquoteBorder": true,
                "lighterBlockquoteText": true,
                "sectionTabFontWeight": "500"
                "sectionTabTransition": true,
                "improvedSectionTabBorder": true,
                "disableCodeWrapping": true
            }
        """.trimIndent()

        pluginConfiguration.set(
                mapOf(
                        "ca.solostudios.dokkastyles.plugin.DokkaStyleTweaksPlugin" to dokkaTweaksConfiguration,
                     )
                               )
    }
}

all the tweaks are documented via kdoc, but the source is here: https://github.com/solo-studios/dokka-plugins/blob/master/dokka-style-tweaks-plugin/src/main/kotlin/ca/solostudios/dokkastyles/plugin/DokkaStyleTweaksConfiguration.kt

for your issue with the whitespace, simply set disableCodeWrapping to true, and it will fix it.