68 lines
4.4 KiB
Markdown
68 lines
4.4 KiB
Markdown
# 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. **Выбор Hugo**: Выбран генератор статичных сайтов Hugo для быстродействия и гибкости
|
||
2. **Расширенная версия Hugo**: Используется расширенная версия для поддержки SCSS
|
||
3. **Тема PaperMod**: Легкая и адаптивная тема с поддержкой темной/светлой темы
|
||
4. **Bundle хранение статей**: Используется формат bundle (папка с index.md) для удобного хранения статьи и связанных файлов
|
||
5. **Хранение на Gitea**: Контент хранится на собственном Gitea сервере для полного контроля
|
||
6. **SSH подключение**: Используется SSH для безопасного доступа к репозиторию
|
||
7. **Структура проекта**: Правильная иерархия папок с .gitignore для исключения ненужных файлов
|
||
|
||
## Запуск проекта
|
||
|
||
Для генерации сайта и просмотра его в браузере используйте следующие команды:
|
||
|
||
- `hugo` - генерирует статический сайт в папку `public`
|
||
- `hugo server` - запускает локальный сервер для предварительного просмотра сайта в браузере (обычно доступен по адресу http://localhost:1313)
|
||
|
||
## Деплой сайта
|
||
|
||
Для автоматизации процесса деплоя созданы специальные файлы:
|
||
|
||
- `Makefile` - содержит команды для сборки и публикации сайта на хостинге (работает как на Unix-подобных системах, так и на Windows)
|
||
- `deploy.ps1` - PowerShell-скрипт для деплоя на Windows с использованием WinSCP
|
||
- `DEPLOY_INSTRUCTIONS.md` - инструкция по использованию команд деплоя
|
||
|
||
Для публикации сайта на хостинге используйте команду:
|
||
```
|
||
make deploy
|
||
```
|
||
|
||
Для получения полного списка доступных команд используйте:
|
||
```
|
||
make help
|
||
```
|
||
|
||
Процесс деплоя кроссплатформенный: на Unix-подобных системах используется rsync, на Windows - PowerShell-скрипт с WinSCP. |