Update README.md

README.md

@@ -1,2 +1,46 @@
-# pages-test
+# 🚀 Как бесплатно опубликовать свой сайт (Gitea Pages)
 
+На нашем сервере Gitea работает функция **Pages**. Вы можете выложить любой статический сайт (HTML, CSS, JS), и он будет доступен всему миру по ссылке:
+`https://<ваше-имя-пользователя>.mydomain.com/<имя-репозитория>/`
+
+---
+
+## 🛠 Пошаговая инструкция для новичков
+
+### Шаг 1. Подготовьте файлы сайта
+Убедитесь, что главный файл вашего сайта называется **`index.html`** (все буквы строчные!). Он должен находиться в самом корне проекта, а не внутри папок вроде `src/` или `dist/`.
+
+### Шаг 2. Создайте специальную ветку (Branch)
+Gitea ищет сайт в строго определенном месте. Нам нужно создать ветку с именем **`gitea-pages`**:
+
+1. Откройте ваш репозиторий в браузере.
+2. В левом верхнем углу найдите выпадающий список веток (там обычно написано `main` или `master`).
+3. Нажмите на него, введите в строку поиска **`gitea-pages`** и нажмите **«Создать ветку»** (Create branch).
+
+### Шаг 3. Загрузите файлы в эту ветку
+Переключитесь на ветку `gitea-pages` (если вы еще не в ней) и добавьте туда файлы вашего сайта (`index.html`, картинки, стили).
+* *Через Git:* `git checkout -b gitea-pages`, закинуть файлы, `git commit` и `git push origin gitea-pages`.
+* *Через сайт:* Нажмите кнопку **«Добавить файл»** -> **«Загрузить файлы»** прямо в ветку `gitea-pages`.
+
+### Шаг 4. Включите Pages в настройках
+1. Перейдите в **Настройки** (Settings) вашего репозитория (шестеренка справа вверху).
+2. В левом меню найдите вкладку **Pages** (Страницы).
+3. В выпадающем списке выбора ветки выберите **`gitea-pages`** и нажмите **Сохранить** (Update / Save).
+
+---
+
+## 🔗 Где искать мой сайт?
+
+Как только вы сохраните настройки, на этой же странице (вкладка *Pages*) появится ваша персональная ссылка. Она выглядит так:
+
+> 🌐 **`https://<ваш_логин>.mydomain.com/<имя_репозитория>/`**
+
+*Обновление сайта происходит автоматически при каждом новом пуше (изменении файлов) в ветку `gitea-pages`!*
+
+---
+
+## ⚠️ Частые ошибки (Почему не работает?)
+
+*   **Ошибка 404 (Not Found):** Проверьте, что ваш главный файл называется именно `index.html` (не `Index.html` и не `main.html`) и лежит в корне ветки `gitea-pages`.
+*   **Сайт не обновился:** Браузер мог закэшировать старую версию. Нажмите `Ctrl + F5` (или `Cmd + Shift + R` на Mac) для полной очистки кэша страницы.
+*   **Картинки/Стили «сломались»:** Убедитесь, что пути к картинкам и CSS указаны относительно (например, `./images/photo.png`, а не `/images/photo.png`).