Reports Catalog (via manuals)

Use the generic manuals layout for all catalogs. Control what appears with :page-cards-tag:. Each child report is a normal page tagged report.

1. Quick Start

// In the parent page
:page-layout: manuals
:page-cards-tag: report           // displays report pages
:page-cards-within-module: true   // limit search to current component/module

// On each report page
:page-tags: report
:description: Short blurb shown on the card
:page-illustration: fa-solid fa-chart-line   // or image path (ROOT:diagram.png)

2. Attributes

  • page-layout: set to manuals on the parent page.

  • page-cards-tag: tag to collect (default: report).

  • page-cards-within-module: true to look in current module only; set false to search the whole site.

  • page-cards-<tag>-title: optional per-tag heading when grouping by multiple tags.

3. Card Content (child pages)

  • page-tags: include report so the page is collected.

  • page-illustration: Font Awesome (e.g., fa-solid fa-chart-line) or image path.

  • description: short text shown under the title.

See also: Card System Documentation for card data sources and illustration options.

Report Pages

Guidance for single report pages and how they appear in report catalogs