https://kotlinlang.org logo
#dokka
Title
# dokka
s

solonovamax

09/06/2023, 5:59 PM
hi, I'm currently working on a dokka plugin, and there were a few things I noticed that I'd like if there were apis for • extension points for custom markdown parsing • extension points for custom html/etc. rendering • extension points for injecting custom template models for the freemarker templates an example use case for the first two: I would like to create a dokka plugin that allows the use of code fences:
Copy code
=== "Kotlin"
    ```kotlin
    // kotlin code here
=== "Java"
Copy code
java
    // java code here
``` (syntax is open to change, however this is how it is handled by mkdocs material) which will then create two tabs named "Kotlin" and "Java". clicking on the kotlin one will display the kotlin code and clicking on the java one will display the java code. in order to do this, I must hook into both the markdown parser (to parse it correctly) and the html generator (to generate the correct html) (of course, additional js scripts must be added, however that can be done without too much issue) are these extension points planned? if not, it would be awesome if it was added to a to-do list
a

Andrea Falcone

09/07/2023, 3:44 PM
Some bugs that my team filed: https://github.com/Kotlin/dokka/issues/3072 and https://github.com/Kotlin/dokka/issues/3079 Please take a look and comment!
s

solonovamax

09/07/2023, 4:56 PM
I'm not entirely sure how that relates to my issue? [genuine]
a

Andrea Falcone

09/07/2023, 5:52 PM
#3072 is about supporting both Kotlin and Java samples (compilable samples, not code blocks) so somewhat similar. But you’re right, they aren’t the same issue. Probably best to file a dokka bug for your request