Read in:
Русский
English

Живое редактирование

Страница обновляется в момент синхронизации. Не нужно обновлять браузер — только изменившиеся части страницы перерисовываются сами.

Как это работает

Когда плагин синхронизации отправляет заметку на сервер, тот немедленно отправляет событие noteChanges по постоянному соединению (SSE). Каждый браузер, в котором открыта эта страница, получает событие сразу. В событии содержится поле changedHtmlSelectors — список CSS-селекторов, чей HTML изменился. Браузер перерисовывает только эти части страницы. Всё остальное остаётся на месте.

Это значит, что правка заголовка перерисует заголовок. Новый абзац появится в контентной области. Читатель увидит изменение без мигания, без потери позиции прокрутки, без лишних сетевых запросов.

Редактируйте в Obsidian — смотрите в браузере

Откройте опубликованный сайт в браузере. Откройте ту же заметку в Obsidian. Отредактируйте её и нажмите синхронизацию в плагине.

🖼️ Скриншот — assets/admin/live-editing-side-by-side.png
Obsidian и окно браузера открыты рядом. Слева — заметка редактируется в Obsidian (виден изменённый заголовок или абзац). Справа — опубликованная страница в браузере, уже отражающая изменение. Важно показать, что в браузере нет признаков перезагрузки: индикатор вкладки не мигает, страница не мелькает.

Обновление приходит меньше чем за секунду на нормальном соединении. Задержка равна времени синхронизации: браузер получает событие в момент, когда сервер сохраняет заметку.

Что считается «изменением»

Сервер сравнивает отрендеренный HTML обновлённой заметки с предыдущим. Изменения в тексте, форматировании, полях frontmatter, которые влияют на шаблон, новые или удалённые вики-ссылки — всё это обновляет DOM. Изменения, не влияющие на результат рендеринга (пробелы, неиспользуемые поля frontmatter), обновление не вызывают.

Настройка не нужна

Живые обновления работают на каждой опубликованной странице автоматически. В панели администратора нет переключателя, во frontmatter нет флага. Пока браузер открыт на странице, а заметка опубликована с free: true (или читатель авторизован), обновления приходят в реальном времени.

Редактор в браузере

Администраторы, работающие через встроенный редактор в браузере, тоже получают живые обновления. Если AI-агент или коллега отредактировал заметку через API, пока у вас открыт редактор, содержимое обновится автоматически.

Переключатель перезагрузки

Переключатель перезагрузки заставляет браузер перезагружать текущую страницу при каждом событии noteChanges от сервера. После перезагрузки изменившиеся части страницы ненадолго подсвечиваются — видно, что именно изменилось.

Это отличается от поведения по умолчанию: вместо точечного обновления HTML в DOM браузер делает полную перезагрузку страницы. Удобно, когда нужно проверить полный результат рендеринга — навигацию, боковую панель, логику шаблона, — а не только контентную область.

Включается из панели инструментов на странице, которая появляется при входе администратора.

Режим следования (cinema mode)

В режиме следования браузер автоматически переходит на ту заметку, которая изменилась последней. Каждый раз, когда сервер публикует событие noteChanges для любой заметки, браузер открывает URL этой заметки.

Это удобно для наблюдения за работой ИИ-агента в реальном времени: браузер следует за агентом от заметки к заметке без ручных кликов.

Включить по ссылке. Добавьте ?#!live_follow=1 к URL любой страницы сайта:

https://yourdomain.com/any-note?#!live_follow=1

При открытии этой ссылки режим следования включается в данной вкладке. Настройка сохраняется в локальном хранилище и переживает автоматические переходы. Чтобы отключить — перезагрузите страницу без флага и выключите через панель инструментов.

Режим удобно сочетать с trip2g-sync --watch в качестве сайдкара: демон синхронизации отправляет правки агента на сервер, сервер генерирует noteChanges, браузер следует автоматически. Полный сетап — ru/user/agent-memory.

Подробнее