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
parent 80eb3c709d
commit d426aa39ed
13 changed files with 145 additions and 103 deletions
@@ -0,0 +1,202 @@
+# 🗺️ Дорожная карта проекта dedinit.ru
+
+## О документе
+
+Этот файл содержит план развития блога на базе Hugo и темы PaperMod.  
+Основная цель — создать кастомизированную русскоязычную тему для блога с поддержкой лонгридов, блоков кода и подсветки синтаксиса.
+
+---
+
+## ✅ Завершённые задачи
+
+### Инфраструктура
+- [x] Установка Hugo Extended 0.155.1
+- [x] Создание сайта dedinit.ru
+- [x] Установка темы PaperMod (как submodule)
+- [x] Настройка bundle формата для статей (папка с index.md)
+- [x] Решение проблемы совместимости Hugo и темы
+- [x] Настройка Git-репозитория
+- [x] Интеграция с Gitea (gitea.nixg.ru:2222 через SSH)
+
+### Кастомизация темы
+- [x] **Создание собственной темы rDedInit** на базе PaperMod
+- [x] Документирование структуры темы (STRUCTURE.md)
+- [x] **Настройка favicon и логотипа сайта** (docs/favicon-logo-setup.md)
+  - [x] Создан набор favicon в стиле пиксель-арт (SmileDed)
+  - [x] Добавлен логотип в шапку сайта (48px)
+  - [x] Настроены все стандартные размеры для браузеров и устройств
+
+### Контент
+- [x] Создание структуры папок content/posts/
+- [x] Написание первых статей (6 публикаций)
+
+### Деплой
+- [x] Настройка SFTP-деплоя на kpa39l.myjino.ru
+- [x] Создание Makefile для кроссплатформенной сборки и деплоя
+- [x] Настройка WinSCP для Windows
+
+### Конфигурация
+- [x] Базовая настройка hugo.toml
+- [x] Включение подсветки синтаксиса (github-dark)
+- [x] Настройка навигации и меню
+- [x] Включение отображения времени чтения, кнопок копирования кода
+
+---
+
+## 🎯 Краткосрочные задачи (1-2 недели)
+
+### Кастомизация темы rDedInit
+- [ ] **Настроить цветовую схему**
+  - [ ] Изменить CSS-переменные в `themes/rDedInit/assets/css/core/theme-vars.css`
+  - [ ] Подобрать цвета под бренд dedinit()
+  - [ ] Протестировать светлую и тёмную версии
+
+### Русификация и локализация
+- [ ] Проверить и дополнить русскоязычные переводы в `i18n/ru.toml`
+- [ ] Адаптировать тексты интерфейса под русскоязычную аудиторию
+  - [ ] «Read more» → «Читать далее»
+  - [ ] «Posted on» → «Опубликовано»
+  - [ ] «Tags» → «Теги»
+  - [ ] «Categories» → «Категории»
+
+### Визуальные изменения
+- [ ] Настроить цветовую схему под бренд dedinit()
+- [ ] Кастомизировать главную страницу
+- [x] Добавить кастомный favicon
+- [ ] Настроить типографику для удобного чтения лонгридов
+
+### Контент
+- [ ] Опубликовать 3-5 новых статей
+- [ ] Добавить обложки к статьям
+- [ ] Протестировать отображение на разных устройствах
+
+---
+
+## 📈 Среднесрочные задачи (1-2 месяца)
+
+### Улучшение темы
+- [x] **Кастомный header с логотипом** — добавлен логотип SmileDed 48px (docs/favicon-logo-setup.md)
+- [ ] **Разработка уникальных элементов дизайна**
+  - [ ] Уникальные стили для блоков кода
+  - [ ] Анимации и переходы (минималистичные)
+  - [ ] Кастомные иконки для социальных сетей
+
+- [ ] **Визуальное оформление Telegram-постов** ([Telegram_frontend.md](Telegram_frontend.md))
+  - [ ] Создать layout для типа контента `telegram`
+  - [ ] Реализовать карточки постов в стиле виджета Telegram
+  - [ ] Поддержка светлой/тёмной темы PaperMod
+  - [ ] Адаптивная вёрстка для мобильных устройств
+  - [ ] Shortcode для встраивания постов Telegram
+  - [ ] Страница списка всех Telegram-постов с пагинацией
+  - [ ] Разработать блок на главную страницу с последним постом из Telegram
+
+- [ ] **Улучшение навигации**
+  - [ ] Добавить хлебные крошки (breadcrumbs)
+  - [ ] Улучшить пагинацию
+  - [ ] Добавить оглавление для длинных статей
+
+- [ ] **SEO и метаданные**
+  - [ ] Настроить Open Graph теги
+  - [ ] Добавить Twitter Cards
+  - [ ] Настроить sitemap.xml
+  - [ ] Добавить schema.org разметку
+
+### Аналитика и мониторинг
+- [ ] Подключить Google Analytics / Яндекс.Метрику
+- [ ] Настроить отслеживание целей
+- [ ] Добавить robots.txt и sitemap
+
+### Производительность
+- [ ] Оптимизировать изображения (WebP, lazy loading)
+- [ ] Настроить кэширование
+- [ ] Провести аудит Lighthouse и устранить замечания
+
+---
+
+## 🚀 Долгосрочные задачи (3-6 месяцев)
+
+### Расширение функциональности
+- [ ] **Комментарии**
+  - [ ] Интеграция системы комментариев (Giscus, Utterances, или собственная)
+  - [ ] Модерация и управление
+
+- [ ] **Микроблог на основе Git-коммитов**
+  - [ ] Вывод комментариев к коммитам из Gitea/GitHub как отдельный раздел микроблога
+  - [ ] Автоматическая генерация постов на основе commit messages
+  - [ ] Интеграция с API Gitea для получения истории коммитов
+  - [ ] *Обоснование:* комментарии к коммитам — это часть технического лога проекта, которая может быть интересна читателям как «закулисный» контент о разработке
+
+- [ ] **Поиск по сайту**
+  - [ ] Настроить Fuse.js поиск (встроен в PaperMod)
+  - [ ] Улучшить выдачу результатов
+
+- [ ] **RSS и подписка**
+  - [ ] Настроить полноценные RSS-ленты
+  - [ ] Добавить возможность email-подписки
+
+- [ ] **Мультиязычность** (опционально)
+  - [ ] Добавить поддержку en/ru
+  - [ ] Переключатель языков
+
+### Контент-стратегия
+- [ ] Определить рубрики и категории
+- [ ] Составить контент-план на квартал
+- [ ] Написать серию статей по ключевым темам:
+  - [ ] MLOps / DevOps / SysOps
+  - [ ] Linux и администрирование
+  - [ ] CI/CD и автоматизация
+  - [ ] Личный опыт и best practices
+
+### Сообщество и продвижение
+- [ ] Добавить кнопки шеринга в соцсети
+- [ ] Подключить веб-манифест (PWA)
+- [ ] Зарегистрировать сайт в поисковых системах
+- [ ] Настроить обратные ссылки
+
+---
+
+## 🛠️ Технические долги
+
+- [ ] Обновлять Hugo и тему PaperMod регулярно
+- [ ] Следить за безопасностью зависимостей
+- [ ] Делать бэкапы контента
+- [ ] Документировать изменения в теме
+
+---
+
+## 📝 Идеи на будущее
+
+- [ ] Тёмная тема с уникальным дизайном
+- [ ] Интерактивные элементы в статьях (диаграммы, графики)
+- [ ] Интеграция с Mermaid.js для схем
+- [ ] Страница «Об авторе» с фото и биографией
+- [ ] Страница 404 с кастомным дизайном
+- [ ] Страница «Спасибо» / «Поддержать проект»
+
+---
+
+## 📊 Приоритеты
+
+| Приоритет | Задача | Оценка времени |
+|-----------|--------|----------------|
+| 🔴 Высокий | Создание собственной темы на базе PaperMod | 2-3 дня |
+| 🔴 Высокий | Русификация интерфейса | 1 день |
+| 🟡 Средний | Визуальная кастомизация | 3-5 дней |
+| 🟡 Средний | SEO и аналитика | 2-3 дня |
+| 🟢 Низкий | Комментарии и поиск | 1-2 недели |
+
+---
+
+## 📅 Последнее обновление
+
+**Дата:** 27 февраля 2026 г.  
+**Статус:** В работе
+
+---
+
+## 🔗 Полезные ссылки
+
+- [Документация PaperMod](https://github.com/adityatelange/hugo-PaperMod/wiki)
+- [Документация Hugo](https://gohugo.io/documentation/)
+- [Темы Hugo](https://themes.gohugo.io/)
+- [Hugo Discord сообщество](https://discord.gg/ahpmTvhVmp)