Files
dedinit.ru/README.md
T
2026-02-02 20:56:42 +03:00

4.9 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

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

  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)
  • winscp_script.txt - скрипт для WinSCP с командами подключения и синхронизации
  • DEPLOY_INSTRUCTIONS.md - инструкция по использованию команд деплоя

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

make deploy

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

make help

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