Fills a value asked for by token, under whatever key you name

All 6 scenarios hold

A site generator reads an AsciiDoc or Markdown page. The generator decides how that page looks and where it sits in the site. Front matter is what a project tells the generator. Declare it once, in the frontMatter section of the tabletest-reporter.yaml sidecar. The reporter then writes it above every page of a text report. An HTML page carries none, because it is a finished page and not source for a generator.

Both rules below read a report of two test classes in one package, com.example.orders.OrderTest and com.example.orders.ProductTest, with one table each.

The reporter knows three values a site generator cannot work out. Ask for one by its token: $title, $position or $timestamp. Write the token as the value, never as the key. Generators do not agree on what to call a position. Hugo calls it weight, Docusaurus sidebar_position, a Jekyll theme nav_order, and Antora page-weight. Antora exposes a custom attribute under no other prefix.

A page's position is the place the spec metadata declares. A generator that orders pages by that value lists them in the reading order the project chose, and not alphabetically.

The rows below are Markdown. Every text format writes the same values. $timestamp carries the instant the report states it was generated at. A build that pins no instant reads the clock, which is what a blank cell below means.