Admonitions

Admonitions are call-out boxes. papyri recognises the full set of standard RST admonition kinds, the version-change directives, and a few Sphinx extras. Each carries an open-ended kind and a finite base_type styling category, computed at gen time, that the viewer keys its colours off.

Base styling categories

The viewer never styles the ~16 open-ended kind strings directly. Gen collapses each kind into one of six base_type categories and the renderer emits an admonition-<base_type> class, so the stylesheet themes a small fixed vocabulary. The body stays a neutral surface; only the title bar carries the category colour and a category icon. One representative of each category follows — eyeball them to check the accent, title tint, and icon:

Standard admonitions

Generic admonition

The generic admonition directive takes an explicit title, for call-outs that do not fit a standard kind:

Topic

A topic is a self-contained mini-section — a digression that has its own title but does not belong in the document's heading hierarchy:

Rubric

A rubric is an unnumbered heading that stays out of the table of contents — handy for "References" or "Notes" headings that should not appear in navigation:

The rubric renders as a heading-like call-out without becoming a section.

Version-change directives

These behave like admonitions but carry a version argument:

See also

The seealso directive groups related references. Its body is a definition list mapping a target to a short description: