# 🗺️ Дорожная карта проекта 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`
  - [ ] Добавить в тему rDedInit shortcode для вкладок (tabs) — для перевода файла html-and-css-only-tabs.md из темы по умолчанию
  - [ ] Реализовать карточки постов в стиле виджета 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)