= Page Layouts
:navtitle: Page Layouts
:page-layout: manuals
:page-tags: catalog, page-layouts
:page-cards-tag: catalog
:page-cards-within-module: false
:page-cards-title: Available Layouts
:page-illustration: fa-solid fa-th-large

The Antora Feel++ UI provides a small set of page layouts. The manuals layout is the single, generic catalog engine used to render all card grids. Use it for catalogs of any type by setting :page-cards-tag:.

1. Available Layouts

default

Standard article layout for regular documentation pages

manuals

Generic card catalog (use for manuals, reports, examples, benchmarks, applications, machines, use cases, nested catalogs)

toolboxes

Alternative catalog layout for toolbox-style content organization

case-study

Specialized layout for case studies and detailed examples

2. Layout Usage

To use a specific layout, add the page-layout attribute to your AsciiDoc file:

= Page Title
:page-layout: manuals

3. Catalogs with manuals

Use manuals for every catalog; control what appears with :page-cards-tag: and scope with :page-cards-within-module:.

// Parent (catalog) page
:page-layout: manuals
:page-cards-tag: example, benchmark, report
:page-cards-within-module: true

// Child (card) pages
:page-tags: example
:description: Short card summary
:page-illustration: fa-solid fa-flask

Notes: - page-cards-tag accepts multiple tags and can render grouped sections (page-cards-<tag>-title provides group titles). - Add a category tag to the catalog’s own page-tags (e.g., benchmarks) to recolor its card when shown inside another catalog. The card remains labeled "Catalog"; only the tint and badge color change.