Инбокс Obsidian
Немало текстов начинается где-то ещё — в телефоне, в клиппере, в хранилище Obsidian. Инбокс замыкает этот круг: наведите его на папку — и заметки, брошенные туда, сами импортируются на сайт.
§4.1Как включить
Инбокс поставляется выключенным. Включается в inkbrush.config.ts:
inbox: {
dir: '~/vault/inbox', // папка под наблюдением (поддерживает ~/)
ignore: ['daily-'], // необязательно: префиксы имён файлов, которые пропускать
},Файлы, уже лежащие в папке на старте, помечаются как увиденные, а не импортируются — автоматически синхронизируются только заметки, добавленные после. Всё более старое можно догрузить явно через API, так что включение инбокса никогда не вывалит на сайт десятилетие истории хранилища сюрпризом.
§4.2Что делает импортёр
Каждая входящая заметка конвертируется, а не копируется:
- встраивания изображений разрешаются по папкам ассетов хранилища, файлы копируются рядом с импортированной заметкой, а встраивания становятся стандартным синтаксисом изображений — удалите заметку позже, и её ассеты удалятся вместе с ней
[[вики-ссылки]], совпавшие с настоящей заметкой сайта, выживают как ссылки — разрешённые теми же правилами, что и всюду; остальные сплющиваются в обычное выделение с предупреждением- выделения становятся настоящими элементами
<mark>, метаданные frontmatter — строкой об источнике под заголовком, а описание выводится из первого содержательного абзаца
Сконвертированная заметка затем обязана пройти тот же рубеж сборки, что и ручное сохранение, — заметка, которая сломала бы страницу, отклоняется, а не импортируется.
Каждый импорт ложится в журнал версий (via: inbox) записью на весь файл: ⟲ показывает её строкой аудита, а отмена импорта — операция git. С включённым autocommit каждый импорт вдобавок становится git-коммитом, как любая другая правка; с выключенным — импортированные файлы приходят обычными изменениями рабочего дерева, которые вы просматриваете и коммитите сами.