# dedinit.ru

## Описание проекта

Этот проект представляет собой блог на основе генератора статических сайтов Hugo с темой PaperMod. Основная цель проекта - создать платформу для публикации лонгридов с поддержкой блоков кода и подсветки синтаксиса, чего не хватает в других сервисах (Telegraph, VK, Writefreely).

## Технические детали

- Генератор статических сайтов: Hugo (расширенная версия)
- Тема оформления: PaperMod (<https://github.com/adityatelange/hugo-PaperMod>)
- Хранение контента: GitVerse (<gitverse.ru:kpa39l/dedinit.ru>) через SSH
- Настройка: bundle хранение статей

## Статус проекта

Проект находится в стадии разработки. Выполненные задачи:

- Установлена Hugo расширенная версия (0.155.1)
- Создан новый сайт dedinit.ru
- Установлена и настроена тема PaperMod
- Настроено bundle хранение статей
- Решена проблема совместимости Hugo и темы PaperMod
- Репозиторий подключён к GitVerse (gitverse.ru:kpa39l/dedinit.ru)
- **Создана собственная тема rDedInit** на базе PaperMod

## История изменений

### 30 августа 2026 года

- Написана и опубликована статья «Как я перевёл aux-задачи Hermes на локальные модели» (пост `20260830 - local aux models hermes`, slug `local-aux-models-hermes-qwen3`)
- Исправлена сборка с современными версиями Hugo: добавлен `defaultContentLanguage = 'ru'` в hugo.toml (Hugo 0.123+ требует, чтобы defaultContentLanguage совпадал с одним из `[languages]`, иначе ошибка `config value "en" does not match any language definition`)
- Установлен локальный git identity в репозитории: Storozhenko Evgeny <kpa39l@yandex.ru>
- Подробный опыт настройки локальных aux-моделей Hermes задокументирован в [docs/local-aux-models.md](docs/local-aux-models.md)

### 31 января 2026 года

- Установлена Hugo расширенная версия 0.155.1
- Создан новый сайт dedinit.ru
- Установлена тема PaperMod
- Настроено bundle хранение статей
- Создан пример статьи в формате bundle
- Настроена интеграция с Gitea сервером

### 5 марта 2026 года

- Миграция репозитория на GitVerse (gitverse.ru:kpa39l/dedinit.ru)

### 1 февраля 2026 года

- Разработано решение для деплоя сайта через SFTP
- Настроен Makefile для кроссплатформенного деплоя (Windows/Linux/macOS)
- Создан скрипт winscp_script.txt для подключения и синхронизации файлов
- Обновлены инструкции по деплою в DEPLOY_INSTRUCTIONS.md и README.md

## Принятые технические решения

1. **Выбор Hugo**: Выбран генератор статичных сайтов Hugo для быстродействия и гибкости
2. **Расширенная версия Hugo**: Используется расширенная версия для поддержки SCSS
3. **Тема PaperMod**: Легкая и адаптивная тема с поддержкой темной/светлой темы
4. **Bundle хранение статей**: Используется формат bundle (папка с index.md) для удобного хранения статьи и связанных файлов
5. **Хранение на GitVerse**: Контент хранится на GitVerse для полного контроля
6. **SSH подключение**: Используется SSH для безопасного доступа к репозиторию
7. **Структура проекта**: Правильная иерархия папок с .gitignore для исключения ненужных файлов

## Запуск проекта

Для генерации сайта и просмотра его в браузере используйте следующие команды:

- `hugo` - генерирует статический сайт в папку `public`
- `hugo server` - запускает локальный сервер для предварительного просмотра сайта в браузере (обычно доступен по адресу <http://localhost:1313>)

## Деплой сайта

Для автоматизации процесса деплоя созданы специальные файлы:

- `Makefile` - содержит команды для сборки и публикации сайта на хостинге (работает как на Unix-подобных системах, так и на Windows)
- `winscp_script.txt` - скрипт для WinSCP с командами подключения и синхронизации
- `DEPLOY_INSTRUCTIONS.md` - инструкция по использованию команд деплоя

Для публикации сайта на хостинге используйте команду:

```shell
make deploy
```

Для получения полного списка доступных команд используйте:

```shell
make help
```

Процесс деплоя кроссплатформенный: на Unix-подобных системах используется rsync, на Windows - WinSCP.com для SFTP-подключения