image — wdoc

image

block

Embeds a static image; renders as an <img> on a page or as a placeable SvgBlock inside a diagram.

image embeds a static image. The source path resolves relative to the build entry file and the file is copied verbatim into _wdoc/ at build time, so the output site is self-contained. Because it's referenced by a relative _wdoc/ URL, it only resolves when the site is served — not when the page is opened directly from disk (same as icons and tilemaps).

On a page

An image block directly under a page renders as a standalone <img>. The source is the inline label; set width / height to size it, alt for accessibility, and a class for styling.

page about { sites = [:demo]
  image "assets/hero.jpg" {
    alt   = "Our team"
    width = 480.0
    class = ["hero"]
  }
}

Inside a diagram

image is also a placeable SvgBlock, so it can sit in a diagram / container alongside rect / circle, positioned by x / y (or anchors).

diagram {
  width = 280  height = 140
  image "assets/logo.png" {
    x = 20.0  y = 20.0  width = 100.0  height = 100.0
  }
  rect { x = 150.0  y = 45.0  width = 100.0  height = 50.0  fill = "#a3be8c" }
}

- diagram

- video

- map