Как пользоваться

Здесь описан путь от установки nuckty и первой сборки до собственных расширений.

С чего начать

• Старт — установка и первый сайт за пять шагов.

Концепции

Основные понятия nuckty:

• Модель данных: BEMJSON — типизированное дерево узлов, единое для контента, вёрстки и обёртки страницы.
• Шаблоны nu — синтаксис block()(...), режимы, специфичность. Как блок превращается в HTML.
• Карта сайта: sitemap.yml — одно дерево задаёт адреса, заголовки, шаблоны страниц и навигацию.
• Конвейер сборки — фазы, именованные стадии и хуки; как менять сборку кодом.
• Таргеты и hreflang — один репозиторий, несколько сайтов, выбор языка.
• Внешние репозитории — контент из отдельных репозиториев.

Контент

• Markdown — тот же движок превращает CommonMark в дерево блоков. Якоря, ссылки, типографика.

Структура и расширения

• Блоки — как писать .nu.ts, объявлять зависимости и управлять уровнями.
• Расширения — пять типов: pipeline, markdown, block, command, document. Единая точка входа register(env).

Как читать

Начните со стартового проекта: в нём вы соберёте и измените первую страницу. Затем разберите модель данных, шаблоны и карту сайта, чтобы расширить свой сайт.

Опытному — сразу в нужную концепцию. А если интересно, почему сделано именно так, загляните в раздел «Почему так».