HOBA
Соберите свою тему .hoba
Минимальная тема из двух файлов: компонент Home.tsx и описание сайта theme.ts. В результате — редактируемый сайт, а не фронтенд-приложение.
TSX, Node.js и HOBA Core
TSX — это TypeScript с синтаксисом JSX, а Node.js — среда, в которой работает CLI сборки. SDK преобразует JSX в вызовы h, которые создают обычные объекты блоков. Можно получить те же объекты прямыми вызовами Container и Heading: ни React, ни DOM не нужны. При сборке локально выполняется авторский код, поэтому собирайте только доверенные исходники. На сервере Rust Core читает декларативный граф и рендерит его; он не исполняет TSX и не запускает Node.js.
1. Напишите компонент: workshop/components/Home.tsx
Компонент возвращает контейнер, заголовок, текст и ссылку. Импорт h нужен для преобразования JSX в вызовы SDK. Ссылка page:ru/contacts указывает на ключ страницы в русском разделе, а не на жёстко заданный URL.
import { h, Container, Heading, Link, Text } from '@hoba/theme-authoring'export function Home() { return ( <Container key="home-content" title="Home" layout={{ kind: 'stack', gap: 'md' }}> <Heading key="title" level="h1" title="Workshop" /> <Text key="intro" text="A small site built with HOBA." /> <Link key="contact" label="Contacts" to="page:ru/contacts" /> </Container> )}
2. Опишите сайт: workshop/theme.ts
Точка входа связывает страницы, языки, метаданные и ресурсы. Сохраните стабильные ключи при переименовании заголовков и адресов. В примере Home общий для двух локалей, а ссылка на контакты намеренно ведёт в русскую версию; для локализованной навигации передайте locale в компонент.
import { defineTheme, Container, Heading } from '@hoba/theme-authoring'import { Home } from './components/Home'export default defineTheme({ type: 'hoba.theme.graph', version: 1, min_reader_revision: 3, meta: { id: 'workshop', release: '0.1.0', name: { ru: 'Workshop', en: 'Workshop' }, description: { ru: 'Сайт мастерской', en: 'A workshop site' }, license: { spdx: 'CC0-1.0', text: 'Original example, released under CC0.' }, core_compat: { min: '0.2.3', max_exclusive: '0.3.0' }, }, site: { default_locale: 'ru', locales: ['ru', 'en'], tokens: { colors: { background: '#faf8f4', surface: '#ffffff', text: '#211d29', muted: '#62596e', primary: '#47328b', accent: '#6546ac', border: '#ded8ef' }, radius: 'md', shadow: 'none', typography: { family: 'sans', scale: 'compact' }, }, }, assets: [], pages: (['ru', 'en'] as const).flatMap(locale => [ { key: 'home', slug: 'home', locale, title: 'Workshop', content: Home() }, { key: 'contacts', slug: 'contacts', locale, title: 'Contacts', content: Container({ key: 'contacts-content', title: 'Contacts', children: Heading({ key: 'title', title: 'Contacts', level: 'h1' }), }), }, ]),})
3. Соберите и перепроверьте архив
Из корня рабочей копии SDK установите зависимости по lock-файлу. Build создаёт один .hoba, unpack восстанавливает входные файлы без исполнения кода. Сравнение после повторной сборки проверяет воспроизводимость на той же версии SDK. Не редактируйте граф внутри архива: меняйте исходники и пересобирайте.
npm ci --prefix starters/authoringnode starters/authoring/cli.mjs build ./workshop/theme.ts --out ./workshop.hobanode starters/authoring/cli.mjs unpack ./workshop.hoba --out ./workshop-recoverednode starters/authoring/cli.mjs build ./workshop-recovered/theme.ts --out ./workshop-rebuilt.hobacmp ./workshop.hoba ./workshop-rebuilt.hoba
4. Установите и проверьте результат
Выберите .hoba в Admin совместимого Core и проверьте сводку до импорта. Откройте результат в Composer, измените блок и проверьте ссылку. При добавлении медиа объявляйте локальные файлы в assets и ссылайтесь на них через asset:ключ; сверяйте лицензии. Версия reader задаёт возможности чтения пакета и не равна номеру схемы БД.