Настройки
Настройки Docara — это проверяемые JSON-данные с тремя уровнями inheritance. Начните с задачи, меняйте только разрешённый project-owned файл, затем проверяйте effective plan и provenance.
Карта
- Уровни и inheritance
- Сайт, раздел, страница
- Локали и routing
- Branding и тема
- Layout и regions
- Навигация
- Поиск и чтение
- Настройки читателя
- Framework lock и providers
- Безопасность
- Диагностика и provenance
Безопасный workflow
- Найдите поле в schema-derived reference ниже.
- Проверьте scope и effective provenance.
- Измените
docara.json, ближайшийsection.json, page sidecar/front matter или localelang.json— только согласно schema. - Выполните
docara doctor, выбранныйbuild --pageи static verify; при изменении глобальной структуры сделайте full build.
Общие presentation-поля
Таблица строится из presentation.schema.json; prose выше лишь объясняет задачу.
| Поле | Scope | Обяз. | Тип | Default | Validation | Provenance |
|---|---|---|---|---|---|---|
/branding | shared | нет | object | не объявлен; effective value определяется inheritance/runtime | minProperties=1; additionalProperties=false | resources/schemas/presentation.schema.json#/$defs/branding |
/branding/$reset | shared | нет | bool | не объявлен; effective value определяется inheritance/runtime | const=true | resources/schemas/presentation.schema.json#/$defs/branding/properties/$reset |
/branding/favicon | shared | нет | string | не объявлен; effective value определяется inheritance/runtime | format="docara-relative-path" | resources/schemas/presentation.schema.json#/$defs/branding/properties/favicon |
/branding/label | shared | нет | string | не объявлен; effective value определяется inheritance/runtime | minLength=1 | resources/schemas/presentation.schema.json#/$defs/branding/properties/label |
/branding/logo | shared | нет | string | не объявлен; effective value определяется inheritance/runtime | format="docara-relative-path" | resources/schemas/presentation.schema.json#/$defs/branding/properties/logo |
/branding/logo_dark | shared | нет | string | не объявлен; effective value определяется inheritance/runtime | format="docara-relative-path" | resources/schemas/presentation.schema.json#/$defs/branding/properties/logo_dark |
/branding/mode | shared | нет | string | не объявлен; effective value определяется inheritance/runtime | enum=["full","compact","logo","text"] | resources/schemas/presentation.schema.json#/$defs/branding/properties/mode |
/branding/share_image | shared | нет | string | не объявлен; effective value определяется inheritance/runtime | format="docara-relative-path" | resources/schemas/presentation.schema.json#/$defs/branding/properties/share_image |
/branding/size | shared | нет | string | не объявлен; effective value определяется inheritance/runtime | enum=["small","medium","large"] | resources/schemas/presentation.schema.json#/$defs/branding/properties/size |
/branding/title | shared | нет | string | не объявлен; effective value определяется inheritance/runtime | minLength=1 | resources/schemas/presentation.schema.json#/$defs/branding/properties/title |
/code | shared | нет | object | не объявлен; effective value определяется inheritance/runtime | minProperties=1; additionalProperties=false | resources/schemas/presentation.schema.json#/$defs/code |
/code/$reset | shared | нет | bool | не объявлен; effective value определяется inheritance/runtime | const=true | resources/schemas/presentation.schema.json#/$defs/code/properties/$reset |
/code/wrap | shared | нет | boolean | не объявлен; effective value определяется inheritance/runtime | schema type only | resources/schemas/presentation.schema.json#/$defs/code/properties/wrap |
/examples | shared | нет | object | не объявлен; effective value определяется inheritance/runtime | minProperties=1; additionalProperties=false | resources/schemas/presentation.schema.json#/$defs/examples |
/examples/$reset | shared | нет | bool | не объявлен; effective value определяется inheritance/runtime | const=true | resources/schemas/presentation.schema.json#/$defs/examples/properties/$reset |
/examples/fullscreen | shared | нет | boolean | не объявлен; effective value определяется inheritance/runtime | schema type only | resources/schemas/presentation.schema.json#/$defs/examples/properties/fullscreen |
/examples/wrap | shared | нет | boolean | не объявлен; effective value определяется inheritance/runtime | schema type only | resources/schemas/presentation.schema.json#/$defs/examples/properties/wrap |
/header_navigation | shared | нет | object | не объявлен; effective value определяется inheritance/runtime | minProperties=1; additionalProperties=false; allOf=1 | resources/schemas/presentation.schema.json#/$defs/header_navigation |
/header_navigation/$reset | shared | нет | bool | не объявлен; effective value определяется inheritance/runtime | const=true | resources/schemas/presentation.schema.json#/$defs/header_navigation/properties/$reset |
/header_navigation/enabled | shared | нет | boolean | не объявлен; effective value определяется inheritance/runtime | schema type only | resources/schemas/presentation.schema.json#/$defs/header_navigation/properties/enabled |
/header_navigation/enabled | shared | да | bool | не объявлен; effective value определяется inheritance/runtime | const=true | resources/schemas/presentation.schema.json#/$defs/header_navigation/allOf/0/if/properties/enabled |
/header_navigation/items | shared | нет | array | не объявлен; effective value определяется inheritance/runtime | minItems=1; maxItems=8 | resources/schemas/presentation.schema.json#/$defs/header_navigation/properties/items |
/header_navigation/items/* | shared | нет | object | не объявлен; effective value определяется inheritance/runtime | additionalProperties=false | resources/schemas/presentation.schema.json#/$defs/header_navigation/properties/items/items |
/header_navigation/items/*/href | shared | да | string | не объявлен; effective value определяется inheritance/runtime | pattern="^(?:#(?!$)|/(?!/)|https://)[^\\x{0000}-\\x{0020}\\\"'<>\\\\]+$"; maxLength=2000 | resources/schemas/presentation.schema.json#/$defs/header_navigation/properties/items/items/properties/href |
/header_navigation/items/*/id | shared | да | string | не объявлен; effective value определяется inheritance/runtime | pattern="^[a-z][a-z0-9_.-]{0,63}$" | resources/schemas/presentation.schema.json#/$defs/header_navigation/properties/items/items/properties/id |
/header_navigation/items/*/label | shared | да | string | не объявлен; effective value определяется inheritance/runtime | minLength=1; maxLength=80 | resources/schemas/presentation.schema.json#/$defs/header_navigation/properties/items/items/properties/label |
/layout | shared | нет | object | не объявлен; effective value определяется inheritance/runtime | minProperties=1; additionalProperties=false | resources/schemas/presentation.schema.json#/$defs/layout |
/layout/$reset | shared | нет | bool | не объявлен; effective value определяется inheritance/runtime | const=true | resources/schemas/presentation.schema.json#/$defs/layout/properties/$reset |
/layout/container | shared | нет | object | не объявлен; effective value определяется inheritance/runtime | additionalProperties=false | resources/schemas/presentation.schema.json#/$defs/layout/properties/container |
/layout/container/max | shared | да | integer | не объявлен; effective value определяется inheritance/runtime | minimum=1; maximum=8 | resources/schemas/presentation.schema.json#/$defs/layout/properties/container/properties/max |
/layout/content | shared | нет | object | не объявлен; effective value определяется inheritance/runtime | additionalProperties=false | resources/schemas/presentation.schema.json#/$defs/layout/properties/content |
/layout/content/gap | shared | да | integer | не объявлен; effective value определяется inheritance/runtime | minimum=0; maximum=8 | resources/schemas/presentation.schema.json#/$defs/layout/properties/content/properties/gap |
/layout/key | shared | нет | string | не объявлен; effective value определяется inheritance/runtime | pattern="^[a-z][a-z0-9_.-]+$" | resources/schemas/presentation.schema.json#/$defs/layout/properties/key |
/layout/regions | shared | нет | object | не объявлен; effective value определяется inheritance/runtime | minProperties=1; additionalProperties=false | resources/schemas/presentation.schema.json#/$defs/regions |
/layout/regions/$reset | shared | нет | bool | не объявлен; effective value определяется inheritance/runtime | const=true | resources/schemas/presentation.schema.json#/$defs/regions/properties/$reset |
/layout/regions/<^[a-z][a-z0-9_.-]+$> | shared | нет | object | не объявлен; effective value определяется inheritance/runtime | minProperties=1; additionalProperties=false | resources/schemas/presentation.schema.json#/$defs/region |
/layout/regions/<^[a-z][a-z0-9_.-]+$>/$reset | shared | нет | bool | не объявлен; effective value определяется inheritance/runtime | const=true | resources/schemas/presentation.schema.json#/$defs/region/properties/$reset |
/layout/regions/<^[a-z][a-z0-9_.-]+$>/enabled | shared | нет | boolean | не объявлен; effective value определяется inheritance/runtime | schema type only | resources/schemas/presentation.schema.json#/$defs/region/properties/enabled |
/layout/regions/<^[a-z][a-z0-9_.-]+$>/sections | shared | нет | array | не объявлен; effective value определяется inheritance/runtime | maxItems=8 | resources/schemas/presentation.schema.json#/$defs/region/properties/sections |
/layout/regions/<^[a-z][a-z0-9_.-]+$>/sections/* | shared | нет | object | не объявлен; effective value определяется inheritance/runtime | additionalProperties=false | resources/schemas/presentation.schema.json#/$defs/region_section |
/layout/regions/<^[a-z][a-z0-9_.-]+$>/sections/*/blocks | shared | нет | array | не объявлен; effective value определяется inheritance/runtime | minItems=1; maxItems=12 | resources/schemas/presentation.schema.json#/$defs/region_section/properties/blocks |
/layout/regions/<^[a-z][a-z0-9_.-]+$>/sections/*/blocks/* | shared | нет | oneOf | не объявлен; effective value определяется inheritance/runtime | oneOf=2 | resources/schemas/presentation.schema.json#/$defs/region_block |
/layout/regions/<^[a-z][a-z0-9_.-]+$>/sections/*/blocks/*/bind | shared | нет | string | не объявлен; effective value определяется inheritance/runtime | pattern="^[a-z][a-z0-9-]*\\.[a-z][a-z0-9_.-]+$" | resources/schemas/presentation.schema.json#/$defs/region_block/oneOf/1/properties/bind |
/layout/regions/<^[a-z][a-z0-9_.-]+$>/sections/*/blocks/*/block | shared | да | string | не объявлен; effective value определяется inheritance/runtime | pattern="^[a-z][a-z0-9_.-]+$" | resources/schemas/presentation.schema.json#/$defs/region_block/oneOf/0/properties/block |
/layout/regions/<^[a-z][a-z0-9_.-]+$>/sections/*/blocks/*/block | shared | да | string | не объявлен; effective value определяется inheritance/runtime | pattern="^[a-z][a-z0-9_.-]+$" | resources/schemas/presentation.schema.json#/$defs/region_block/oneOf/1/properties/block |
/layout/regions/<^[a-z][a-z0-9_.-]+$>/sections/*/blocks/*/element | shared | да | object | не объявлен; effective value определяется inheritance/runtime | additionalProperties=false | resources/schemas/presentation.schema.json#/$defs/region_block/oneOf/0/properties/element |
/layout/regions/<^[a-z][a-z0-9_.-]+$>/sections/*/blocks/*/element/aria_label | shared | нет | string | не объявлен; effective value определяется inheritance/runtime | minLength=1; maxLength=160 | resources/schemas/presentation.schema.json#/$defs/region_block/oneOf/0/properties/element/properties/aria_label |
/layout/regions/<^[a-z][a-z0-9_.-]+$>/sections/*/blocks/*/element/href | shared | нет | string | не объявлен; effective value определяется inheritance/runtime | pattern="^(?:/|[/#][^\\u0000-\\u0020\\\"'<>\\\\]+)$" | resources/schemas/presentation.schema.json#/$defs/region_block/oneOf/0/properties/element/properties/href |
/layout/regions/<^[a-z][a-z0-9_.-]+$>/sections/*/blocks/*/element/tag | shared | да | string | не объявлен; effective value определяется inheritance/runtime | enum=["div","p","span","a"] | resources/schemas/presentation.schema.json#/$defs/region_block/oneOf/0/properties/element/properties/tag |
/layout/regions/<^[a-z][a-z0-9_.-]+$>/sections/*/blocks/*/element/text | shared | да | string | не объявлен; effective value определяется inheritance/runtime | minLength=1; maxLength=500 | resources/schemas/presentation.schema.json#/$defs/region_block/oneOf/0/properties/element/properties/text |
/layout/regions/<^[a-z][a-z0-9_.-]+$>/sections/*/blocks/*/element/utilities | shared | нет | array | не объявлен; effective value определяется inheritance/runtime | maxItems=16; uniqueItems=true | resources/schemas/presentation.schema.json#/$defs/region_block/oneOf/0/properties/element/properties/utilities |
/layout/regions/<^[a-z][a-z0-9_.-]+$>/sections/*/blocks/*/element/utilities/* | shared | нет | string | не объявлен; effective value определяется inheritance/runtime | pattern="^[a-z0-9][a-z0-9_:/.-]*$" | resources/schemas/presentation.schema.json#/$defs/region_block/oneOf/0/properties/element/properties/utilities/items |
/layout/regions/<^[a-z][a-z0-9_.-]+$>/sections/*/blocks/*/id | shared | да | string | не объявлен; effective value определяется inheritance/runtime | pattern="^[a-z][a-z0-9_.-]+$" | resources/schemas/presentation.schema.json#/$defs/region_block/oneOf/0/properties/id |
/layout/regions/<^[a-z][a-z0-9_.-]+$>/sections/*/blocks/*/id | shared | да | string | не объявлен; effective value определяется inheritance/runtime | pattern="^[a-z][a-z0-9_.-]+$" | resources/schemas/presentation.schema.json#/$defs/region_block/oneOf/1/properties/id |
/layout/regions/<^[a-z][a-z0-9_.-]+$>/sections/*/blocks/*/props | shared | да | object | не объявлен; effective value определяется inheritance/runtime | maxProperties=32 | resources/schemas/presentation.schema.json#/$defs/region_block/oneOf/1/properties/props |
/layout/regions/<^[a-z][a-z0-9_.-]+$>/sections/*/blocks/*/slot | shared | да | string | не объявлен; effective value определяется inheritance/runtime | pattern="^[a-z][a-z0-9_.-]+$" | resources/schemas/presentation.schema.json#/$defs/region_block/oneOf/0/properties/slot |
/layout/regions/<^[a-z][a-z0-9_.-]+$>/sections/*/blocks/*/slot | shared | да | string | не объявлен; effective value определяется inheritance/runtime | pattern="^[a-z][a-z0-9_.-]+$" | resources/schemas/presentation.schema.json#/$defs/region_block/oneOf/1/properties/slot |
/layout/regions/<^[a-z][a-z0-9_.-]+$>/sections/*/blocks/*/smart | shared | да | string | не объявлен; effective value определяется inheritance/runtime | pattern="^[a-z][a-z0-9_.-]+$" | resources/schemas/presentation.schema.json#/$defs/region_block/oneOf/1/properties/smart |
/layout/regions/<^[a-z][a-z0-9_.-]+$>/sections/*/blocks/*/view | shared | нет | string | не объявлен; effective value определяется inheritance/runtime | pattern="^[a-z][a-z0-9_.-]+$" | resources/schemas/presentation.schema.json#/$defs/region_block/oneOf/1/properties/view |
/layout/regions/<^[a-z][a-z0-9_.-]+$>/sections/*/id | shared | да | string | не объявлен; effective value определяется inheritance/runtime | pattern="^[a-z][a-z0-9_.-]+$" | resources/schemas/presentation.schema.json#/$defs/region_section/properties/id |
/layout/regions/<^[a-z][a-z0-9_.-]+$>/sections/*/section | shared | да | string | не объявлен; effective value определяется inheritance/runtime | pattern="^[a-z][a-z0-9_.-]+$" | resources/schemas/presentation.schema.json#/$defs/region_section/properties/section |
/layout/regions/<^[a-z][a-z0-9_.-]+$>/sections/*/utilities | shared | нет | array | не объявлен; effective value определяется inheritance/runtime | maxItems=16; uniqueItems=true | resources/schemas/presentation.schema.json#/$defs/region_section/properties/utilities |
/layout/regions/<^[a-z][a-z0-9_.-]+$>/sections/*/utilities/* | shared | нет | string | не объявлен; effective value определяется inheritance/runtime | pattern="^[a-z0-9][a-z0-9_:/.-]*$" | resources/schemas/presentation.schema.json#/$defs/region_section/properties/utilities/items |
/layout/scrollbar | shared | нет | object | не объявлен; effective value определяется inheritance/runtime | additionalProperties=false | resources/schemas/presentation.schema.json#/$defs/layout/properties/scrollbar |
/layout/scrollbar/preset | shared | да | string | не объявлен; effective value определяется inheritance/runtime | enum=["overlay","persistent","standard","hidden"] | resources/schemas/presentation.schema.json#/$defs/layout/properties/scrollbar/properties/preset |
/navigation | shared | нет | object | не объявлен; effective value определяется inheritance/runtime | minProperties=1; additionalProperties=false | resources/schemas/presentation.schema.json#/$defs/navigation |
/navigation/$reset | shared | нет | bool | не объявлен; effective value определяется inheritance/runtime | const=true | resources/schemas/presentation.schema.json#/$defs/navigation/properties/$reset |
/navigation/hidden | shared | нет | boolean | не объявлен; effective value определяется inheritance/runtime | schema type only | resources/schemas/presentation.schema.json#/$defs/navigation/properties/hidden |
/navigation/order | shared | нет | integer | не объявлен; effective value определяется inheritance/runtime | minimum=0; maximum=2147483647 | resources/schemas/presentation.schema.json#/$defs/navigation/properties/order |
/navigation/scope | shared | нет | string | не объявлен; effective value определяется inheritance/runtime | enum=["site","section"] | resources/schemas/presentation.schema.json#/$defs/navigation/properties/scope |
/reading | shared | нет | object | не объявлен; effective value определяется inheritance/runtime | minProperties=1; additionalProperties=false | resources/schemas/presentation.schema.json#/$defs/reading |
/reading/$reset | shared | нет | bool | не объявлен; effective value определяется inheritance/runtime | const=true | resources/schemas/presentation.schema.json#/$defs/reading/properties/$reset |
/reading/breadcrumbs | shared | нет | boolean | не объявлен; effective value определяется inheritance/runtime | schema type only | resources/schemas/presentation.schema.json#/$defs/reading/properties/breadcrumbs |
/reading/mobile_toc | shared | нет | string | не объявлен; effective value определяется inheritance/runtime | enum=["auto","always","never"] | resources/schemas/presentation.schema.json#/$defs/reading/properties/mobile_toc |
/reading/previous_next | shared | нет | boolean | не объявлен; effective value определяется inheritance/runtime | schema type only | resources/schemas/presentation.schema.json#/$defs/reading/properties/previous_next |
/reading/toc | shared | нет | boolean | не объявлен; effective value определяется inheritance/runtime | schema type only | resources/schemas/presentation.schema.json#/$defs/reading/properties/toc |
/reading/toc_depth | shared | нет | integer | не объявлен; effective value определяется inheritance/runtime | minimum=2; maximum=6 | resources/schemas/presentation.schema.json#/$defs/reading/properties/toc_depth |
/search | shared | нет | object | не объявлен; effective value определяется inheritance/runtime | minProperties=1; additionalProperties=false | resources/schemas/presentation.schema.json#/$defs/search |
/search/$reset | shared | нет | bool | не объявлен; effective value определяется inheritance/runtime | const=true | resources/schemas/presentation.schema.json#/$defs/search/properties/$reset |
/search/enabled | shared | нет | boolean | не объявлен; effective value определяется inheritance/runtime | schema type only | resources/schemas/presentation.schema.json#/$defs/search/properties/enabled |
/search/indexed | shared | нет | boolean | не объявлен; effective value определяется inheritance/runtime | schema type only | resources/schemas/presentation.schema.json#/$defs/search/properties/indexed |
/settings | shared | нет | object | не объявлен; effective value определяется inheritance/runtime | minProperties=1; additionalProperties=false | resources/schemas/presentation.schema.json#/$defs/settings |
/settings/$reset | shared | нет | bool | не объявлен; effective value определяется inheritance/runtime | const=true | resources/schemas/presentation.schema.json#/$defs/settings/properties/$reset |
/settings/modal_blur | shared | нет | string | не объявлен; effective value определяется inheritance/runtime | enum=["none","small","medium","large"] | resources/schemas/presentation.schema.json#/$defs/settings/properties/modal_blur |
/settings/theme | shared | нет | string | не объявлен; effective value определяется inheritance/runtime | enum=["system","light","dark"] | resources/schemas/presentation.schema.json#/$defs/settings/properties/theme |
/settings/ui_radius | shared | нет | string | не объявлен; effective value определяется inheritance/runtime | enum=["default","medium","large"] | resources/schemas/presentation.schema.json#/$defs/settings/properties/ui_radius |