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,112 @@
+The user wants me to create a comprehensive project summary in markdown format based on the conversation history. Let me analyze what has been done:
+
+1. This is a Hugo blog project with PaperMod theme
+2. The site is deployed to a remote server via SFTP/WinSCP
+3. Recent work included:
+   - Favicon configuration
+   - TOML structure fixes
+   - Russian localization
+   - Date format customization
+   - Git commits and deployment
+
+Let me create a comprehensive summary that captures all the important context for future sessions.# Project Summary
+
+## Overall Goal
+Организация блога на основе Hugo с темой PaperMod для публикации контента на dedinit.ru с интеграцией Gitea (gitverse.ru) и деплоем на хостинг (myjino.ru).
+
+## Key Knowledge
+
+### Technology Stack
+- **Hugo Extended** v0.155.1 (установлена через winget)
+- **Тема**: PaperMod (форк `rDedInit` как submodule)
+- **Хранение статей**: bundle format (папка с `index.md`)
+- **Frontmatter**: YAML формат
+- **Git**: Gitea сервер `gitverse.ru:kpa39l/dedinit.ru` (SSH порт 2222)
+- **Деплой**: WinSCP через Makefile на `kpa39l.myjino.ru:2222`
+
+### Конфигурация (hugo.toml)
+```toml
+baseURL = 'https://dedinit.ru/'
+languageCode = 'ru-ru'
+timeZone = 'Europe/Moscow'
+DateFormat = "02.01.2006 15:04"  # формат: 06.03.2026 19:30
+
+[languages.ru]
+  languageName = "Русский"
+  languageCode = "ru-ru"
+  weight = 1
+
+[params.assets]
+  favicon = "images/favicon/favicon48x48.ico"
+  favicon16x16 = "images/favicon/favicon-16x16.png"
+  favicon32x32 = "images/favicon/favicon-32x32.png"
+```
+
+### Важные решения
+1. Git-репозиторий инициализирован в папке Hugo-сайта (не во внешней папке)
+2. Папка `public/` исключена из репозитория через `.gitignore`
+3. Настройки PaperMod должны быть в `[params]`, а favicon — в `[params.assets]`
+4. Для русификации требуется секция `[languages.ru]` (не только `languageCode`)
+
+### Команды
+```bash
+make build           # собрать сайт
+make deploy          # собрать и задеплоить
+make deploy-dry-run  # симуляция деплоя
+hugo server          # локальный сервер разработки
+```
+
+## Recent Actions
+
+### Выполнено
+1. **[DONE] Настройка favicon**
+   - Файлы: `static/images/favicon/*.ico`, `*.png`
+   - Конфигурация в `[params.assets]`
+   - `.gitignore` обновлён для исключения лишних файлов (zip, piscel, android-chrome)
+
+2. **[DONE] Исправление структуры hugo.toml**
+   - Объединены дублирующиеся секции `[params]`
+   - Настройки PaperMod перемещены в `[params]` (работает `disableSpecial1stPost`)
+
+3. **[DONE] Русификация темы**
+   - Добавлена секция `[languages.ru]`
+   - Формат даты: `02.01.2006 15:04` → `06.03.2026 19:30`
+   - Время чтения: "минута/минуты/минут" (склонение работает)
+   - Язык в сборке: `│ RU`
+
+4. **[DONE] Деплой**
+   - Коммит запушен в `gitverse.ru:kpa39l/dedinit.ru`
+   - Сайт загружен на `kpa39l.myjino.ru` через WinSCP
+
+### Статус репозитория
+- Последний коммит: «Русификация сайта и настройка формата даты»
+- Ветка: `main` (синхронизирована с origin)
+- Untracked файлы: `favicon.png`, `static/` (требуют решения)
+
+## Current Plan
+
+### Текущий статус
+1. **[DONE]** Установка Hugo Extended
+2. **[DONE]** Создание сайта dedinit.ru
+3. **[DONE]** Установка темы PaperMod (submodule)
+4. **[DONE]** Настройка bundle формата статей
+5. **[DONE]** Интеграция с Gitea (gitverse.ru)
+6. **[DONE]** Настройка favicon
+7. **[DONE]** Русификация (даты, время чтения)
+8. **[DONE]** Первый деплой на myjino.ru
+
+### Следующие шаги [TODO]
+1. Решить судьбу untracked файлов (`favicon.png`, `static/`)
+2. Проверить работу сайта на dedinit.ru
+3. Настроить CI/CD (опционально)
+4. Добавить новые статьи в блог
+
+### Примечания
+- После обновления Hugo требуется перезапуск терминала (обновление PATH)
+- Для локальной разработки: `hugo server`
+- Все изменения фиксируются в README.md и QWEN.md
+
+---
+
+## Summary Metadata
+**Update time**: 2026-03-06T11:03:13.225Z