Obsidian Yandex Calendar Integration

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

Описание

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

Установка

Если плагин добавлен в Community plugins

1. Откройте Obsidian
2. Перейдите в Настройки → Community plugins
3. Отключите Restricted mode (если включен)
4. Нажмите "Browse" и найдите "Yandex Calendar Integration"
5. Установите плагин и активируйте его

Альтернативная установка (если плагина нет в Community Plugins)

Если плагин недоступен в официальном каталоге Community Plugins, вы можете установить его вручную:

1. Скачайте последнюю версию плагина из репозитория GitHub:
   • Перейдите на страницу релизов плагина
   • Скачайте архив obsidian-yandex-calendar-integration.zip
2. Распакуйте архив в папку плагинов Obsidian:
   • Откройте папку вашего vault Obsidian
   • Перейдите в подпапку .obsidian/plugins/
   • Создайте папку obsidian-yandex-calendar-integration
   • Скопируйте все файлы из распакованного архива в эту папку
3. Активируйте плагин:
   • Перезапустите Obsidian
   • Перейдите в Настройки → Community plugins
   • Активируйте "Yandex Calendar Integration" в списке установленных плагинов

Настройка

1. Ввод email:
   • Введите email, который используется для доступа к Яндекс Календарю
2. Сохранение пароля приложения Яндекс:
   • Введите пароль приложения для Яндекс Календаря (сгенерированный в Пароли приложений)
   • Пароль будет сохранен безопасно (с использованием встроенного безопасного хранилища Obsidian)
3. Event task pattern
   • Введите шаблон для форматирования событий

Важно

• Пароль нужно ввести только один раз при настройке
• После сохранения пароля плагин будет автоматически использовать его для всех последующих запросов
• Для смены пароля используйте кнопку "Clear Password" в настройках

Использование

Автоматическое получение событий

1. Откройте ежедневную заметку (Daily Note)
2. Установите курсор в место, куда хотите вставить события
3. Выполните одно из следующих действий:
   • Используйте горячие клавиши (назначаются в настройках Obsidian)
   • Вызовите командную палитру (Ctrl/Cmd + P) и выполните команду: "Yandex Calendar Integration: Вставить событие из Яндекс Календаря в позицию курсора"

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

• Плагин определяет дату текущей ежедневной заметки
• Отправляет запрос к API Яндекс Календаря для получения событий этого дня
• Форматирует события согласно заданному шаблону
• Вставляет события в позицию курсора

Настройка шаблона событий

Вы можете настроить формат отображения событий используя следующие переменные:

Доступные поля

• ${summary} - название события
• ${dateStart} - полная дата начала события
• ${dateEnd} - полная дата окончания события
• ${timeStart} - время начала события
• ${timeEnd} - время окончания события
• ${description} - описание события
• ${url} - ссылка на событие

Примеры шаблонов

Стандартный шаблон:

- [ ] ${timeStart} - ${timeEnd}: ${summary}
    Описание: ${description}
    Ссылка на событие: ${url}

Результат добавления событий в заметку с данным шаблоном:

Простой шаблон:

- ${timeStart}-${timeEnd} | ${summary}

Подробный шаблон:

## ${summary}
**Время:** ${timeStart} - ${timeEnd}
**Описание:** ${description}
[Ссылка](${url})

Требования

• Аккаунт Яндекс с доступом к Яндекс Календарю
• Включенный плагин Daily Notes в Obsidian
• Стабильное интернет-соединение для синхронизации с календарем

Безопасность

• Пароли хранятся в защищенном хранилище Obsidian
• Данные передаются через защищенное HTTPS-соединение
• Плагин имеет доступ только к вашему календарю Яндекс

Устранение неполадок

События не вставляются:

• Проверьте подключение к интернету
• Убедитесь, что открыта ежедневная заметка
• Проверьте правильность email и пароля в настройках

Поддержка

Если у вас возникли проблемы или есть предложения по улучшению плагина, создайте issue в репозитории плагина на GitHub.

Разработчик

👨‍💻 Пахомов Сергей

• GitHub: @CaDuCT-3aTeuHuK
• LinkedIn: Пахомов Сергей
• Telegram: Чат Пахомов Сергей | java-dev/ментор

---

Примечание: Для работы плагина требуется аккаунт Яндекса и корректно настроенные ежедневные заметки в Obsidian.