Этот проект представляет собой блог на основе генератора статических сайтов 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

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

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

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

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

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

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

Деплой сайта

ЕДИНСТВЕННЫЙ способ деплоя сайта — make deploy. Не деплойте вручную (rsync/ssh-exec напрямую не работают: аккаунт Jino SFTP-only).

Специальные файлы:

Makefile — команды сборки и публикации (Unix: SFTP через tools/deploy_sftp.py на paramiko; Windows: WinSCP.com)
tools/deploy_sftp.py — рекурсивный mirror public/ → /dedinit.ru (с удалением лишнего, как rsync --delete), пароль из env SSHPASS
winscp_script.txt — скрипт для WinSCP (Windows)
DEPLOY_INSTRUCTIONS.md — инструкция по деплою

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

export SSHPASS='<пароль SFTP из DEPLOY_INSTRUCTIONS.md>'
make deploy

Первая сборка создаст .venv/ (paramiko). Для получения полного списка команд:

make help

Процесс кроссплатформенный: на Unix — SFTP (paramiko), на Windows — WinSCP.com. НЕ удаляйте make deploy и не заменяйте его на прямой rsync.