Migrate Pebble template rendering to Kotlin class and remove asciidoc API

Make tiny-doc a Kotlin JVM module with a PebbleRenderer class that reads
tiny-api.json, flattens the nested structure, and renders all HTML pages.
Remove the asciidoc-based API generation pipeline (tiny-api.adoc) in favor
of the Pebble-generated api.html. Add editor link to nav, "Try it" buttons
on API function cards, and hide example blocks when no example exists.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: dwursteisen

gradle/libs.versions.toml

@@ -13,6 +13,7 @@ luak = "1.2.0"
 lwjgl = "3.3.6"
 minigdx-developer = "1.5.0"
 mokkery = "2.10.1"
+pebble = "3.2.3"
 rsyntax = "3.6.0"
 slf4j = "2.0.7"
 
@@ -28,6 +29,8 @@ kotlin-serialization-json = { module = "org.jetbrains.kotlinx:kotlinx-serializat
 
 luak = { module = "com.github.minigdx:luak", version.ref = "luak" }
 
+pebble = { module = "io.pebbletemplates:pebble", version.ref = "pebble" }
+
 lwjgl-core = { module = "org.lwjgl:lwjgl", version.ref = "lwjgl" }
 lwjgl-glfw = { module = "org.lwjgl:lwjgl-glfw", version.ref = "lwjgl" }
 lwjgl-opengl = { module = "org.lwjgl:lwjgl-opengl", version.ref = "lwjgl" }

settings.gradle.kts

@@ -34,7 +34,6 @@ plugins {
 include("tiny-cli")
 include("tiny-doc")
 include("tiny-doc-annotations")
-include("tiny-annotation-processors:tiny-api-to-asciidoc-generator")
 include("tiny-annotation-processors:tiny-asciidoctor-dsl")
 include("tiny-annotation-processors:tiny-lua-dsl")
 include("tiny-annotation-processors:tiny-api-to-json-generator")

tiny-doc/build.gradle.kts

@@ -1,28 +1,16 @@
 import org.asciidoctor.gradle.jvm.AsciidoctorTask
 
-buildscript {
-    repositories { mavenCentral() }
-    dependencies {
-        classpath("io.pebbletemplates:pebble:3.2.3")
-    }
-}
-
 @Suppress("DSL_SCOPE_VIOLATION")
 plugins {
     alias(libs.plugins.asciidoctorj)
-    alias(libs.plugins.minigdx.developer)
+    alias(libs.plugins.minigdx.jvm)
 }
 
 val asciidoctorResources by configurations.creating {
     isCanBeConsumed = false
     isCanBeResolved = true
 }
 
-val asciidoctorDependencies by configurations.creating {
-    isCanBeConsumed = false
-    isCanBeResolved = true
-}
-
 val jsonApiDependencies by configurations.creating {
     isCanBeConsumed = false
     isCanBeResolved = true
@@ -39,16 +27,6 @@ dependencies {
         ),
     )
 
-    add(
-        asciidoctorDependencies.name,
-        project(
-            mapOf(
-                "path" to ":tiny-engine",
-                "configuration" to "tinyApiAsciidoctor",
-            ),
-        ),
-    )
-
     add(
         jsonApiDependencies.name,
         project(
@@ -58,6 +36,9 @@ dependencies {
             ),
         ),
     )
+
+    implementation(libs.pebble)
+    implementation(libs.kotlin.serialization.json)
 }
 
 val unzipAsciidoctorResources =
@@ -68,13 +49,6 @@ val unzipAsciidoctorResources =
         cp.into(project.layout.buildDirectory.get().asFile.resolve("docs/asciidoc"))
     }
 
-val copyAsciidoctorDependencies =
-    tasks.maybeCreate("copy-asciidoctorDependencies", Copy::class).also { cp ->
-        // I'm bit lazy, I copy the result straight into the source directory :grimace:
-        cp.into(project.projectDir.resolve("src/docs/asciidoc/dependencies"))
-        cp.from(asciidoctorDependencies)
-    }
-
 val copySample =
     tasks.register("copy-sample", Copy::class) {
         from(project.projectDir.resolve("src/docs/asciidoc/sample"))
@@ -103,115 +77,47 @@ val copySeoFiles = tasks.register("copy-seoFiles", Copy::class) {
         include("showcase.json")
         include("tutorials.json")
         include("document.json")
-        include("api.html")
     }
     into(project.layout.buildDirectory.get().asFile.resolve("docs/asciidoc"))
 }
 
-val renderPebbleTemplates = tasks.register("renderPebbleTemplates") {
+val renderPebbleTemplates = tasks.register("renderPebbleTemplates", JavaExec::class) {
     val templateDir = project.projectDir.resolve("src/docs/templates")
     val dataDir = project.projectDir.resolve("src/docs/asciidoc")
     val outputDir = project.layout.buildDirectory.get().asFile.resolve("docs/asciidoc")
+    val apiJsonFile = project.layout.buildDirectory.get().asFile.resolve("docs/asciidoc/tiny-api.json")
+
+    dependsOn(
+        tasks.named("classes"),
+        copyJsonApi,
+        copySeoFiles,
+        unzipAsciidoctorResources,
+        copySample,
+        copyResources,
+    )
+
+    classpath = project.the<SourceSetContainer>().getByName("main").runtimeClasspath
+    mainClass.set("com.github.minigdx.tiny.doc.PebbleRendererKt")
+    args = listOf(
+        templateDir.absolutePath,
+        dataDir.absolutePath,
+        outputDir.absolutePath,
+        apiJsonFile.absolutePath,
+    )
 
     inputs.dir(templateDir)
     inputs.files(
         dataDir.resolve("showcase.json"),
         dataDir.resolve("tutorials.json"),
         dataDir.resolve("document.json"),
     )
+    inputs.files(apiJsonFile)
     outputs.files(
         outputDir.resolve("index.html"),
         outputDir.resolve("showcase.html"),
         outputDir.resolve("documentation.html"),
         outputDir.resolve("api.html"),
     )
-
-    doLast {
-        val slurper = groovy.json.JsonSlurper()
-
-        @Suppress("UNCHECKED_CAST")
-        val games = slurper.parseText(dataDir.resolve("showcase.json").readText()) as List<Map<String, Any>>
-        @Suppress("UNCHECKED_CAST")
-        val tutorials = slurper.parseText(dataDir.resolve("tutorials.json").readText()) as List<Map<String, Any>>
-        @Suppress("UNCHECKED_CAST")
-        val functions = slurper.parseText(dataDir.resolve("document.json").readText()) as List<Map<String, Any>>
-
-        // Extract unique genres from showcase data
-        val genreSet = mutableSetOf<String>()
-        games.forEach { game ->
-            @Suppress("UNCHECKED_CAST")
-            val genres = game["genres"] as List<String>
-            genres.forEach { genreSet.add(it) }
-        }
-        val genres = genreSet.sorted()
-
-        // Extract unique libraries from function data
-        val libSet = mutableSetOf<String>()
-        functions.forEach { fn ->
-            libSet.add(fn["library"] as String)
-        }
-        val libraries = libSet.sorted()
-
-        // Raw JSON for embedding in documentation page
-        val functionsJson = dataDir.resolve("document.json").readText()
-
-        // Set up Pebble template engine
-        val loader = io.pebbletemplates.pebble.loader.FileLoader()
-        loader.setPrefix(templateDir.absolutePath + "/")
-        loader.setSuffix("")
-        val engine = io.pebbletemplates.pebble.PebbleEngine.Builder()
-            .loader(loader)
-            .autoEscaping(true)
-            .build()
-
-        outputDir.mkdirs()
-
-        // Render index.html (no JSON data needed)
-        val indexTemplate = engine.getTemplate("pages/index.peb")
-        java.io.File(outputDir, "index.html").writer().use { writer ->
-            indexTemplate.evaluate(writer, mapOf<String, Any>())
-        }
-
-        // Render showcase.html
-        val showcaseTemplate = engine.getTemplate("pages/showcase.peb")
-        java.io.File(outputDir, "showcase.html").writer().use { writer ->
-            showcaseTemplate.evaluate(
-                writer,
-                mapOf<String, Any>(
-                    "games" to games,
-                    "genres" to genres,
-                    "initialCount" to 6,
-                ),
-            )
-        }
-
-        // Render documentation.html
-        val docTemplate = engine.getTemplate("pages/documentation.peb")
-        java.io.File(outputDir, "documentation.html").writer().use { writer ->
-            docTemplate.evaluate(
-                writer,
-                mapOf<String, Any>(
-                    "tutorials" to tutorials,
-                    "functions" to functions,
-                    "functionsJson" to functionsJson,
-                ),
-            )
-        }
-
-        // Render api.html
-        val apiTemplate = engine.getTemplate("pages/api.peb")
-        java.io.File(outputDir, "api.html").writer().use { writer ->
-            apiTemplate.evaluate(
-                writer,
-                mapOf<String, Any>(
-                    "functions" to functions,
-                    "libraries" to libraries,
-                ),
-            )
-        }
-
-        logger.lifecycle("Rendered 4 Pebble templates to ${outputDir.absolutePath}")
-    }
 }
 
 tasks.withType(AsciidoctorTask::class.java).configureEach {
@@ -220,7 +126,6 @@ tasks.withType(AsciidoctorTask::class.java).configureEach {
 
     this.dependsOn(
         unzipAsciidoctorResources.dependsOn(":tiny-web-editor:tinyWebEditor"),
-        copyAsciidoctorDependencies,
         copyJsonApi,
         copySample,
         copyResources,