fix(i18n): add 'home' body class to English homepage so section__title margin applies
This commit is contained in:
1 parent
9d78567386
commit
939ce8fcc9
88 files changed
+1830
-2
No files matched your search
@@ -0,0 +1,116 @@
|
||||
# Card Columns — плагин-вид для Obsidian Bases
|
||||
|
||||
- **Источник:** `public/cases/card-columns-obsidian/index.html`
|
||||
- **eyebrow:** Obsidian Bases · Plugin
|
||||
- **meta description:** Кейс: Card Columns, плагин-вид для Obsidian Bases. Показывает заметки как карточки, разложенные по колонкам, с фильтрацией тегов по И/ИЛИ.
|
||||
|
||||
---
|
||||
|
||||
**Заметка по путям к медиа:** файлы кладутся в `public/assets/card-columns-obsidian/`, в разметке страницы пути `../assets/card-columns-obsidian/файл.webp`. Форматы: WebP (изображения, постеры), WebM + MP4 (видео).
|
||||
|
||||
## Brief (блок метаданных на странице)
|
||||
|
||||
- **Роль:** Продуктовый дизайн и разработка
|
||||
- **Платформа:** Obsidian Bases
|
||||
- **Статус:** Рабочий плагин, open source (MIT)
|
||||
- **Команда:** Соло, пет-проект
|
||||
|
||||
## Введение
|
||||
|
||||
В Obsidian появились Bases, отдельный тип файла, который показывает заметки не текстом, а в разных видах: таблицей, карточками, деревом. Стандартный вид карточек мне не зашёл: он плоский, без группировки, и в нём не разобраться, когда заметок сотни. Я хотел видеть их раскладку по колонкам, как канбан, но без лишнего веса. Так появился плагин-вид Card Columns.
|
||||
|
||||
## Контекст
|
||||
|
||||
Bases, это не заметка и не отдельная база данных. Это запрос к vault-у: выбираешь заметки по фильтру, и фреймворк рисует их в выбранном виде. У самого Obsidian есть встроенный вид карточек, но он одноплановый: нет группировки по свойствам, нет нормальной фильтрации. Я решил сделать свой вид, который встраивается в переключатель Bases наравне со штатными.
|
||||
|
||||
Главное ограничение было в самом фреймворке: плагин не хранит данные, а рисует то, что выдал Bases-запрос (Sort, Filter, Properties, Search из тулбара). Значит, вся логика выборки остаётся на Bases, а моя задача, только представление и навигация по нему.
|
||||
|
||||
## Задача
|
||||
|
||||
Спроектировать и собрать view-плагин для Obsidian Bases: заметки из запроса показываются карточками, разложенными по колонкам, а по колонкам легко ориентироваться и отбирать нужное. Вид должен жить в переключателе Bases рядом со штатными и не ломать встроенный тулбар (сортировку, фильтр, поиск).
|
||||
|
||||
> **Callout (📌):** Главный риск, сделать вид, который конфликтует со штатным тулбаром Bases. Тогда пользователь теряет сортировку и поиск, ради которых Bases и берут. Этого нельзя было допустить.
|
||||
|
||||
## Решение
|
||||
|
||||
Плагин добавляет в Bases вид «Columns». Карточки строятся из результатов Bases-запроса, группировка задаётся свойством, а отбор, кликабельными тегами.
|
||||
|
||||
### Группировка по любому свойству
|
||||
|
||||
Колонки формируются из Group by в тулбаре Bases, по тегу, статусу, категории или любому frontmatter-свойству. Меняешь свойство в запросе, и доска пересобирается сама. Так одна и та же база закрывает разные разрезы: проекты по статусу, заметки по тегам, задачи по приоритету.
|
||||
|
||||
### Фильтр тегов по И и ИЛИ
|
||||
|
||||
Это то, ради чего плагин и задумывался. Под тулбаром, пилюли тегов, по клику они отсеивают карточки по всем колонкам сразу:
|
||||
|
||||
- Левый клик по тегу, показать только его (сбрасывает остальные фильтры).
|
||||
- Левый клик по следующему тегу, показать заметки с ЛЮБЫМ из выбранных (режим ИЛИ).
|
||||
- Ctrl+Клик или правый клик, переключить тег, не сбрасывая выбор.
|
||||
- Кнопка OR/AND, переключить между «любой из» и «все перечисленные» для нескольких тегов.
|
||||
- All, снять все фильтры.
|
||||
|
||||
Связка «ИЛИ-добавление левым кликом + точный toggle через Ctrl» получилась интуитивной: быстрый отбор не сбивает то, что уже выбрано. Альтернативу, вынести фильтр в модалку, отверг сразу: лишний клик и потеря контекста того, что уже отфильтровано.
|
||||
|
||||
### Карточки и обложки
|
||||
|
||||
По каждой заметке рисуются свойства как чипы, текст, теги, ссылки, булевы, даты. Можно показать обложку: из первой картинки в заметке или из отдельного свойства. У обложки полный контроль, соотношение сторон (Auto, 1:1, 3:2, 4:3, 16:9), рамка, вписывание (cover/contain), ориентация и место на карточке (над заголовком, под ним, после всего).
|
||||
|
||||
### Что заведено в настройки
|
||||
|
||||
Всю внешнюю вариативность я вынел в gear-меню, разбив на четыре секции, чтобы вид подстраивался под разные базы, а не под мой единственный сценарий.
|
||||
|
||||
**General**
|
||||
|
||||
- Куда открывать карточку: активная панель, всплывающее окно, новая вкладка, сплит вправо / вниз.
|
||||
- Ширина карточки (px).
|
||||
- Колонок в группе (1–6), сетка внутри колонки.
|
||||
- Зебра колонок (чередование фона для сканирования).
|
||||
- Masonry-раскладка (карточки заполняют вертикальные пустоты).
|
||||
|
||||
**Title**
|
||||
|
||||
- Перенос заголовка, жирный заголовок, размер шрифта (px).
|
||||
|
||||
**Properties**
|
||||
|
||||
- Раскладка чипов: стек (вертикально) или сетка (компактно в строку).
|
||||
- Перенос многострочных значений, размер шрифта.
|
||||
- Формат даты и даты-времени + локаль (Moment.js).
|
||||
|
||||
**Cover**
|
||||
|
||||
- Источник: нет / первая картинка в заметке / свойство-обложка.
|
||||
- Стиль (без рамки / с рамкой), соотношение сторон, ориентация, вписывание, позиция на карточке.
|
||||
|
||||
> **Callout (💡):** Сплит-превью сделал как в самом Obsidian: левый клик переиспользует панель, Ctrl+Клик, новую вкладку внутри сплита. Без этого на широком экране карточки неудобно просматривать рядом с доской.
|
||||
|
||||
### Работает внутри штатного тулбара
|
||||
|
||||
Вид цепляется к BasesView-фреймворку, поэтому сортировка, фильтр, свойства и поиск из тулбара Bases остаются рабочими. Плагин только рисует результат запроса, данные не дублируются и не зависят от отдельного хранилища.
|
||||
|
||||
## Результат
|
||||
|
||||
Вид закрыл мою боль: Bases-запрос теперь читается как доска, а не как плоская лента карточек. Группировка по свойству + отбор по тегам И/ИЛИ, то, чего не хватало штатному виду. Всё крутится на запросе Bases, так что перенос vault-а и синхронизация ничего не ломают.
|
||||
|
||||
Метрики у пет-проекта нет, и придумывать её не стану. Проверяю проще: юзабилити на себе в ежедневной работе. Критерий, сколько действий нужно, чтобы отобрать заметки по двум тегам и найти нужную карточку. В штатном виде карточек это был скролл ленты с ручным поиском по заголовкам; здесь, два клика по пилюлям и колонка перед глазами. Если бы замерял всерьёз, считал бы время на задачу на выборке из 20–30 заметок до и после, но на своей повседневной базе разница заметна и без секундомера.
|
||||
|
||||
Что сделал бы иначе. Drag-and-drop карточек между колонками не стал делать сознательно, это меняет свойство в заметке, и для view-плагина это отдельный риск целостности данных. Но вижу запрос на это у пользователей, и, возможно, добавлю как опциональный режим. А пока плагин живёт вручную (через community-каталог ещё не прошёл), это единственное, что мешает им пользоваться сходу.
|
||||
|
||||
> **Callout (✅):** Главный вывод: вид для Bases получается рабочим только тогда, когда он уважает тулбар фреймворка. Я добавил представление, а не вторую систему хранения, и заметки остались обычными заметками.
|
||||
|
||||
## Медиа-плейсхолдеры (в HTML закомментированы)
|
||||
|
||||
| Слот | Файл | Что показывать |
|
||||
|---|---|---|
|
||||
| Обзор | `overview.webp` | Вид Card Columns поверх `.base` файла |
|
||||
| Колонки | `board.webp` | Колонки карточек с группировкой по свойству |
|
||||
| Фильтр | `filter.webm` / `filter.mp4` + `filter-poster.webp` | Фильтрация по тегам, OR и AND |
|
||||
| Настройки | `settings.webp` | Gear-меню с секциями |
|
||||
|
||||
Ещё один слот (`note-before.webp`) остался в шаблоне из ранней версии и сейчас не используется, удалить при вставке медиа.
|
||||
|
||||
## Источники фактуры
|
||||
|
||||
- Репозиторий: `https://github.com/mamadaevv/card-columns` (лицензия MIT).
|
||||
- Все параметры кастомизации и логика фильтрации взяты из README репозитория.
|
||||
- Drag-and-drop в плагине **отсутствует**: он есть у соседнего `ewerx/obsidian-bases-kanban`, не путать.
|
||||
Reference in new issue
Block a user