estorozhenko
d426aa39ed
- 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
9.9 KiB
9.9 KiB
🗺️ Дорожная карта проекта dedinit.ru
О документе
Этот файл содержит план развития блога на базе Hugo и темы PaperMod.
Основная цель — создать кастомизированную русскоязычную тему для блога с поддержкой лонгридов, блоков кода и подсветки синтаксиса.
✅ Завершённые задачи
Инфраструктура
- Установка Hugo Extended 0.155.1
- Создание сайта dedinit.ru
- Установка темы PaperMod (как submodule)
- Настройка bundle формата для статей (папка с index.md)
- Решение проблемы совместимости Hugo и темы
- Настройка Git-репозитория
- Интеграция с Gitea (gitea.nixg.ru:2222 через SSH)
Кастомизация темы
- Создание собственной темы rDedInit на базе PaperMod
- Документирование структуры темы (STRUCTURE.md)
- Настройка favicon и логотипа сайта (docs/favicon-logo-setup.md)
- Создан набор favicon в стиле пиксель-арт (SmileDed)
- Добавлен логотип в шапку сайта (48px)
- Настроены все стандартные размеры для браузеров и устройств
Контент
- Создание структуры папок content/posts/
- Написание первых статей (6 публикаций)
Деплой
- Настройка SFTP-деплоя на kpa39l.myjino.ru
- Создание Makefile для кроссплатформенной сборки и деплоя
- Настройка WinSCP для Windows
Конфигурация
- Базовая настройка hugo.toml
- Включение подсветки синтаксиса (github-dark)
- Настройка навигации и меню
- Включение отображения времени чтения, кнопок копирования кода
🎯 Краткосрочные задачи (1-2 недели)
Кастомизация темы rDedInit
- Настроить цветовую схему
- Изменить CSS-переменные в
themes/rDedInit/assets/css/core/theme-vars.css - Подобрать цвета под бренд dedinit()
- Протестировать светлую и тёмную версии
- Изменить CSS-переменные в
Русификация и локализация
- Проверить и дополнить русскоязычные переводы в
i18n/ru.toml - Адаптировать тексты интерфейса под русскоязычную аудиторию
- «Read more» → «Читать далее»
- «Posted on» → «Опубликовано»
- «Tags» → «Теги»
- «Categories» → «Категории»
Визуальные изменения
- Настроить цветовую схему под бренд dedinit()
- Кастомизировать главную страницу
- Добавить кастомный favicon
- Настроить типографику для удобного чтения лонгридов
Контент
- Опубликовать 3-5 новых статей
- Добавить обложки к статьям
- Протестировать отображение на разных устройствах
📈 Среднесрочные задачи (1-2 месяца)
Улучшение темы
-
Кастомный header с логотипом — добавлен логотип SmileDed 48px (docs/favicon-logo-setup.md)
-
Разработка уникальных элементов дизайна
- Уникальные стили для блоков кода
- Анимации и переходы (минималистичные)
- Кастомные иконки для социальных сетей
-
Визуальное оформление Telegram-постов (Telegram_frontend.md)
- Создать layout для типа контента
telegram - Реализовать карточки постов в стиле виджета Telegram
- Поддержка светлой/тёмной темы PaperMod
- Адаптивная вёрстка для мобильных устройств
- Shortcode для встраивания постов Telegram
- Страница списка всех Telegram-постов с пагинацией
- Разработать блок на главную страницу с последним постом из Telegram
- Создать layout для типа контента
-
Улучшение навигации
- Добавить хлебные крошки (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 г.
Статус: В работе