Документация исходного кода; установленный выпуск может отличаться.

Руководство пользователя Projects Plus

English · Документация · Установка и первый проект

Это руководство описывает Projects Plus 3.7.2. Названия отдельных элементов могут отличаться в более ранних сборках; версию установленного плагина можно посмотреть в его настройках.

Как устроены данные

Заметка — Markdown-файл в хранилище. Поле — свойство заметки, например status или startDate. Проект выбирает набор заметок по источнику. Представление определяет, как показать этот набор. Один проект может иметь несколько представлений, а одна заметка — входить в несколько проектов.

Изменение редактируемого поля сохраняется в исходном файле. Фильтры, расположение блоков и настройки представлений хранятся отдельно, в .obsidian/plugins/obs-projects-plus/data.json. Сохраняйте этот файл вместе с заметками при резервном копировании или переносе хранилища.

Вычисляемые поля и результаты запросов не всегда доступны для записи. Если поле нельзя редактировать, проверьте его тип и источник; не считайте показанное вычисленное значение самостоятельным свойством Markdown-файла.

Быстрый старт: демо

Когда в хранилище ещё нет ни одного проекта, окно приветствия предлагает два пути: карточку «Демо: три связанных проекта» и кнопку «Создать новый проект». Если закрыть окно, те же два действия остаются на пустом экране проектов. Позже демо можно создать из меню проектов (настройки вида → «Проекты» → «Создать демо-проект») или командой Создать демо-проект.

Демо — три проекта одной истории в папке Projects Plus - Демо 2:

Проект Что в нём Представления
«Демо: Массажный кабинет» частный массажный кабинет: 5 услуг, 10 клиентов, полгода визитов и расходов «Обзор кабинета» (статистика, прибыль по месяцам, клиенты с их визитами и самочувствием), «Расписание», «Визиты по статусам», «Клиенты» (галерея с обложками), «Услуги и расходы»
«Демо: Трекер» ежедневный журнал трёх клиентов кабинета: вес, сон, настроение, энергия, боль, тренировки «Динамика» (показатели выбранного клиента рядом с его самочувствием после визитов), «Календарь тренировок», «Виды тренировок», «Недели», «Журнал»
«Демо: Личный бюджет» личный бюджет: статьи с лимитами и полгода операций «Бюджет» (доход частной практики из кабинета отдельной серией), «Статьи», «Операции по статьям», «Календарь операций», «Журнал»

Карточка клиента в кабинете ничего не хранит сама: визиты, оплаты, долг, последнее и среднее самочувствие, последний визит считаются обратными свёртками из визитов, а текущий вес, минуты тренировок и сон — из записей трекера, другого проекта. Имена папок, полей и представлений демо — русские, язык интерфейса их не переводит. Повторный запуск восстанавливает недостающие заметки и проекты и ничего не дублирует. Удаляется демо как обычные проекты: удалите три проекта в меню и, если нужно, папку Projects Plus - Демо 2.

Создание и настройка проекта

Откройте палитру команд Obsidian и выберите Создать новый проект плюс. В диалоге задайте имя и источник. Путь к папке указывается относительно корня хранилища, например Projects/Work.

Источник Когда использовать Что настроить
Папка Записи лежат рядом Путь и включение вложенных папок
Тег Записи расположены в разных папках Тег и включение его иерархии
Запрос с фильтром Нужен отбор без дополнительного плагина Исходную папку или тег, условия отбора
Dataview Нужен запрос Dataview Включённый плагин Dataview и текст запроса

Встроенный запрос задаётся через поля диалога: например, источник Projects, поле status, оператор равенства, значение todo. Для нескольких условий выберите, должны выполняться все условия или хотя бы одно.

Для Dataview используйте полный запрос, включая его тип. Например:

TABLE status, startDate
FROM "Projects"
WHERE status != "done"
SORT startDate ASC

В настройках проекта можно добавить дополнительные источники — папку, тег или Dataview. Это удобно для общего обзора нескольких наборов заметок. Встроенный запрос доступен как основной источник; вложенные запросы не предлагаются в списке дополнительных источников.

Проверьте также папку новых заметок, шаблоны, формат имени и исключённые файлы. Эти настройки особенно важны для проекта по тегу или запросу: источник отбора и папка создания заметок решают разные задачи.

Создание и редактирование записей

Используйте действие создания заметки в проекте или команду Создать новую заметку плюс. Проверьте выбранный проект в диалоге, введите имя и при необходимости выберите шаблон. В календаре на ПК используется двойной клик по свободной ячейке. На телефоне удерживайте свободное место и протяните палец, чтобы задать длительность; после отпускания появится нижняя форма. Черновик можно перемещать и растягивать до подтверждения. Галочка создаёт файл, отмена убирает черновик.

Для начала достаточно таких свойств:

---
title: Подготовить встречу
status: todo
priority: high
startDate: 2026-09-15
endDate: 2026-09-15
startTime: "09:00"
endTime: "10:00"
completed: false
color: "#2196F3"
tags:
  - work
---

Даты записывайте в формате YYYY-MM-DD, время — HH:mm. Кавычки у времени и цвета помогают сохранить их как строки YAML. Имена полей выбираете вы; затем укажите эти имена в настройках представления.

Откройте запись через её название или карточку. В таблице Dashboard обычный клик открывает заметку; Alt открывает предпросмотр записи, то же действие доступно через пункт в меню строки. После правки можно открыть исходный файл и проверить сохранённое значение. Если плагин сообщает об ошибке записи, сохранение нельзя считать завершённым.

Представления

Dashboard и таблица

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

В таблице можно редактировать доступные ячейки, выбирать столбцы, сортировать и фильтровать записи. Пункт «Свойства» в меню блока настраивает типы полей, в том числе текст, число, флажок, статус, список, формула и связь. Старые сохранённые представления Table и Database при загрузке преобразуются в Dashboard; это не отдельные новые режимы установки.

Enter подтверждает редактирование, Escape отменяет его; подтверждение кандидата IME не завершает ячейку. Для чисел используйте десятичную точку без разделителей тысяч. Неверное число или незавершённая дата отмечаются как ошибочный ввод и не стирают прежнее значение; намеренное очищение корректного поля по-прежнему допустимо. Название записи открывает заметку, Alt-нажатие — предпросмотр; название доступно и с клавиатуры.

Текстовые списки редактируются поэлементно в общем попапе: «Добавить элемент», удаление нужной строки, «Применить» или «Отмена». На телефоне используется общий нижний лист. Запятые, кавычки, повторяющиеся и пустые строки остаются частью значений; список не превращается в строку. Выход без изменений не записывает заметку; удаление всех элементов сохраняет пустой список. В смешанном списке нетекстовые элементы сохраняются без преобразования и доступны для удаления, но не для текстовой правки. Массивы чисел/дат/булевых значений в скалярных колонках защищены от такого редактирования; отдельный типизированный редактор этих массивов ещё не реализован. Мобильные формы и работа с клавиатурой вошли в приёмку выпуска на iPhone.

Поиск большой таблицы выполняется порциями: «…» вместо счётчика означает ожидание, затем показывается полный результат последнего запроса. Изменение или очистка запроса отменяет предыдущий поиск. «Нет совпадений» означает завершённый поиск без результатов, а не зависание.

Кнопка добавления сразу открывает выбор типа виджета, без промежуточной панели «Виджеты». Новая плитка добавляется в конец, получает фокус и прокручивается в видимую область; существующий порядок не меняется. Замок в меню плитки фиксирует её позицию в вертикальном стеке: у неё нет ручки переноса, и перенос соседей не меняет её индекс. Это не защита содержимого от редактирования, удаления или сворачивания. Переименование допускает IME; Enter подтверждает один раз, Escape отменяет.

«Статистика» — числовая сводка, не диаграмма. При первой настройке создаются редактируемые карточки количества записей и, если есть числовое поле, его суммы и среднего. В настройках можно выбирать поле и операцию каждой карточки, удалять карточки и задавать 2/3/4 колонки. Узкая плитка сокращает число колонок до двух или одной; удаление всех карточек оставляет подсказку, а не возвращает прежние итоги. Мини-график — ограниченное превью до 200 точек; числовой итог использует все значения. Для полноценной диаграммы добавьте «График». Режим только чтения не предлагает настройку неготового виджета.

Общие попапы и подсказки учитывают видимую область окна при наличии visualViewport; вложенные подсказки закрываются первым Escape, окно — следующим. При двух открытых попапах Escape и внешнее нажатие обрабатывает верхний. Проверки выпуска охватывают моделируемые изменения viewport и работу с клавиатурой на iPhone. При обновлении проверьте свою конфигурацию устройства и отдельных окон.

Каждый блок может иметь собственный источник и фильтры. Если два блока показывают разные записи, сначала сравните эти настройки. Для связанных блоков настройте зависимость от выбранной записи: например, выбор клиента в одном блоке ограничивает данные другого. Одна только близость блоков на экране связь не создаёт.

Доска

Выберите поле группировки, например status. Значения этого поля станут колонками. Перетаскивание карточки в другую колонку меняет поле группировки у заметки, если запись доступна для редактирования.

Карточки и колонки перемещаются за ручку: у карточки это полоса вдоль левого края, у колонки — первая ячейка заголовка. Закреплённую колонку и колонку только для чтения перетащить нельзя. Закреплённые колонки позволяют оставить нужные этапы на доске даже без записей.

В настройках вида (шестерёнка → «Вид») доска может показывать на карточке обложку из поля с изображением: сверху, маленьким квадратом слева или не показывать. У карточки без изображения миниатюры нет. Для общего процесса договоритесь об одинаковых значениях статуса: todo, doing и done удобнее, чем несколько вариантов одного слова.

Boolean-свойства в теле карточки доски и отдельный чекбокс в её заголовке переключаются без открытия YAML-просмотрщика. Вычисляемые поля и данные источника только для чтения недоступны для изменения.

Календарь и Agenda

В настройках календаря явно выберите поля начала и окончания события. Для примера выше это startDate и endDate; время — startTime и endTime, цвет — color.

Если поле начала не задано или отсутствует, календарь пытается найти дату в распространённых полях, включая startDate и date, затем в имени файла. Поэтому date может влиять на расположение события. Для предсказуемого результата задавайте поле начала явно и заполняйте его во всех нужных заметках.

Переключайте масштаб от года до дня. В недельном и дневном режиме события со временем отображаются на временной шкале; перетаскивание меняет дату или время, а изменение края полосы — длительность. В режимах «месяц» и «2 недели» перетащите запись на другой день, чтобы изменить её дату. Для возвращения к текущей дате используйте кнопку Сегодня.

Agenda — боковая панель со списками событий. В ней можно выбирать день и настраивать фильтры отдельных списков. Если событие видно в календаре, но отсутствует в Agenda, проверьте выбранную дату и фильтр списка.

В форме нового события палитра раскрыта сразу и прокручивается вместе с остальными полями формы. Её можно свернуть кнопкой цвета. В просмотрщике заметки обычные свойства и раздел вычисляемых значений находятся в одной области прокрутки; формулы и сводки доступны только для чтения.

Галерея

Галерея показывает записи карточками. В настройках вида (шестерёнка → «Вид») выберите поле обложки, раскладку (сетка, кладка или список), размер карточек (S, M, L или ширина), пропорции обложки и то, заполняет ли изображение рамку или вписывается в неё. Раздел «Поля на карточке» показывает поля карточки в их порядке: поле можно поднять, опустить, скрыть или добавить другое; вычисляемые поля (формулы и сводки) помечены ƒ, подписи полей включаются и выключаются.

Размер карточки меняется за уголок справа внизу (или с клавиатуры: фокус на уголке и стрелки). Размер сохраняется в настройках вида — для одной карточки или, через «Высоту карточки» в настройках, для всех карточек вида; «Сбросить размеры всех карточек» убирает их. На доске рамка задаёт высоту карточки. Если изображение не появилось, проверьте значение поля и доступность самого файла изображения. Название карточки открывает окно редактирования записи, из которого можно открыть и саму заметку; в галерее только для чтения название сразу открывает заметку. Меню карточки открывает заметку в новой вкладке или окне.

Фильтры, формулы и связи

Фильтр ограничивает показанные записи, но не удаляет заметки. Фильтр представления находится в его настройках (шестерёнка → «Фильтры»): вкладка показывает, сколько условий активно, очищает их все и сохраняет отфильтрованную выборку отдельным источником («Сохранить как источник») для других представлений и блоков. Условия могут объединяться по правилу «все» или «любое». Фильтры проекта, представления и блока действуют на разных уровнях: очистка одного фильтра не обязательно снимает остальные.

Формулы вычисляют значения из полей. Начните с небольшого выражения для числовых полей, например budget - spent. Проверьте результат на одной известной записи, прежде чем использовать его в общей статистике. Встроенный редактор помогает выбирать функции и поля; доступность операции зависит от типов данных.

Формула проекта и вычисляемое поле дашборда. Формула в настройках свойства проекта относится к этому свойству и доступна в представлениях проекта. Кнопка «Вычисляемые поля» в шапке дашборда создаёт вычисляемый столбец только для этой страницы. Это рабочее вычисление, а не отдельный калькулятор предпросмотра: «Применить» сохраняет определение в настройках представления, и поле пересчитывается для его записей. Свойства Markdown при этом не переписываются.

В панели дашборда задайте новое имя, например Remaining, и выражение budget - spent. Предпросмотр показывает результат для первой записи из данных дашборда. Ссылка budget читает поле текущей записи; SUM(@budget) суммирует столбец по всему набору данных дашборда, а не только по первой строке. Поэтому сначала проверьте фильтры и источник. После применения поле можно использовать в таблицах и виджетах этой страницы. Сохранённые поля показаны в панели: выберите имя, чтобы изменить выражение; используйте кнопку удаления рядом с именем, чтобы убрать поле со страницы. Другие формулы, ссылающиеся на удалённое поле, нужно обновить. Пустое имя, совпадение с обычным свойством, ошибка синтаксиса и циклическая зависимость не применяются.

Связь указывает на заметки другого проекта. В YAML ссылка выглядит, например, так:

client: "[[Клиенты/Иванова Мария]]"

Ссылки во frontmatter — это и есть данные связи. Настройка связи их не трогает: она только объясняет плагину, где искать записи, на которые они указывают. Ссылку он перепишет только тогда, когда вы сами измените значение — в ячейке таблицы или в редакторе записи; тогда новое значение уйдёт во frontmatter.

Путь от ссылок к связи. В меню блока, который читает этот проект, выберите «Свойства «проект»…», найдите строку нужного поля и нажмите «Настроить». В поле «Тип» выберите «Связь», затем укажите «Целевой проект» — базу, в которой разрешать ссылки. Кнопка «Связать с базой…» открывает мастер: он показывает предпросмотр вида «Совпадения: 3; Не найдены: 0; Неоднозначны: 0» ещё до сохранения, так что расхождение видно заранее. Свойство, которое уже существует как текст, мастер превращает в связь; заметки при этом не переписываются.

Превратить в связь нельзя поле-формулу, свёртку, идентификатор записи и производное поле: их значения вычисляются или принадлежат не этому свойству, и связь затёрла бы то, что их производит. Мастер откажет одной общей формулировкой — «вычисляется или определяет запись», — не уточняя, какой именно случай сработал.

Если заметки с одинаковым именем лежат в разных папках, используйте путь в ссылке. Отсутствующая или неоднозначная ссылка требует исправления адреса; она не означает, что нужная запись была автоматически создана.

Итог по связанным записям. После настройки связи добавьте поле типа «Свёртка»: в «Через связь» выберите колонку связи, в функции — например «Количество всех». На карточке появится число связанных записей — у клиента с двумя сеансами это 2, у клиента без сеансов 0. Конвейер данных для этого собирать не нужно.

Диаграмма по связанным данным. Кнопка «+» в палитре блоков добавляет «Диаграмму»; в её настройке выберите тип, ось X и ось Y. Даты по оси X группируются по дню, неделе, месяцу, кварталу или году, а по оси Y можно взять сумму, среднее, минимум, максимум, медиану, количество или число уникальных значений.

Первый проверяемый график. Возьмите три записи с текстовым полем status и числовым amount: A/10, A/30, B/20. Добавьте график, выберите столбчатый тип, X = status, Y = amount, агрегацию «Сумма»: ожидаются A = 40 и B = 20. Переключение на линейный тип сохраняет эти значения. Операции зависят от типа поля: текст не предлагает сумму, а «Количество всех» считает записи, включая пустые значения, и не складывает числа. Подсказка объясняет выбранную операцию. Если старая настройка несовместима с полем, она показана с предупреждением: само открытие её не меняет; выберите допустимую операцию явно. При явной смене Y совместимая операция сохраняется, иначе выбирается «Количество всех». Scatter не использует этот выбор агрегации.

Оператор фильтра агенды. Нажмите кнопку оператора в строке фильтра. Меню использует общий попап: стрелки перемещают фокус, Enter/Space или нажатие выбирают пункт, Escape отменяет и возвращает фокус кнопке. Escape во время IME-композиции не закрывает ввод. Выбор оператора без значения очищает прежнее значение; открытие и отмена его не меняют. Реальное поведение экранной клавиатуры и отдельного окна Obsidian требует проверки на устройстве.

Вычисления между таблицами и проектами

Обратная свёртка — итог по записям, которые ссылаются сюда. Клиенту не нужно поле со списком визитов: визиты сами ссылаются на клиента. В настройке поля-свёртки выберите в «Через связь» источник с пометкой «(ссылаются сюда)» — проект и поле, через которое его записи указывают на эту. Функция «Количество всех» даст число визитов, «Сумма» по полю цены — оплату, «Последнее значение» по полю самочувствия — последнюю оценку. Заметка клиента при этом не меняется: свёртка вычисляется, в заметку не пишется и редактировать её нельзя.

Первое и последнее значение выбираются по полю порядка — обычно по дате. Выберите его из списка; если нужного свойства в списке нет (список знает только поля, настроенные в проекте-источнике), выберите «Другое поле…» и введите имя свойства.

Данные другого проекта в графике и статистике. В настройке графика или блока статистики поле «Данные из» переключает источник на другой проект; фильтр и конвейер блока работают уже над его записями. Пока проект загружается, блок показывает это, а не цифры текущего проекта. Если проект удалён, в списке остаётся пункт «Недоступный проект» — выберите «Этот проект», чтобы сбросить выбор.

Несколько серий на одном графике. Добавьте серии в настройке графика: у каждой своё поле и агрегат, при необходимости — другой проект, своё поле оси X и правая ось (для величин разного масштаба, например вес и минуты тренировки). Серии выравниваются по общим подписям оси; день без значения — разрыв линии, а не ноль. Столбцы могут уходить ниже нуля: месяц с убытком виден под осью.

Следовать выбору в другом блоке. «Следовать выбору в» связывает график или статистику с таблицей на том же Dashboard: выберите строку таблицы (меню строки → «Фильтровать связанные блоки по этой строке»), и график покажет только записи, связанные с ней. Так в демо выбор клиента оставляет на графике его визиты и трекер.

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

Подсказка связанного блока. Когда в проекте есть поле-связь, над блоками появляется подсказка «Добавить блок данных». Она добавляет блок, который показывает связанные записи выбранной строки: записи другого проекта, ссылающиеся сюда, или — если связь идёт только отсюда — запись, на которую ссылается выбранная строка. На виде с фильтром (например, только клиенты) блок читает проект целиком, чтобы видеть записи, которые фильтр вида скрывает.

Демо из трёх проектов. Кабинет, трекер и финансы (см. «Быстрый старт: демо») показывают вычисления в действии. В кабинете клиенты и услуги считают визиты, выручку и самочувствие обратными свёртками, а вес, тренировки и сон — свёртками из трекера. На «Обзоре кабинета» выберите строку клиента (меню строки → «Фильтровать связанные блоки по этой строке»): его визиты и график самочувствия с серией настроения из трекера сузятся до него. «Динамика» трекера так же следует клиенту, выбранному в блоке клиентов кабинета. Бюджет показывает доход кабинета отдельной серией рядом с собственными доходами и расходами.

Шаблоны заметок

Встроенные шаблоны

Создайте обычный Markdown-файл шаблона и добавьте его в список шаблонов проекта. При создании заметки выберите этот файл. В содержимом поддерживаются {{title}}, {{date}}, {{time}}; для даты и времени можно указать формат, например {{date:YYYY-MM-DD}}.

---
status: todo
startDate: {{date:YYYY-MM-DD}}
---

# {{title}}

## Что нужно сделать

## Результат

Поле стандартного имени заметки поддерживает дату и время, например {{date:YYYY-MM-DD}} Задача. Переменные {{project}}, {{author}} и условные блоки {{#if ...}} не являются возможностями встроенного обработчика.

Templater

Файлы в папке templates используют синтаксис Templater (<% ... %>) и требуют отдельно включённого плагина Templater. Создавайте заметку его командой, поместив результат в папку проекта. Встроенная подстановка Projects Plus не выполняет код Templater.

Избранные цвета

Нажмите цветовой маркер свойства в шапке заметки. В поле «Избранные цвета» выберите «Общие» или имя проекта. Если у проекта ещё нет своего набора, он начинается с общих цветов; добавление и удаление после выбора проекта меняют только его набор. Сам выбор набора не перекрашивает заметку.

При просмотре заметки внутри представления проекта палитра сохраняет его контекст. В самостоятельной шапке выбор явный и возвращается к общему при переходе к другой заметке. Папка заметки не используется как доказательство принадлежности проекту с запросом.

Для точного цвета введите #RGB или #RRGGBB (можно без #) и примените. Четыре, пять и восемь цифр не принимаются. Цвет сохраняется без округления в нормализованном шестизначном HEX (#ABC становится #aabbcc); движение ползунка задаёт новый оттенок. Существующие CSS-цвета обновляют превью и ползунки. Входящий полупрозрачный цвет сохраняет прозрачность до выбора непрозрачной замены; избранное принимает только непрозрачный HEX. При смене заметки палитра закрывается, а незавершённый жест отменяется.

Наборы сохраняются в настройках плагина. Для другого устройства передайте настройки используемым вами средством синхронизации; отдельного сервера палитр нет. При ошибке сохранения проверьте уведомление плагина и не перезагружайте его с несохранёнными изменениями.

Клавиатура и сенсорное управление

Глобальные сочетания для команд назначаются в настройках горячих клавиш Obsidian. Плагин не назначает их по умолчанию. Названия команд зависят от языка интерфейса.

Действие в календаре Клавиши при фокусе в календаре
Предыдущий / следующий период ← / →
Вернуться к сегодняшнему дню T
Увеличить / уменьшить масштаб + / -
Изменить масштаб Ctrl или Cmd + ← / →
Вернуться к предыдущему положению Backspace
Закрыть обзор дня Escape

Эти клавиши не перехватываются во время ввода текста в поле. На сенсорном экране календарь поддерживает свайп для смены периода и жест двумя пальцами для масштаба. Для перетаскивания на доске начните движение с ручки; обычное прокручивание предназначено для просмотра. Свайп, начатый внутри плагина, прокручивает плагин; боковые панели Obsidian открывает только свайп от края экрана. Доступность отдельных жестов зависит от платформы и режима представления.

Настройки и решение проблем

В настройках плагина доступны ограничение размера проекта, первый день недели и параметры записи свойств. Параметры конкретного источника и представления меняйте в самом проекте.

Симптом Что проверить
Нет нужной заметки Путь источника, вложенные папки, тег, исключения и все уровни фильтров
Загружена только часть записей Ограничение размера проекта
Событие стоит не на той дате Поле начала, значение даты и часовой пояс календаря
Не доступен Dataview Установлен ли он и включён ли в этом хранилище
Поле нельзя редактировать Тип поля, вычисляемое значение и возможность записи в источник
Остались символы <% ... %> Выполнен ли шаблон через Templater
Изменения не сохранились Сообщение об ошибке и фактическое содержимое Markdown-файла
Настройки не записываются после конфликта Сообщение плагина; сохраните копию data.json перед восстановлением

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

Сообщить об ошибке · API пользовательских представлений

Исходник страницы ↗