Начало работы

Установка

Проекту нужен Python 3 только на время установки компонентов. Готовый сайт от системы не зависит.

1. Подготовить проект

Стиль один для всех сайтов. Тип проекта определяет каталоги и вид вставок: jekyll, jinja или static.

bukatchuk-ui --project . init --kind jinja

Команда создаёт bukatchuk-ui.json, копирует переменные, шрифты и базовые стили и собирает общий файл ui.css.

bukatchuk-ui add header footer hero button field dialog

Зависимости подтягиваются сами. Файлы компонентов лежат в проекте и правятся как обычный код.

<link rel="stylesheet" href="/static/ui.css?v=СБОРКА">
<script src="/static/ui.js?v=СБОРКА" defer></script>

Метка сборки в адресе обязательна: браузер держит файлы в кэше, и без неё новая разметка какое-то время работала бы со старыми стилями.

Команда	Что делает
`list`	компоненты реестра и установленные в проекте
`diff [имя]`	чем файлы проекта отличаются от реестра
`update [имя]`	обновляет компоненты; файлы с местными правками не затирает без `--force`
`build`	пересобирает `ui.css` и `ui.js` после правки файлов компонентов
`check`	код возврата 1, если файл пропал, изменён или сборка устарела; с `--latest` — и при отставании от реестра
`remove имя`	убирает компонент из проекта