Добавлена статья: Коммунизм не утопия (12.04.2026)

QWEN.md

@@ -5,44 +5,181 @@
 1. Все важные решения и изменения фиксируются в README.md
 2. Взаимодействие происходит на русском языке
 3. Перед применением изменений проверяется корректность принятых решений
-4. Цель - максимально быстро запустить проект для публикации контента
+4. Цель — максимально быстро запустить проект для публикации контента
 
-## Текущая задача
+## Описание проекта
 
-Организация блога на основе Hugo с темой PaperMod:
-- Установка Hugo расширенной версии
-- Создание нового сайта dedinit.ru
-- Установка темы PaperMod
-- Настройка bundle хранения статей
-- Интеграция с Gitea сервером gitea.nixg.ru через SSH
+**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
-- Возможность создания нового сайта
-- Корректность настроек темы
-- Подключение к Gitea серверу
+Перед выполнением каждого этапа выполняются проверки:
+- Наличие установленного Hugo (`hugo version`)
+- Возможность сборки сайта (`hugo`)
+- Корректность настроек темы (проверка `hugo.toml`)
+- Работоспособность деплоя (`make deploy-dry-run`)
+
+## Команды проекта
+
+### Сборка и запуск
+
+```bash
+hugo              # Генерация сайта в public/
+hugo server       # Локальный сервер (http://localhost:1313)
+make build        # Сборка через Makefile
+make clean        # Очистка public/
+make rebuild      # Полная пересборка
+```
+
+### Деплой
+
+```bash
+make deploy           # Сборка + деплой на хостинг
+make deploy-dry-run   # Симуляция деплоя
+make help             # Список доступных команд
+```
+
+### Параметры деплоя
+
+| Параметр | Значение |
+|----------|----------|
+| Хост | kpa39l.myjino.ru |
+| Порт SFTP | 2222 |
+| Пользователь | kpa39l_dedinit |
+| Путь | /dedinit.ru |
+
+## Принятые технические решения
+
+1. **Структура проекта**: Git-репозиторий инициализирован в папке с Hugo-сайтом
+2. **Формат статей**: Bundle (папка с index.md) для удобного хранения статьи и связанных файлов
+3. **Тема rDedInit**: Собственная тема на базе PaperMod с русификацией
+4. **Деплой**: Кроссплатформенный (rsync для Unix, WinSCP для Windows)
+5. **Favicon**: Набор в стиле пиксель-арт (SmileDed) с логотипом 48px в шапке
+6. **Подсветка кода**: github-dark стиль с номерами строк
+
+## Конфигурация темы (hugo.toml)
+
+### Основные параметры
+
+```toml
+baseURL = 'https://dedinit.ru/'
+title = 'dedinit()'
+theme = 'rDedInit'
+timeZone = 'Europe/Moscow'
+metaDataFormat = "yaml"
+```
+
+### Параметры PaperMod
+
+```toml
+[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)
+
+### Завершённые задачи ✅
+
+- [x] Установка Hugo Extended 0.155.1
+- [x] Создание сайта dedinit.ru
+- [x] Установка темы PaperMod (submodule)
+- [x] Создание собственной темы rDedInit
+- [x] Настройка bundle формата статей
+- [x] Настройка favicon и логотипа (SmileDed)
+- [x] SFTP-деплой на kpa39l.myjino.ru
+- [x] Написание первых статей (6 публикаций)
+
+### Текущие задачи 🎯
+
+- [ ] Настройка цветовой схемы темы
+- [ ] Русификация интерфейса (i18n/ru.yaml)
+- [ ] Визуальное оформление Telegram-постов
+- [ ] Публикация новых статей
+
+### Планы 📈
+
+- [ ] SEO оптимизация (Open Graph, sitemap)
+- [ ] Аналитика (Google Analytics/Яндекс.Метрика)
+- [ ] Поиск по сайту (Fuse.js)
+- [ ] Комментарии (Giscus/Utterances)
 
 ## Примечания
 
 - Важно обеспечить поддержку блоков кода и подсветки синтаксиса
-- Необходимо предусмотреть хранение контента на внешнем сервере
 - Проект должен быть готов к публикации контента как можно скорее
+- Папка `public/` исключена из git-репозитория
+- Для обновления Hugo: `winget install Hugo.Hugo.Extended`
 
 ## Информация о системе
 
-- Hugo была установлена через winget
-- Для обновления Hugo до последней версии используется команда: `winget install Hugo.Hugo.Extended`
+- ОС: Windows 11
+- Hugo установлена через winget
+- Требуется перезапуск терминала после установки/обновления Hugo
 - Текущая версия Hugo: 0.155.1
-- После установки/обновления Hugo требуется перезапуск терминала для обновления PATH
 
-## Принятые решения в ходе реализации
+## Полезные ссылки
 
-1. **Структура проекта**: Git-репозиторий инициализирован в папке с Hugo-сайтом, а не во внешней папке
-2. **Интеграция с Gitea**: Используется SSH-подключение по порту 2222
-3. **Файлы документации**: Все файлы документации находятся в папке проекта Hugo-сайта
-4. **Исключение папки public**: Создан .gitignore файл для исключения папки public из репозитория
-5. **Bundle формат статей**: Используется формат bundle (папка с index.md) для хранения статей
-6. **Тема PaperMod**: Установлена как submodule с выбором совместимой версии
-7. **Решение проблемы совместимости**: Выбрана версия темы, совместимая с установленной версией Hugo
+- [Документация PaperMod](https://github.com/adityatelange/hugo-PaperMod/wiki)
+- [Документация Hugo](https://gohugo.io/documentation/)
+- [PAPERMOD_PARAMS.md](PAPERMOD_PARAMS.md) — полный справочник параметров темы
+- [ROADMAP.md](ROADMAP.md) — дорожная карта проекта
+- [DEPLOY_INSTRUCTIONS.md](DEPLOY_INSTRUCTIONS.md) — инструкция по деплою
+
+## Файлы документации
+
+| Файл | Описание |
+|------|----------|
+| README.md | Основное описание проекта |
+| ROADMAP.md | Дорожная карта развития |
+| PAPERMOD_PARAMS.md | Справочник параметров темы |
+| DEPLOY_INSTRUCTIONS.md | Инструкция по деплою |
+| gitea-setup.md | Настройка интеграции с Gitea |
+| docs/favicon-logo-setup.md | Настройка favicon и логотипа |
+| Telegram_frontend.md | Оформление Telegram-постов |
+
+---
+
+**Последнее обновление:** 5 марта 2026 г.