Files

T

estorozhenko d426aa39ed chore(docs): уборка структуры — вся документация в docs/, краткий README, добавлен AGENTS.md

- AGENTS.md: правила проекта (структура доков, стек, статьи, деплой, git, openspec, проверки)
- README.md: сокращён до введения + указателей на docs/
- docs/: DEPLOY_INSTRUCTIONS, ROADMAP, PAPERMOD_PARAMS, QWEN, gitea-setup,
  Telegram_frontend, ssh_setup, archive/PROJECT_SUMMARY (из .qwen/)
- tools/: winscp_script.txt переехал из корня к deploy_sftp.py
- Makefile и deploy_sftp.py: ссылки на docs/DEPLOY_INSTRUCTIONS.md

2026-09-12 09:58:09 +00:00

7.5 KiB

Raw Permalink Blame History

Настройки взаимодействия

Общие принципы работы

Все важные решения и изменения фиксируются в README.md
Взаимодействие происходит на русском языке
Перед применением изменений проверяется корректность принятых решений
Цель — максимально быстро запустить проект для публикации контента

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

dedinit.ru — блог на основе генератора статических сайтов Hugo с кастомной темой rDedInit (форк PaperMod).

Основная цель: платформа для публикации лонгридов с поддержкой блоков кода и подсветки синтаксиса.

Технические характеристики

Параметр	Значение
Генератор	Hugo Extended 0.155.1
Тема	rDedInit (форк PaperMod)
Язык	Русский (ru-ru)
Формат статей	Bundle (папка с index.md)
Деплой	SFTP (kpa39l.myjino.ru:2222)

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

dedinit.ru/
├── content/
│   ├── posts/           # Статьи блога (bundle формат)
│   └── telegram/        # Telegram-посты (планируется)
├── themes/
│   └── rDedInit/        # Кастомная тема на базе PaperMod
├── static/
│   └── images/
│       └── favicon/     # Favicon в стиле пиксель-арт (SmileDed)
├── public/              # Сгенерированный сайт (исключён из git)
├── layouts/             # Кастомные шаблоны (если есть)
├── assets/              # CSS/JS ресурсы
├── hugo.toml            # Конфигурация Hugo
├── Makefile             # Команды сборки и деплоя
└── docs/                # Документация

Проверочные действия

Перед выполнением каждого этапа выполняются проверки:

Наличие установленного Hugo (hugo version)
Возможность сборки сайта (hugo)
Корректность настроек темы (проверка hugo.toml)
Работоспособность деплоя (make deploy-dry-run)

Команды проекта

Сборка и запуск

hugo              # Генерация сайта в public/
hugo server       # Локальный сервер (http://localhost:1313)
make build        # Сборка через Makefile
make clean        # Очистка public/
make rebuild      # Полная пересборка

Деплой

make deploy           # Сборка + деплой на хостинг
make deploy-dry-run   # Симуляция деплоя
make help             # Список доступных команд

Параметры деплоя

Параметр	Значение
Хост	kpa39l.myjino.ru
Порт SFTP	2222
Пользователь	kpa39l_dedinit
Путь	/dedinit.ru

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

Структура проекта: Git-репозиторий инициализирован в папке с Hugo-сайтом
Формат статей: Bundle (папка с index.md) для удобного хранения статьи и связанных файлов
Тема rDedInit: Собственная тема на базе PaperMod с русификацией
Деплой: Кроссплатформенный (rsync для Unix, WinSCP для Windows)
Favicon: Набор в стиле пиксель-арт (SmileDed) с логотипом 48px в шапке
Подсветка кода: github-dark стиль с номерами строк

Конфигурация темы (hugo.toml)

Основные параметры

baseURL = 'https://dedinit.ru/'
title = 'dedinit()'
theme = 'rDedInit'
timeZone = 'Europe/Moscow'
metaDataFormat = "yaml"

Параметры PaperMod

[params]
  env = "production"
  defaultTheme = "auto"
  ShowReadingTime = true
  ShowPostNavLinks = true
  ShowBreadCrumbs = true
  ShowCodeCopyButtons = true
  disableSpecial1stPost = true

[markup.highlight]
  style = "github-dark"
  lineNos = true
  tabWidth = 4

Дорожная карта (ROADMAP)

Завершённые задачи ✅

Установка Hugo Extended 0.155.1
Создание сайта dedinit.ru
Установка темы PaperMod (submodule)
Создание собственной темы rDedInit
Настройка bundle формата статей
Настройка favicon и логотипа (SmileDed)
SFTP-деплой на kpa39l.myjino.ru
Написание первых статей (6 публикаций)

Текущие задачи 🎯

Настройка цветовой схемы темы
Русификация интерфейса (i18n/ru.yaml)
Визуальное оформление Telegram-постов
Публикация новых статей

Планы 📈

SEO оптимизация (Open Graph, sitemap)
Аналитика (Google Analytics/Яндекс.Метрика)
Поиск по сайту (Fuse.js)
Комментарии (Giscus/Utterances)

Примечания

Важно обеспечить поддержку блоков кода и подсветки синтаксиса
Проект должен быть готов к публикации контента как можно скорее
Папка public/ исключена из git-репозитория
Для обновления Hugo: winget install Hugo.Hugo.Extended

Информация о системе

ОС: Windows 11
Hugo установлена через winget
Требуется перезапуск терминала после установки/обновления Hugo
Текущая версия Hugo: 0.155.1

Полезные ссылки

Документация PaperMod
Документация Hugo
PAPERMOD_PARAMS.md — полный справочник параметров темы
ROADMAP.md — дорожная карта проекта
DEPLOY_INSTRUCTIONS.md — инструкция по деплою

Файлы документации

Файл	Описание
README.md	Основное описание проекта (кратко)
docs/ROADMAP.md	Дорожная карта развития
docs/PAPERMOD_PARAMS.md	Справочник параметров темы
docs/DEPLOY_INSTRUCTIONS.md	Инструкция по деплою
docs/gitea-setup.md	Настройка интеграции с Gitea
docs/favicon-logo-setup.md	Настройка favicon и логотипа
docs/Telegram_frontend.md	Оформление Telegram-постов

Последнее обновление: 5 марта 2026 г.

7.5 KiB Raw Permalink Blame History Unescape Escape