KSlides

Root orchestrator for a set of presentations. Instances are not meant to be constructed directly — use the kslides top-level function instead, which applies the DSL block and then triggers the configured output modes.

Holds global configuration (kslidesConfig, presentationConfig, output), shared CSS (css), and the collection of Presentation definitions produced by each presentation block. Also caches iframe and Kroki content so repeated lookups from the Ktor server do not re-execute expensive content generators.

Constructors

KSlides

constructor()

Types

Companion

object Companion

Properties

css

val css: CssValue

Global CSS applied to every Presentation in this KSlides. Appended to via the css DSL block or via css += "..." / css += { ... }.

Functions

css

fun css(block: CssBuilder.() -> Unit)

Append CSS (declared via Kotlin's CSS DSL) to the global stylesheet that is injected into every generated presentation page.

kslidesConfig

fun kslidesConfig(block: KSlidesConfig.() -> Unit)

Configure values that apply to all presentations (e.g. static asset roots, Playground URL, Kroki URL, Lets-Plot JS version, HTTP client timeout). The block is evaluated after the full kslides {} DSL so that later kslidesConfig{} calls override earlier ones.

output

fun output(block: OutputConfig.() -> Unit)

Configure how the presentations are emitted: filesystem mode (enableFileSystem), HTTP mode (enableHttp), output directory, HTTP port, etc.

presentation

fun presentation(block: Presentation.() -> Unit)

Register a Presentation definition. Each call adds one entry; the path assigned inside the block determines its URL (HTTP mode) or output filename (filesystem mode).

presentationConfig

fun presentationConfig(block: PresentationConfig.() -> Unit)

Default PresentationConfig applied to every Presentation. Per-presentation overrides take precedence; see the configuration-cascade description in the project README.