estorozhenko
70a3671d61
- Makefile Unix: tools/deploy_sftp.py (paramiko mirror --delete), autovenv - tools/deploy_sftp.py: рекурсивный SFTP-mirror public/ -> /dedinit.ru - Jino SFTP-only: rsync/ssh-exec запрещены (exec request failed on channel 0) - README/DEPLOY_INSTRUCTIONS: обновлены, деплой только через make deploy - .gitignore: + .venv/
101 lines
6.2 KiB
Markdown
101 lines
6.2 KiB
Markdown
# dedinit.ru
|
|
|
|
## Описание проекта
|
|
|
|
Этот проект представляет собой блог на основе генератора статических сайтов Hugo с темой PaperMod. Основная цель проекта - создать платформу для публикации лонгридов с поддержкой блоков кода и подсветки синтаксиса, чего не хватает в других сервисах (Telegraph, VK, Writefreely).
|
|
|
|
## Технические детали
|
|
|
|
- Генератор статических сайтов: Hugo (расширенная версия)
|
|
- Тема оформления: PaperMod (<https://github.com/adityatelange/hugo-PaperMod>)
|
|
- Хранение контента: GitVerse (<gitverse.ru:kpa39l/dedinit.ru>) через SSH
|
|
- Настройка: bundle хранение статей
|
|
|
|
## Статус проекта
|
|
|
|
Проект находится в стадии разработки. Выполненные задачи:
|
|
|
|
- Установлена Hugo расширенная версия (0.155.1)
|
|
- Создан новый сайт dedinit.ru
|
|
- Установлена и настроена тема PaperMod
|
|
- Настроено bundle хранение статей
|
|
- Решена проблема совместимости Hugo и темы PaperMod
|
|
- Репозиторий подключён к GitVerse (gitverse.ru:kpa39l/dedinit.ru)
|
|
- **Создана собственная тема rDedInit** на базе PaperMod
|
|
|
|
## История изменений
|
|
|
|
### 30 августа 2026 года
|
|
|
|
- Написана и опубликована статья «Как я перевёл aux-задачи Hermes на локальные модели» (пост `20260830 - local aux models hermes`, slug `local-aux-models-hermes-qwen3`)
|
|
- Исправлена сборка с современными версиями Hugo: добавлен `defaultContentLanguage = 'ru'` в hugo.toml (Hugo 0.123+ требует, чтобы defaultContentLanguage совпадал с одним из `[languages]`, иначе ошибка `config value "en" does not match any language definition`)
|
|
- Установлен локальный git identity в репозитории: Storozhenko Evgeny <kpa39l@yandex.ru>
|
|
- Подробный опыт настройки локальных aux-моделей Hermes задокументирован в [docs/local-aux-models.md](docs/local-aux-models.md)
|
|
|
|
### 31 января 2026 года
|
|
|
|
- Установлена Hugo расширенная версия 0.155.1
|
|
- Создан новый сайт dedinit.ru
|
|
- Установлена тема PaperMod
|
|
- Настроено bundle хранение статей
|
|
- Создан пример статьи в формате bundle
|
|
- Настроена интеграция с Gitea сервером
|
|
|
|
### 5 марта 2026 года
|
|
|
|
- Миграция репозитория на GitVerse (gitverse.ru:kpa39l/dedinit.ru)
|
|
|
|
### 1 февраля 2026 года
|
|
|
|
- Разработано решение для деплоя сайта через SFTP
|
|
- Настроен Makefile для кроссплатформенного деплоя (Windows/Linux/macOS)
|
|
- Создан скрипт winscp_script.txt для подключения и синхронизации файлов
|
|
- Обновлены инструкции по деплою в DEPLOY_INSTRUCTIONS.md и README.md
|
|
|
|
## Принятые технические решения
|
|
|
|
1. **Выбор Hugo**: Выбран генератор статичных сайтов Hugo для быстродействия и гибкости
|
|
2. **Расширенная версия Hugo**: Используется расширенная версия для поддержки SCSS
|
|
3. **Тема PaperMod**: Легкая и адаптивная тема с поддержкой темной/светлой темы
|
|
4. **Bundle хранение статей**: Используется формат bundle (папка с index.md) для удобного хранения статьи и связанных файлов
|
|
5. **Хранение на GitVerse**: Контент хранится на GitVerse для полного контроля
|
|
6. **SSH подключение**: Используется SSH для безопасного доступа к репозиторию
|
|
7. **Структура проекта**: Правильная иерархия папок с .gitignore для исключения ненужных файлов
|
|
|
|
## Запуск проекта
|
|
|
|
Для генерации сайта и просмотра его в браузере используйте следующие команды:
|
|
|
|
- `hugo` - генерирует статический сайт в папку `public`
|
|
- `hugo server` - запускает локальный сервер для предварительного просмотра сайта в браузере (обычно доступен по адресу <http://localhost:1313>)
|
|
|
|
## Деплой сайта
|
|
|
|
> **ЕДИНСТВЕННЫЙ способ деплоя сайта — `make deploy`.** Не деплойте вручную
|
|
> (rsync/ssh-exec напрямую не работают: аккаунт Jino SFTP-only).
|
|
|
|
Специальные файлы:
|
|
|
|
- `Makefile` — команды сборки и публикации (Unix: SFTP через `tools/deploy_sftp.py`
|
|
на paramiko; Windows: WinSCP.com)
|
|
- `tools/deploy_sftp.py` — рекурсивный mirror `public/` → `/dedinit.ru`
|
|
(с удалением лишнего, как `rsync --delete`), пароль из env `SSHPASS`
|
|
- `winscp_script.txt` — скрипт для WinSCP (Windows)
|
|
- `DEPLOY_INSTRUCTIONS.md` — инструкция по деплою
|
|
|
|
Для публикации сайта на хостинге:
|
|
|
|
```shell
|
|
export SSHPASS='<пароль SFTP из DEPLOY_INSTRUCTIONS.md>'
|
|
make deploy
|
|
```
|
|
|
|
Первая сборка создаст `.venv/` (paramiko). Для получения полного списка команд:
|
|
|
|
```shell
|
|
make help
|
|
```
|
|
|
|
Процесс кроссплатформенный: на Unix — SFTP (paramiko), на Windows — WinSCP.com.
|
|
НЕ удаляйте `make deploy` и не заменяйте его на прямой rsync.
|