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,185 @@
+# Настройки взаимодействия
+
+## Общие принципы работы
+
+1. Все важные решения и изменения фиксируются в README.md
+2. Взаимодействие происходит на русском языке
+3. Перед применением изменений проверяется корректность принятых решений
+4. Цель — максимально быстро запустить проект для публикации контента
+
+## Описание проекта
+
+**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`)
+
+## Команды проекта
+
+### Сборка и запуск
+
+```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`
+
+## Информация о системе
+
+- ОС: Windows 11
+- Hugo установлена через winget
+- Требуется перезапуск терминала после установки/обновления Hugo
+- Текущая версия Hugo: 0.155.1
+
+## Полезные ссылки
+
+- [Документация 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 | Основное описание проекта (кратко) |
+| 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 г.