1. Your first page

Write a minimal wdoc page and preview it with the dev server.

Every wdoc document is a .wcl file that starts with import <wdoc.wcl> — that import brings in the whole block vocabulary. The smallest useful document is a single page holding content blocks: a heading, a paragraph, whatever the page needs. start = true marks the entry page.

Two commands cover the whole authoring loop: wcl wdoc build <file> --out <dir> renders the HTML once, and wcl wdoc serve <file> starts a dev server that watches the source and re-renders on save.

§ 1Exercise: Hello, wdoc

Create hello.wcl with one page, build it, then serve it and edit the paragraph while watching the browser.

cat > hello.wcl <<'WCL'
import <wdoc.wcl>

page index { start = true
  h1 "Hello wdoc"
  p "My **first** page, with _italic_ and `code`."
}
WCL
wcl wdoc build hello.wcl --out out
wcl wdoc serve hello.wcl