Плагин Git Sync для Obsidian

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

Возможности

• Аутентификация GitHub: Безопасная аутентификация с использованием персональных токенов доступа
• Автоматическая синхронизация: Синхронизация заметок автоматически при создании, изменении или удалении файлов
• Двунаправленная синхронизация: Получение изменений из GitHub и отправка локальных изменений
• Разрешение конфликтов: Базовое обнаружение и разрешение конфликтов при одновременном редактировании
• Интерфейс настроек: Легкая настройка через панель настроек Obsidian
• Мобильная совместимость: Полная поддержка мобильных устройств с оптимизациями для экономии батареи и трафика

Установка

1. Скачайте файлы плагина (manifest.json и main.js)
2. Поместите их в директорию вашего хранилища Obsidian .obsidian/plugins/git-sync-plugin/
3. Перезагрузите Obsidian и включите плагин в Настройки > Сообщество плагинов

Настройка

1. Создайте персональный токен доступа GitHub:

   • Перейдите в Настройки GitHub > Developer settings > Personal access tokens
   • Создайте новый токен с разрешениями repo
   • Скопируйте токен

2. Настройте плагин:

   • Откройте настройки Obsidian
   • Перейдите в настройки "Git Sync Plugin"
   • Введите ваш токен GitHub
   • Введите владельца репозитория (имя пользователя или организации)
   • Введите имя репозитория
   • Установите ветку (по умолчанию: main)

3. Аутентификация:

   • Используйте палитру команд (Ctrl/Cmd + P)
   • Запустите "Authenticate with GitHub" для проверки ваших учетных данных

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

Команды

• Sync Notes with GitHub: Выполняет полную двунаправленную синхронизацию
• Pull Notes from GitHub: Загружает новые и обновленные файлы из репозитория
• Authenticate with GitHub: Проверяет ваше подключение к GitHub

Автоматическая синхронизация

При включении в настройках:

• Новые заметки автоматически загружаются в GitHub
• Измененные заметки автоматически обновляются в GitHub
• Удаленные заметки автоматически удаляются из GitHub

Ручная синхронизация

Используйте команды синхронизации, когда хотите:

• Получить последние изменения от соавторов
• Убедиться, что все ваши локальные изменения сохранены
• Разрешить любые конфликты синхронизации

Настройки

• GitHub Token: Ваш персональный токен доступа
• Repository Owner: Имя пользователя или название организации GitHub
• Repository Name: Название репозитория для синхронизации
• Branch: Ветка для синхронизации (по умолчанию: main)
• Sync on Save: Включить автоматическую синхронизацию при сохранении файлов
• Auto Pull: Автоматически получать изменения из репозитория (будущая функция)
• Disable Auto Sync on Mobile: Отключить автоматическую синхронизацию на мобильных устройствах для экономии батареи и трафика

Мобильная версия

Плагин полностью совместим с мобильной версией Obsidian и включает специальные оптимизации:

• Увеличенный таймаут: 30 секунд для запросов (учитывая возможные проблемы с мобильным интернетом)
• Отключение авто-синхронизации: Возможность отключить автоматическую синхронизацию на мобильных устройствах
• Уведомления: Специальные сообщения о работе на мобильном устройстве
• Экономия ресурсов: Оптимизированная работа для сохранения заряда батареи и мобильного трафика

Рекомендации для мобильного использования:

• Используйте ручную синхронизацию вместо автоматической
• Включите настройку "Disable Auto Sync on Mobile" для экономии батареи
• Синхронизируйте при подключении к Wi-Fi для экономии мобильного трафика
• Регулярно проверяйте подключение к интернету перед синхронизацией

Разрешение конфликтов

Когда обнаруживаются конфликты (оба файла - локальный и удаленный - были изменены):

• Создается файл .conflicted с обеими версиями
• Требуется ручное разрешение
• После разрешения удалите файл конфликта и синхронизируйте снова