5.0 KiB
5.0 KiB
dedinit.ru
Описание проекта
Этот проект представляет собой блог на основе генератора статических сайтов Hugo с темой PaperMod. Основная цель проекта - создать платформу для публикации лонгридов с поддержкой блоков кода и подсветки синтаксиса, чего не хватает в других сервисах (Telegraph, VK, Writefreely).
Технические детали
- Генератор статических сайтов: Hugo (расширенная версия)
- Тема оформления: PaperMod (https://github.com/adityatelange/hugo-PaperMod)
- Хранение контента: Gitea сервер (gitea.nixg.ru) через SSH
- Настройка: bundle хранение статей
Статус проекта
Проект находится в стадии разработки. Выполненные задачи:
- Установлена Hugo расширенная версия (0.155.1)
- Создан новый сайт dedinit.ru
- Установлена и настроена тема PaperMod
- Настроено bundle хранение статей
- Решена проблема совместимости Hugo и темы PaperMod
История изменений
31 января 2026 года
- Установлена Hugo расширенная версия 0.155.1
- Создан новый сайт dedinit.ru
- Установлена тема PaperMod
- Настроено bundle хранение статей
- Создан пример статьи в формате bundle
- Настроена интеграция с Gitea сервером (требуется дополнительная настройка SSH)
1 февраля 2026 года
- Разработано решение для деплоя сайта через SFTP
- Настроен Makefile для кроссплатформенного деплоя (Windows/Linux/macOS)
- Создан скрипт winscp_script.txt для подключения и синхронизации файлов
- Обновлены инструкции по деплою в DEPLOY_INSTRUCTIONS.md и README.md
- Удалены экспериментальные файлы, оставшиеся от поиска решения
Принятые технические решения
- Выбор Hugo: Выбран генератор статичных сайтов Hugo для быстродействия и гибкости
- Расширенная версия Hugo: Используется расширенная версия для поддержки SCSS
- Тема PaperMod: Легкая и адаптивная тема с поддержкой темной/светлой темы
- Bundle хранение статей: Используется формат bundle (папка с index.md) для удобного хранения статьи и связанных файлов
- Хранение на Gitea: Контент хранится на собственном Gitea сервере для полного контроля
- SSH подключение: Используется SSH для безопасного доступа к репозиторию
- Структура проекта: Правильная иерархия папок с .gitignore для исключения ненужных файлов
Запуск проекта
Для генерации сайта и просмотра его в браузере используйте следующие команды:
hugo- генерирует статический сайт в папкуpublichugo server- запускает локальный сервер для предварительного просмотра сайта в браузере (обычно доступен по адресу http://localhost:1313)
Деплой сайта
Для автоматизации процесса деплоя созданы специальные файлы:
Makefile- содержит команды для сборки и публикации сайта на хостинге (работает как на Unix-подобных системах, так и на Windows)winscp_script.txt- скрипт для WinSCP с командами подключения и синхронизацииDEPLOY_INSTRUCTIONS.md- инструкция по использованию команд деплоя
Для публикации сайта на хостинге используйте команду:
make deploy
Для получения полного списка доступных команд используйте:
make help