Read in:
Русский
English

Шаблон Kanban-доски

Шаблон Kanban превращает любую заметку obsidian-kanban в живую Trello-подобную доску на вашем сайте — читатели видят её, а вы редактируете как с сайта, так и из Obsidian.

Это отдельный, необязательный шаблон, не входящий в core trip2g. Исходный код — github.com/trip2g/kanban_template.

▶ Открыть живую демо-доску — для посетителей read-only, для владельца — полноценная.

Установка

Выполните две команды в корне хранилища:

mkdir -p _layouts
curl -L -o _layouts/kanban.html \
  https://github.com/trip2g/kanban_template/releases/latest/download/kanban.html

Затем синхронизируйте хранилище. trip2g автоматически загружает файлы _layouts/*.html, и после следующей синхронизации шаблон становится доступен на сайте.

Подключение к заметке

Добавьте layout: kanban во frontmatter любой kanban-заметки — рядом со строкой kanban-plugin, которую уже добавил плагин:

---
kanban-plugin: basic
layout: kanban
---

Доска появится на опубликованной странице по URL этой заметки. JS-бандл загружается с GitHub Releases автоматически — ничего дополнительно загружать и настраивать не нужно.

Плагин и формат доски

Доска создаётся плагином obsidian-kanban — опенсорс-плагином для Obsidian от mgmeyers. Но сама доска — это обычная markdown-заметка. Создать или изменить её может любой инструмент, умеющий писать markdown: скрипт, AI-агент, curl — без плагина и без Obsidian.

Что превращает заметку в доску. Триггер для trip2g — ключ layout: kanban: именно он говорит trip2g отрисовать заметку этим шаблоном доски. Без него на сайте будет обычный markdown (чеклист), без доски. Второй ключ, kanban-plugin: basic, — это маркер самого плагина obsidian-kanban: формат данных, который читает шаблон, и то, что заставляет Obsidian рисовать доску. К trip2g он прямого отношения не имеет, и шаблон его не требует — он просто уже есть, если вы собрали доску в Obsidian; так что оставьте его и добавьте рядом layout: kanban:

---
kanban-plugin: basic
layout: kanban
---

Колонки. Каждый ## Заголовок в теле заметки — это колонка. Колонки отображаются слева направо в том порядке, в каком идут сверху вниз в файле.

Карточки. Строка - [ ] текст под заголовком — открытая карточка. Строка - [x] текст — завершённая. Чекбокс хранит состояние карточки.

Текст карточки — одна строка. Поддерживает инлайн-разметку: **жирный**, *курсив*, `код`, [[викиссылки]] и обычные ссылки.

Колонка «Готово». Если сразу под заголовком колонки написать **Complete**, эта колонка становится «завершённой»: карточки, перемещённые в неё, автоматически отмечаются выполненными.

Блок настроек. В конце файла может быть блок %% kanban:settings … %% — там хранятся настройки отображения плагина (ширина колонок и т. д.). Obsidian управляет им сам; агент может оставить блок без изменений или вовсе не добавлять его. trip2g сохраняет этот блок байт-в-байт при каждом сохранении.

Полный пример доски:

---
kanban-plugin: basic
layout: kanban
---

## Бэклог

- [ ] Изучить страницу цен конкурента
- [ ] Написать твит к запуску

## В работе

- [ ] Написать письмо для онбординга

## Готово

**Complete**

- [x] Настроить дашборд аналитики

Чтобы добавить или переместить карточку, отредактируйте строки - [ ] и заголовок колонки, под которым они находятся. Плагин и Obsidian не нужны.

Что работает

Карточки — перетаскивайте внутри колонки и между колонками. Дважды кликните по карточке, чтобы отредактировать текст. Кликните иконку удаления, чтобы убрать карточку. Чекбокс внутри карточки переключается кликом.

Колонки — добавьте новую карточку в любую колонку через кнопку + внизу колонки.

Разметка в карточках — карточки рендерят **жирный**, `код` и [[викиссылки]]. Клик по викиссылке открывает связанную заметку; Ctrl/Cmd или клик средней кнопкой — в новой вкладке.

Сохранение без потерь — правки с сайта записываются в тот же markdown, который создаёт Obsidian. Содержимое, которое доска не моделирует — блок настроек kanban и архив — сохраняется при каждом сохранении.

Параллельное редактирование — если кто-то другой (или синхронизация Obsidian) изменил заметку, пока доска открыта, доска автоматически перезагружается, а не перезаписывает удалённую версию.

Управление агентами через доску

Доска — это markdown-заметка, а значит она работает как общий список задач для вас и AI-агентов. Колонки — это этапы (Бэклог → В работе → Готово), карточки — конкретные задачи. Вы и агенты редактируете один файл, trip2g синхронизирует обе стороны.

Точка подключения — вебхук при изменении заметок. Создайте его в панели администратора (Webhooks → + Add): укажите URL агента и паттерн пути к заметке-доске, например kanban/sprint.md. Когда доска изменяется — карточка перемещена на сайте, отредактирована или синхронизирована из Obsidian — trip2g отправляет агенту POST с текущим markdown доски в поле changes[].content.

Агент читает этот markdown по формату, описанному выше, — Obsidian не нужен. Он находит карточки в колонке «В работе», выполняет задачу и записывает результат одним из двух способов:

  • Синхронный ответ — вернуть обновлённый markdown прямо в теле ответа на вебхук. trip2g применяет его сразу. Подходит для быстрых операций (до 60 с).
  • API-токен — включите Pass API key в настройках вебхука. trip2g добавит в payload короткоживущий токен (api_token). Агент использует его, чтобы отредактировать заметку самостоятельно — например, переместить карточку в «Готово» или добавить строку с результатом — уже после завершения ответа. Подходит для длинных задач.

Поле depth в payload отслеживает глубину цепочки. При max_depth: 1 (по умолчанию) правка доски самим агентом не вызывает повторный вебхук — бесконечного цикла не будет. Поднимите до max_depth: 2 только если намеренно выстраиваете цепочку агентов.

В итоге: перетащили карточку в «В работе» — агент подхватил задачу и переместил в «Готово» по завершении. Оба редактируют один markdown-файл, без дополнительной инфраструктуры.

Формат payload, проверка подписи и асинхронный режим — в вебхуках при изменении заметок.

Права доступа

Редактирование на сайте доступно только владельцу или администратору сайта (нужно быть авторизованным). Посетители видят доску в режиме чтения: колонки, карточки и предпросмотр викиссылок работают, но ничего нельзя перетащить или изменить.

Кастомизация бандла

Шаблон — это единственный автономный HTML-файл, собранный на React и @dnd-kit. Чтобы изменить цвета, поведение или рендеринг карточек, сделайте форк репозитория и пересоберите бандл. Инструкции — в README.

Подробнее