A Khosra Demo

Readings from a rain gauge on a roof

Menu

Callouts, Every Way

Every kind of callout in every form khata draws, the chips, and the options — one call, two words in its braces.

Contents

One call, callout, for every box beside the text. Two words in its braces, either or both, in any order: what it is — its mark, its colour and the word it is headed by — and how it is drawn. Each section below draws all twelve kinds in one form, so the kinds can be compared inside it and the forms against each other. The blocks page has the short version.

The soft box

No form word: the box khata sets above a page by itself, headed by the mark and the kind’s word.

:::callout{warn}
A gauge under a tree reads low all season.
:::

Window

A frame, and a bar across its top holding the mark and the kind’s word.

:::callout{warn window}
A gauge under a tree reads low all season.
:::

Tinted

The kind’s colour as the ground; no mark and no head unless a title or a date is given.

:::callout{warn tinted}
A gauge under a tree reads low all season.
:::

Tinted, titled

With title=, the mark comes back beside it.

:::callout{warn tinted title="Placement"}
A gauge under a tree reads low all season.
:::

Run-in

No box: the mark opens the first line, as a run-in head opens a paragraph.

:::callout{warn run-in}
A gauge under a tree reads low all season.
:::

Hanging

No box: the mark stands in a column of its own beside the words.

:::callout{warn hanging}
A gauge under a tree reads low all season.
:::

A changelog

hanging and the four changelog kinds, in a run, close together; a date where one is given.

:::callout{added hanging on=2026-06-01}
A second gauge, on the roof's north edge.
:::

Chips

Inline, a word or two in a kind’s colour and mark. Each kind: note tip warn next blocked issues added changed fixed removed untranslated stub

In a sentence: the new gauge is beta, the old funnel gone, a plain one draft, and one with any mark rain.

:callout[beta]{warn}  :callout[draft]  :callout[rain]{icon=cloud-rain}

Options

title=, on= and icon= work in every form; a callout with no kind is the plain soft box.

:::callout{warn title="Recounted" on=2026-06-14}
Rewritten after the June recount.
:::

On a line of its own, ::callout{stub} is the theme’s sentence alone:

What a callout holds

Its body is a block — paragraphs, lists, code and other calls. The fence is longer on the outside so the inner one closes first.

::::callout{warn window title="Before you run this"}
It rewrites files in place. Two things to check first:

1. The gauge log is committed.
2. You are not in `/`.

:::callout{tip}
`--dry-run` prints what it would do and touches nothing.
:::
::::

khosra · khata 4d8d4c99 · content f6393d22 · 228 publications, 4256671 bytes · built in 1.460642387s