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
55 lines
3.0 KiB
Markdown
55 lines
3.0 KiB
Markdown
# dedinit.ru
|
||
|
||
**dedinit.ru** — блог на генераторе статических сайтов [Hugo](https://gohugo.io)
|
||
(extended) с кастомной темой **rDedInit** (форк [PaperMod](https://github.com/adityatelange/hugo-PaperMod)).
|
||
Платформа для публикации лонгридов с поддержкой блоков кода и подсветки
|
||
синтаксиса.
|
||
|
||
## Быстрый старт
|
||
|
||
```bash
|
||
hugo # сборка в public/
|
||
hugo server # локальный сервер: http://localhost:1313
|
||
make build # сборка через Makefile (hugo --minify)
|
||
make deploy # сборка + деплой (требует SSHPASS)
|
||
```
|
||
|
||
**ЕДИНСТВЕННЫЙ способ деплоя — `make deploy`.** Не заменять на rsync/ssh-exec:
|
||
аккаунт хостинга SFTP-only. Подробности — в `docs/DEPLOY_INSTRUCTIONS.md`.
|
||
|
||
## Структура
|
||
|
||
```
|
||
dedinit.ru/
|
||
├── content/posts/ # Статьи блога (bundle: папка с index.md + hero.svg)
|
||
├── themes/rDedInit/ # Кастомная тема на базе PaperMod
|
||
├── static/ # Статические ресурсы (favicon и т.д.)
|
||
├── docs/ # ВСЯ документация проекта
|
||
├── tools/ # Скрипты деплоя (deploy_sftp.py, winscp_script.txt)
|
||
├── hugo.toml # Конфигурация Hugo
|
||
├── Makefile # Сборка и деплой
|
||
├── README.md # Краткое введение (этот файл)
|
||
└── AGENTS.md # Правила работы для агентов
|
||
```
|
||
|
||
## Документация
|
||
|
||
Вся подробная документация — в каталоге [`docs/`](docs/):
|
||
|
||
| Документ | О чём |
|
||
|----------|-------|
|
||
| [DEPLOY_INSTRUCTIONS.md](docs/DEPLOY_INSTRUCTIONS.md) | Деплой через SFTP (kpa39l.myjino.ru:2222) |
|
||
| [ROADMAP.md](docs/ROADMAP.md) | Дорожная карта проекта |
|
||
| [PAPERMOD_PARAMS.md](docs/PAPERMOD_PARAMS.md) | Справочник параметров темы rDedInit |
|
||
| [QWEN.md](docs/QWEN.md) | Настройки взаимодействия и описание проекта |
|
||
| [gitea-setup.md](docs/gitea-setup.md) | Интеграция с Gitea |
|
||
| [Telegram_frontend.md](docs/Telegram_frontend.md) | Оформление Telegram-постов |
|
||
| [favicon-logo-setup.md](docs/favicon-logo-setup.md) | Настройка favicon и логотипа |
|
||
| [local-aux-models.md](docs/local-aux-models.md) | Опыт: локальные aux-модели Hermes |
|
||
| [archive/](docs/archive/) | Архив устаревших документов |
|
||
|
||
## Конвенции
|
||
|
||
- Ветка `main`; источник истины — [gitverse.ru](https://gitverse.ru) (`kpa39l/dedinit.ru`), Gitea — pull-mirror.
|
||
- Правила работы для агентов — [`AGENTS.md`](AGENTS.md).
|
||
- Планирование изменений — OpenSpec (`openspec/`). |