Страница по шаблону с выбором шапки

Шаблон страницы описывает её части, а одна настройка выбирает, какую шапку поставить: краткую или расширенную. Обе страницы ниже собраны из одних и тех же файлов шаблона, отличаются только значением настройки.

Это продвинутая возможность для тех, кто собирает страницы программой. Обычным страницам документации она не нужна.

Краткая шапка

inputs-compact.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": "Вернуть деньги покупателю можно полностью или частично в течение 180 дней после оплаты. Возврат создаётся отдельным запросом к API и получает свой статус."}],      "valueDigest": "sha256:57a46a3507842c87d969a71e0d6ea14044deaf90791e1334496dd539c7fc9dcf",      "origin": { "scope": "docara-site", "owner": "docara/content", "ref": "page.demo", "revision": "1" }    }  }}

header-compact.json

{
  "id": "header",
  "node": {
    "type": "layout.section",
    "slots": { "default": [{ "id": "title", "node": { "type": "content.heading", "data": { "level": { "literal": 1 }, "content": { "literal": [{ "type": "text", "value": "Возврат платежа" }] } } } }] }
  }
}

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" }] } }]    }  }}

Расширенная шапка

inputs-expanded.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": "Вернуть деньги покупателю можно полностью или частично в течение 180 дней после оплаты. Возврат создаётся отдельным запросом к API и получает свой статус."        }      ],      "valueDigest": "sha256:57a46a3507842c87d969a71e0d6ea14044deaf90791e1334496dd539c7fc9dcf",      "origin": {        "scope": "docara-site",        "owner": "docara/content",        "ref": "page.demo",        "revision": "1"      }    }  }}

header-expanded.json

{
  "id": "header",
  "node": {
    "type": "layout.section",
    "slots": { "default": [
      { "id": "context", "node": { "type": "content.paragraph", "data": { "content": { "literal": [{ "type": "text", "value": "Справочник API · версия 2026-10 · обновлено 2 ноября 2026 года" }] } } } },
      { "id": "title", "node": { "type": "content.heading", "data": { "level": { "literal": 1 }, "content": { "literal": [{ "type": "text", "value": "Возврат платежа" }] } } } },
      { "id": "facts", "node": { "type": "content.heading", "data": { "level": { "literal": 2 }, "content": { "literal": [{ "type": "text", "value": "Коротко" }] } } } },
      { "id": "request", "node": { "type": "content.paragraph", "data": { "content": { "literal": [{ "type": "text", "value": "Запрос: ", "marks": ["strong"] }, { "type": "text", "value": "POST /v1/payments/{id}/refunds", "marks": ["code"] }] } } } },
      { "id": "deadline", "node": { "type": "content.paragraph", "data": { "content": { "literal": [{ "type": "text", "value": "Срок: ", "marks": ["strong"] }, { "type": "text", "value": "180 дней после оплаты" }] } } } },
      { "id": "event", "node": { "type": "content.paragraph", "data": { "content": { "literal": [{ "type": "text", "value": "Итог: ", "marks": ["strong"] }, { "type": "text", "value": "событие " }, { "type": "text", "value": "refund.succeeded", "marks": ["code"] }] } } } },
      { "id": "about", "node": { "type": "content.heading", "data": { "level": { "literal": 2 }, "content": { "literal": [{ "type": "text", "value": "Описание" }] } } } }
    ] }
  }
}

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" }] } }]    }  }}

Как это устроено

recipe.json — шаблон: в шапку ставится фрагмент по значению headerMode, в основную часть — текст из значения body.
Файл значений задаёт headerMode: compact или expanded. Остальное у двух страниц общее.
Шапки — отдельные файлы. В краткой только заголовок. В расширенной над заголовком строка о разделе и версии API, под ним — сводка: запрос, срок и событие, которое придёт по итогу.
Страница Docara ссылается на свой набор файлов строкой composition_recipe в начале Markdown. SIMAI Framework собирает страницу при сборке сайта, в браузере ничего не вычисляется.

compact.md

---title: "Страница по шаблону: краткая шапка"description: Страница Docara, собранная Framework из файлового шаблона, содержимого и настройки.composition_recipe: composition/descriptor-compact.jsonnoindex: true---

Что можно поменять

Параметр	Что меняет
`headerMode`	Вариант шапки: `compact` или `expanded`
`composition_recipe`	Какой набор файлов шаблона собирает страницу

Главное

Документация

Страница по шаблону с выбором шапки

Краткая шапка

Расширенная шапка

Как это устроено

Что можно поменять

См. также