Блоки

Блок — переиспользуемая единица интерфейса: меню, кнопка, карточка, обёртка страницы. В nuckty блок описывается одним файлом .nu.ts, рядом с которым при необходимости лежат .css и .js. Блоками служат и вёрстка страницы, и обёртка документа HTML root.

Как устроен блок

• Устройство блока — структура файла .nu.ts, режимы, как блок превращается в HTML.
• Зависимости блоков — как движок находит блоки через зависимости, без ручной регистрации.
• Уровни блоков — где движок ищет файлы блоков и каков порядок уровней.

Блок или контент?

Блок — это код интерфейса. Контент страницы (статья, документация) — это Markdown, который движок преобразует в дерево блоков. Интерфейсные элементы хранятся в blocks/, текст — в .md из content/. Конструкции markdown-разметки (:::gallery) связывают контент и блоки: это синтаксис контента, который раскрывается в блоки через markdown-расширения.

root и page

Имена блоков распределены так:

• root — обёртка документа (<html>, <head>, <body>). Её даёт расширение nuckty-ext-block-root.
• page* — пользовательский слой. Имена page, page-index, page-about и подобные остаются за сайтом; nuckty их не занимает.