From 3a9aefeb256d442a2de2ea6fcc27e63f00058886 Mon Sep 17 00:00:00 2001 From: Storozhenko Evgeny Vladimirovich aka kpa39l Date: Mon, 2 Feb 2026 20:56:42 +0300 Subject: [PATCH] Change structure project --- DEPLOY_INSTRUCTIONS.md | 24 +++++++++++++++++++++--- README.md | 18 ++++++++++-------- content/posts/test-post/index.md | 8 ++++---- 3 files changed, 35 insertions(+), 15 deletions(-) diff --git a/DEPLOY_INSTRUCTIONS.md b/DEPLOY_INSTRUCTIONS.md index 76f84cc..27095e1 100644 --- a/DEPLOY_INSTRUCTIONS.md +++ b/DEPLOY_INSTRUCTIONS.md @@ -7,6 +7,7 @@ ## Учетные данные и параметры подключения Для работы используются следующие параметры: + - **Хост**: kpa39l.myjino.ru - **Порт SFTP**: 2222 - **Пользователь**: kpa39l_dedinit @@ -15,59 +16,75 @@ ## Установка зависимостей -### Для Linux/macOS: +### Для Linux/macOS + - **rsync** - установите через менеджер пакетов (например, apt-get install rsync или brew install rsync) - **Make** - для выполнения команд из Makefile -### Для Windows: -- **WinSCP** - установите с официального сайта (https://winscp.net/) +### Для Windows + +- **WinSCP** - установите с официального сайта () - **Make** - можно установить через Chocolatey, MinGW или Git for Windows ## Использование Makefile ### Сборка сайта + ```bash make build ``` + Команда генерирует сайт в папку `public/`. ### Деплой сайта + ```bash make deploy ``` + Команда сначала собирает сайт, затем загружает содержимое папки `public/` на удаленный сервер. Для Windows используется WinSCP.com для SFTP-подключения, для Unix-подобных систем - rsync. ### Симуляция деплоя + ```bash make deploy-dry-run ``` + Команда сначала собирает сайт, затем симулирует загрузку на сервер: + - На Unix-подобных системах используется флаг `-n` для симуляции rsync - На Windows симуляция пока не реализована, будет выведено соответствующее сообщение ### Очистка + ```bash make clean ``` + Команда удаляет папку `public/`. ### Полная пересборка + ```bash make rebuild ``` + Команда удаляет папку `public/`, затем заново собирает и деплоит сайт. ### Справка + ```bash make help ``` + Показывает список доступных команд. ## Конфигурация Параметры подключения находятся в файле Makefile: + - HOST - адрес сервера - PORT - порт SFTP - USERNAME - имя пользователя @@ -78,5 +95,6 @@ make help ## Настройка для Windows Для корректной работы на Windows необходимо: + 1. Убедиться, что WinSCP установлен в стандартную директорию `C:\Program Files (x86)\WinSCP\` 2. Файл `winscp_script.txt` содержит команды для подключения и синхронизации файлов diff --git a/README.md b/README.md index 84f98c6..4ea66b2 100644 --- a/README.md +++ b/README.md @@ -7,13 +7,14 @@ ## Технические детали - Генератор статических сайтов: Hugo (расширенная версия) -- Тема оформления: PaperMod (https://github.com/adityatelange/hugo-PaperMod) +- Тема оформления: PaperMod () - Хранение контента: Gitea сервер (gitea.nixg.ru) через SSH - Настройка: bundle хранение статей ## Статус проекта Проект находится в стадии разработки. Выполненные задачи: + - Установлена Hugo расширенная версия (0.155.1) - Создан новый сайт dedinit.ru - Установлена и настроена тема PaperMod @@ -23,6 +24,7 @@ ## История изменений ### 31 января 2026 года + - Установлена Hugo расширенная версия 0.155.1 - Создан новый сайт dedinit.ru - Установлена тема PaperMod @@ -31,12 +33,11 @@ - Настроена интеграция с Gitea сервером (требуется дополнительная настройка SSH) ### 1 февраля 2026 года + - Разработано решение для деплоя сайта через SFTP - Настроен Makefile для кроссплатформенного деплоя (Windows/Linux/macOS) - Создан скрипт winscp_script.txt для подключения и синхронизации файлов - Обновлены инструкции по деплою в DEPLOY_INSTRUCTIONS.md и README.md -- Удалены экспериментальные файлы, оставшиеся от поиска решения -------- ## Принятые технические решения @@ -53,7 +54,7 @@ Для генерации сайта и просмотра его в браузере используйте следующие команды: - `hugo` - генерирует статический сайт в папку `public` -- `hugo server` - запускает локальный сервер для предварительного просмотра сайта в браузере (обычно доступен по адресу http://localhost:1313) +- `hugo server` - запускает локальный сервер для предварительного просмотра сайта в браузере (обычно доступен по адресу ) ## Деплой сайта @@ -64,14 +65,15 @@ - `DEPLOY_INSTRUCTIONS.md` - инструкция по использованию команд деплоя Для публикации сайта на хостинге используйте команду: -``` + +```shell make deploy ``` Для получения полного списка доступных команд используйте: -``` + +```shell make help ``` -Процесс деплоя кроссплатформенный: на Unix-подобных системах используется rsync, на Windows - WinSCP.com для SFTP-подключения. -------- \ No newline at end of file +Процесс деплоя кроссплатформенный: на Unix-подобных системах используется rsync, на Windows - WinSCP.com для SFTP-подключения diff --git a/content/posts/test-post/index.md b/content/posts/test-post/index.md index 9c8ff03..1a66a1e 100644 --- a/content/posts/test-post/index.md +++ b/content/posts/test-post/index.md @@ -4,11 +4,11 @@ date: 2026-01-31T22:45:00+03:00 draft: false --- -# Тестовая статья +## Тестовая статья Это пример статьи в формате bundle. В этом формате все связанные файлы (изображения, код и т.д.) находятся в одной папке с основным файлом. -## Блок кода +### Блок кода ```python def hello_world(): @@ -17,10 +17,10 @@ def hello_world(): # Это важно для подсветки синтаксиса ``` -## Изображения +### Изображения ![Alt текст](image.jpg) ## Заключение -Формат bundle позволяет удобно организовывать статьи и связанные с ними ресурсы в одной директории. \ No newline at end of file +Формат bundle позволяет удобно организовывать статьи и связанные с ними ресурсы в одной директории.