repositories

Роли репозиториев

`duck-obsidian-panel`

Админская панель для управления gardens из браузера.

Что делает:

показывает список gardens;
создаёт новый garden;
запускает rebuild;
включает garden;
выключает garden;
удаляет deployment с сервера;
показывает базовый статус container/timer/https;
работает через backend API /api/*.

Что не делает:

не собирает garden напрямую;
не хранит заметки;
не выполняет shell-команды из браузера;
не является Obsidian plugin.

См. админская панель: запуск и выкладка.

`duck-obsidian`

Серверный runner и API.

Главный файл для ручных операций:

/home/supervisor/leonid_projects/duck-obsidian/.deploy/gardenctl

Что делает:

create — создать garden deployment;
rebuild — пересобрать garden;
logs — смотреть systemd logs;
status — смотреть timer/service/container;
pause / resume — выключать и включать auto-update;
upgrade / upgrade-all — обновлять engine в garden repo;
destroy — удалить deployment с сервера;
backend API для панели на 127.0.0.1:3017.

См. серверные операции через gardenctl.

`duck-obsidian-template`

Шаблон нового garden repo.

Даёт структуру:

<garden-repo>/
  <slug>-vault/
  src/site/notes/
  src/site/img/user/
  garden.config.json
  package.json

Что важно:

Obsidian открывает только <slug>-vault/;
Digital Garden plugin публикует в src/site/notes/;
npm-команды вызывают @duck/garden-engine;
garden.config.json задаёт имя, slug, domain, features, noteSettings и theme.

См. локальная сборка garden и правила контента.

`duck-garden-engine`

npm package и CLI:

duck-garden build

Что делает:

читает garden.config.json;
берёт опубликованные заметки;
определяет главную страницу;
строит красивые URL;
резолвит wikilinks;
собирает graph/backlinks/filetree/search index;
копирует картинки /img/user/...;
запускает Eleventy;
пишет готовый сайт в dist/.

См. как работает engine.

Как проекты связаны

duck-obsidian-panel
  -> вызывает backend API

duck-obsidian/.deploy/api
  -> вызывает gardenctl

duck-obsidian/.deploy/gardenctl
  -> создаёт/обслуживает garden deployments

garden repo на базе duck-obsidian-template
  -> хранит notes/config/assets

@duck/garden-engine
  -> собирает garden repo в dist/