OBS Projects Plus

Зачем этот плагин?

Obsidian хранит всё в обычных Markdown-файлах. Это удобно для текста, но когда заметок становится десятки или сотни — сложно понять, что и в каком состоянии.

Projects Plus превращает папку с заметками в управляемый проект: вы видите все задачи на канбан-доске, все события на календаре, все карточки в галерее — и всё это без экспорта, без облака, прямо в вашем хранилище.

Кому подойдёт

• Контент-менеджерам — отслеживать статус публикаций в таблице и на доске
• Исследователям — организовать источники, заметки и дедлайны с фильтрацией
• Планировщикам — видеть задачи на timeline-календаре с мультидневными событиями
• Всем, кто ведёт базу знаний — когда нужен визуальный обзор, а не список файлов

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

1. Вы указываете папку, тег или Dataview-запрос — это "проект"
2. Плагин собирает все подходящие заметки и читает их frontmatter (YAML-шапка)
3. Вы выбираете представление — таблица, доска, календарь или галерея
4. Редактируете поля прямо в интерфейсе — плагин записывает изменения обратно в файл

Данные остаются в ваших файлах. Плагин не создаёт собственную базу данных.

📸 Галерея

✨ Возможности

Календарь — полноценный планировщик: startDate, endDate, startTime, endTime, date (дата создания заметки), поле color для цветовой кодировки, бесконечный скролл, мобильные жесты (свайп, pinch-to-zoom, двойной тап для создания заметки).

Agenda 2.0 — боковая панель календаря с конструктором списков: 42 оператора фильтрации, вложенные AND/OR группы, формулы дат (today, sow, eom, today+1w), два режима — визуальный и Advanced (формулы в стиле Google Sheets).

Доска (Board) — закрепление статусов (persist): колонки остаются видимыми даже без записей, визуальные индикаторы, Ctrl+Scroll zoom (25–200%), адаптивная вёрстка, создание заметок с наследованием фильтров.

Три источника данных: папка, тег, Dataview-запрос. Шаблоны заметок, автосохранение, локализация (RU, EN, UA, ZH-CN).

Подробнее о горячих клавишах, жестах, шаблонах и настройках — в Руководстве пользователя.

📥 Установка

BRAT (рекомендуется)

1. Установите BRAT
2. В настройках BRAT добавьте: ParkPavel/obs-projects-plus
3. Включите плагин

Ручная установка

1. Скачайте main.js, manifest.json, styles.css из Releases
2. Поместите в .obsidian/plugins/obs-projects-plus/
3. Перезапустите Obsidian → Включите плагин

🚀 Быстрый старт

1. При первом включении плагин создаёт демо-проект (35+ заметок, 6 представлений)
2. Ctrl/Cmd+P → "Projects Plus: Show projects plus"
3. Попробуйте переключать виды: Таблица → Доска → Календарь → Галерея
4. Создайте свой проект: Ctrl/Cmd+P → "Projects Plus: Create Project"

# Пример frontmatter для заметки проекта
---
title: Моя задача
status: todo
priority: high
startDate: 2026-02-15
date: 2026-02-15
endDate: 2026-02-20
startTime: "09:00"
endTime: "18:00"
color: "#4CAF50"
tags: [проект, важное]
---

🗺️ Roadmap

// В вашем плагине (plugin.ts):
import { Plugin } from "obsidian";
import type { ProjectView, ProjectViewProps, DataQueryResult } from "obsidian-projects-types";

class MyCustomView extends ProjectView {
  getViewType(): string { return "my-view"; }
  getDisplayName(): string { return "My View"; }
  getIcon(): string { return "layout-grid"; }

  onOpen({ contentEl }: ProjectViewProps) {
    contentEl.createEl("h2", { text: "My Custom View" });
  }

  onData({ data }: DataQueryResult) {
    // data.fields — схема, data.records — заметки
  }

  onClose() { /* cleanup */ }
}

export default class MyPlugin extends Plugin {
  onRegisterProjectView = () => new MyCustomView();
}

git clone https://github.com/ParkPavel/obs-projects-plus.git
cd obs-projects-plus
npm ci
npm run dev       # esbuild watch mode
npm run build     # tsc + esbuild production
npm run test      # Jest (375 тестов, 21 suite)
npm run lint      # ESLint + eslint-plugin-obsidianmd (23 правила)
npm run format    # Prettier

📖 Документация

💬 Обратная связь

• Telegram: @parkpavel_chigon
• GitHub Issues: Сообщить о проблеме
• GitHub Discussions: Обсуждения

🙏 Благодарности

Форк оригинального Obsidian Projects от Marcus Olsson.
Текущий мейнтейнер: Park Pavel

📄 Лицензия

Apache License 2.0 © 2024–2026 Park Pavel