A page from a template with a header choice

The page template describes its parts, and one setting picks which header to use: compact or expanded. Both pages below are built from the same template files and differ only in the setting value.

This is an advanced feature for those who build pages with a program. Regular documentation pages do not need it.

Compact header

inputs-compact.en.json

{  "schema": "simai.composition.inputs.v1",  "scope": "docara-site",  "values": {    "headerMode": {      "kind": "setting",      "value": "compact",      "valueDigest": "sha256:886faf3fbc9f853264de745e42584714338cc21178976b45aa9c67f19d42c2c1",      "origin": { "scope": "docara-site", "owner": "docara/settings", "ref": "header.mode", "revision": "1" }    },    "body": {      "kind": "content",      "value": [{"type": "text", "value": "You can refund money to the customer in full or in part within 180 days after payment. A refund is created with a separate API request and gets its own status."}],      "valueDigest": "sha256:39db829b9cf8d10c18ce37d7ca2b51da6f85ced2479fa54e555afc82beb976ef",      "origin": { "scope": "docara-site", "owner": "docara/content", "ref": "page.demo", "revision": "1" }    }  }}

header-compact.en.json

{
  "id": "header",
  "node": {
    "type": "layout.section",
    "slots": { "default": [{ "id": "title", "node": { "type": "content.heading", "data": { "level": { "literal": 1 }, "content": { "literal": [{ "type": "text", "value": "Refund a payment" }] } } } }] }
  }
}

recipe.json

{  "schema": "simai.composition.recipe.v1",  "id": "docara.file-demo",  "profile": "ui-layout",  "inputs": {    "headerMode": { "kind": "setting", "schema": { "type": "string", "enum": ["compact", "expanded"] }, "expectedOrigin": { "owner": "docara/settings", "ref": "header.mode", "revision": "1" } },    "body": { "kind": "content", "schema": { "type": "array" }, "expectedOrigin": { "owner": "docara/content", "ref": "page.demo", "revision": "1" } }  },  "root": {    "id": "page",    "ref": { "kind": "template", "owner": "docara/files", "ref": "page", "policy": "pinned", "revision": "1" },    "slots": {      "header": [{        "id": "header-choice",        "select": {          "value": { "input": "headerMode" },          "cases": {            "compact": { "id": "compact", "ref": { "kind": "fragment", "owner": "docara/files", "ref": "header.compact", "policy": "pinned", "revision": "1" } },            "expanded": { "id": "expanded", "ref": { "kind": "fragment", "owner": "docara/files", "ref": "header.expanded", "policy": "pinned", "revision": "1" } }          }        }      }],      "main": [{ "id": "body", "node": { "type": "content.paragraph", "data": { "content": { "input": "body" } }, "bindings": [{ "input": "body", "target": "content" }] } }]    }  }}

Expanded header

inputs-expanded.en.json

{  "schema": "simai.composition.inputs.v1",  "scope": "docara-site",  "values": {    "headerMode": {      "kind": "setting",      "value": "expanded",      "valueDigest": "sha256:c60ad395f956f970f43b45b950c381db8108ca2064e11748e72262d8c2ab46b0",      "origin": {        "scope": "docara-site",        "owner": "docara/settings",        "ref": "header.mode",        "revision": "1"      }    },    "body": {      "kind": "content",      "value": [        {          "type": "text",          "value": "You can refund money to the customer in full or in part within 180 days after payment. A refund is created with a separate API request and gets its own status."        }      ],      "valueDigest": "sha256:39db829b9cf8d10c18ce37d7ca2b51da6f85ced2479fa54e555afc82beb976ef",      "origin": {        "scope": "docara-site",        "owner": "docara/content",        "ref": "page.demo",        "revision": "1"      }    }  }}

header-expanded.en.json

{
  "id": "header",
  "node": {
    "type": "layout.section",
    "slots": { "default": [
      { "id": "context", "node": { "type": "content.paragraph", "data": { "content": { "literal": [{ "type": "text", "value": "API reference · version 2026-10 · updated on 2 November 2026" }] } } } },
      { "id": "title", "node": { "type": "content.heading", "data": { "level": { "literal": 1 }, "content": { "literal": [{ "type": "text", "value": "Refund a payment" }] } } } },
      { "id": "facts", "node": { "type": "content.heading", "data": { "level": { "literal": 2 }, "content": { "literal": [{ "type": "text", "value": "At a glance" }] } } } },
      { "id": "request", "node": { "type": "content.paragraph", "data": { "content": { "literal": [{ "type": "text", "value": "Request: ", "marks": ["strong"] }, { "type": "text", "value": "POST /v1/payments/{id}/refunds", "marks": ["code"] }] } } } },
      { "id": "deadline", "node": { "type": "content.paragraph", "data": { "content": { "literal": [{ "type": "text", "value": "Deadline: ", "marks": ["strong"] }, { "type": "text", "value": "180 days after payment" }] } } } },
      { "id": "event", "node": { "type": "content.paragraph", "data": { "content": { "literal": [{ "type": "text", "value": "Result: ", "marks": ["strong"] }, { "type": "text", "value": "the event " }, { "type": "text", "value": "refund.succeeded", "marks": ["code"] }] } } } },
      { "id": "about", "node": { "type": "content.heading", "data": { "level": { "literal": 2 }, "content": { "literal": [{ "type": "text", "value": "Description" }] } } } }
    ] }
  }
}

recipe.json

{  "schema": "simai.composition.recipe.v1",  "id": "docara.file-demo",  "profile": "ui-layout",  "inputs": {    "headerMode": { "kind": "setting", "schema": { "type": "string", "enum": ["compact", "expanded"] }, "expectedOrigin": { "owner": "docara/settings", "ref": "header.mode", "revision": "1" } },    "body": { "kind": "content", "schema": { "type": "array" }, "expectedOrigin": { "owner": "docara/content", "ref": "page.demo", "revision": "1" } }  },  "root": {    "id": "page",    "ref": { "kind": "template", "owner": "docara/files", "ref": "page", "policy": "pinned", "revision": "1" },    "slots": {      "header": [{        "id": "header-choice",        "select": {          "value": { "input": "headerMode" },          "cases": {            "compact": { "id": "compact", "ref": { "kind": "fragment", "owner": "docara/files", "ref": "header.compact", "policy": "pinned", "revision": "1" } },            "expanded": { "id": "expanded", "ref": { "kind": "fragment", "owner": "docara/files", "ref": "header.expanded", "policy": "pinned", "revision": "1" } }          }        }      }],      "main": [{ "id": "body", "node": { "type": "content.paragraph", "data": { "content": { "input": "body" } }, "bindings": [{ "input": "body", "target": "content" }] } }]    }  }}

How it works

recipe.json is the template: the header gets a fragment chosen by the headerMode value, and the main part gets the text from the body value.
The values file sets headerMode: compact or expanded. Everything else is shared by the two pages.
The headers are separate files. The compact one has only the title. The expanded one has a line about the section and API version above the title and a summary below it: the request, the deadline and the event that arrives with the result.
A Docara page points to its set of files with the composition_recipe line at the start of the Markdown. SIMAI Framework builds the page during the site build; nothing is computed in the browser.

compact.md

---title: "Page from a template: compact header"description: A Docara page that the Framework builds from a file template, content and a setting.composition_recipe: composition/descriptor-compact.en.jsonnoindex: true---

What you can change

Parameter	What it changes
`headerMode`	The header variant: `compact` or `expanded`
`composition_recipe`	Which set of template files builds the page

Primary

Documentation

A page from a template with a header choice

Compact header

Expanded header

How it works

What you can change

See also