vault backup: 2025-08-04 15:56:06

This commit is contained in:
Andrey Epifancev
2025-08-04 15:56:06 +04:00
parent d7a41e5e21
commit 616d2548eb

View File

@@ -1,25 +1,14 @@
# Миграция контента на Hugo
## 1. Понимание текущей архитектуры
## 1. Понимание архитектуры
### 1.1 Текущий флоу (Quartz)
```
Obsidian Vault → Quartz → Static Site → Nginx
```
**Компоненты:**
- **Obsidian Vault**: Исходные Markdown документы
- **Quartz**: Генератор статического сайта на Node.js
- **Static Site**: Собранные HTML/CSS/JS файлы
- **Nginx**: Веб-сервер для раздачи статики
### 1.2 Новый флоу (Hugo)
### 1.1 Флоу работы
```
Obsidian Vault → Hugo → Static Site → Nginx (в Docker)
```
**Компоненты:**
- **Obsidian Vault**: Те же исходные Markdown документы
- **Obsidian Vault**: Исходные Markdown документы
- **Hugo**: Генератор статического сайта на Go
- **Static Site**: Оптимизированные HTML/CSS/JS файлы
- **Nginx**: Веб-сервер в Docker контейнере
@@ -251,25 +240,83 @@ graph TB
- Оптимизация времени сборки
- Эффективное использование диска
## 8. Преимущества миграции
## 8. Сравнение Hugo vs Quartz
### 8.1 Производительность
### 8.1 Преимущества Hugo перед Quartz
**Производительность:**
- **Время сборки**: Hugo в 5-10 раз быстрее
- **Потребление памяти**: Снижение на 70-80%
- **CPU нагрузка**: Минимальная нагрузка
- **Время загрузки**: Улучшение на 40-60%
**Технические:**
- **Язык**: Go vs Node.js (более эффективный)
- **Зависимости**: Минимальные vs множество npm пакетов
- **Размер**: Один бинарник vs множество файлов
- **Сборка**: Компиляция vs интерпретация
**Операционные:**
- **Развертывание**: Простое Docker развертывание
- **Мониторинг**: Встроенные метрики
- **Безопасность**: Меньше уязвимостей
- **Стабильность**: Более предсказуемое поведение
### 8.2 Недостатки Hugo перед Quartz
**Функциональность:**
- **Готовые компоненты**: Меньше готовых решений
- **Экосистема**: Меньше плагинов и тем
- **Гибкость**: Менее гибкая настройка
- **Сообщество**: Меньше готовых решений для Obsidian
**Разработка:**
- **Кривая обучения**: Сложнее для новичков
- **Документация**: Меньше примеров для Obsidian
- **Отладка**: Сложнее отладка шаблонов
- **Кастомизация**: Требует больше знаний
**Интеграция:**
- **Obsidian специфика**: Меньше готовых решений
- **Wiki ссылки**: Требует дополнительной обработки
- **Frontmatter**: Другой формат
- **Плагины**: Ограниченная совместимость
## 9. Преимущества миграции
### 9.1 Производительность
- **Время сборки**: С 30-60 секунд до 5-10 секунд
- **Потребление памяти**: С 512MB до 128MB
- **CPU нагрузка**: Снижение на 70-80%
- **Время загрузки**: Улучшение на 40-60%
### 8.2 Операционные
### 9.2 Операционные
- **Простота развертывания**: Docker Compose
- **Изоляция**: Контейнеры
- **Автоматическое обновление**: Без перезагрузки сервисов
- **Масштабируемость**: Легкое горизонтальное масштабирование
- **Мониторинг**: Встроенные метрики
### 8.3 Интеграция
### 9.3 Интеграция
- **Сохранение рабочего флоу**: Obsidian → Git → Hugo
- **Сохранение структуры**: Без изменений в организации файлов
- **Граф записей**: Интерактивная визуализация связей
- **Автоматизация**: Webhook → Сборка → Деплой
- **Консистентность**: Один источник истины
- **Простота отладки**: Единый лог и контекст
## 10. Применимость
### 10.1 Идеальные сценарии
- Один пользователь или небольшая команда
- VPS с ограниченными ресурсами
- Простота развертывания важнее сложной функциональности
- Быстрая итерация и отладка
- Готовность к дополнительной настройке
### 10.2 Неподходящие сценарии
- Большие команды разработчиков
- Критически важные production системы
- Сложные требования к кастомизации
- Необходимость готовых решений "из коробки"
- Ограниченное время на настройку