English

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/authoring
node starters/authoring/cli.mjs build ./workshop/theme.ts --out ./workshop.hoba
node starters/authoring/cli.mjs unpack ./workshop.hoba --out ./workshop-recovered
node starters/authoring/cli.mjs build ./workshop-recovered/theme.ts --out ./workshop-rebuilt.hoba
cmp ./workshop.hoba ./workshop-rebuilt.hoba

4. Установите и проверьте результат

Выберите .hoba в Admin совместимого Core и проверьте сводку до импорта. Откройте результат в Composer, измените блок и проверьте ссылку. При добавлении медиа объявляйте локальные файлы в assets и ссылайтесь на них через asset:ключ; сверяйте лицензии. Версия reader задаёт возможности чтения пакета и не равна номеру схемы БД.