# 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. **Сохранение пароля приложения Яндекс**:
    - Введите пароль приложения для Яндекс Календаря (сгенерированный в [Пароли приложений](https://id.yandex.ru/security/app-passwords))
    - Пароль будет сохранен безопасно (с использованием встроенного безопасного хранилища 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}` - ссылка на событие

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

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

```text
- [ ] ${timeStart} - ${timeEnd}: ${summary}
    Описание: ${description}
    Ссылка на событие: ${url}
```
Результат добавления событий в заметку с данным шаблоном:  
![alt text](<docs/imgs/Pasted image 20251125023331.png>)

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

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

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

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

## Требования

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

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

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

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

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

## Поддержка

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

## Разработчик
👨‍💻 **Пахомов Сергей**
- GitHub: [@CaDuCT-3aTeuHuK](https://github.com/CaDuCT-3aTeuHuK)
- LinkedIn: [Пахомов Сергей](https://www.linkedin.com/in/%D1%81%D0%B5%D1%80%D0%B3%D0%B5%D0%B9-%D0%BF%D0%B0%D1%85%D0%BE%D0%BC%D0%BE%D0%B2-427b62217?trk=contact-info)
- Telegram: [Чат Пахомов Сергей | java-dev/ментор](https://t.me/spakhomov_java)

---

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