From 8de0a05848f2aa2a34135e6f64d2811c37250b55 Mon Sep 17 00:00:00 2001 From: aibrash Date: Wed, 4 Nov 2026 16:48:04 +0500 Subject: [PATCH] =?UTF-8?q?CI:=20=D0=B4=D0=B5=D0=BF=D0=BB=D0=BE=D0=B9=20?= =?UTF-8?q?=D1=87=D0=B5=D1=80=D0=B5=D0=B7=20ssh=20=D0=B8=20git=20pull,=20R?= =?UTF-8?q?EADME=20=D1=81=D0=BE=20=D1=81=D1=82=D0=B8=D0=BB=D0=B8=D1=81?= =?UTF-8?q?=D1=82=D0=B8=D0=BA=D0=BE=D0=B9=20=D0=B8=20=D0=B7=D0=B0=D0=BC?= =?UTF-8?q?=D0=B5=D1=82=D0=BA=D0=B0=D0=BC=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - .gitea/workflows/deploy.yml: при пуше в main заходит на сервер по ssh и делает git pull - deploy/: конфиг nginx (root /opt/vizitka-site/web) и скрипт разовой настройки сервера - tools/: генераторы страниц архитектуры и проектов (раньше лежали вне репозитория) - README: стилистика сайта, устройство, деплой, заметки для следующих сессий Co-Authored-By: Claude Sonnet 5.5 --- .gitea/workflows/deploy.yml | 26 ++++ README.md | 249 ++++++++++++++++++++++++++++-------- deploy/nginx-site.conf | 49 +++++++ deploy/setup-server.sh | 34 +++++ tools/gen_arch.py | 209 ++++++++++++++++++++++++++++++ tools/gen_projects.py | 175 +++++++++++++++++++++++++ 6 files changed, 689 insertions(+), 53 deletions(-) create mode 100644 .gitea/workflows/deploy.yml create mode 100644 deploy/nginx-site.conf create mode 100755 deploy/setup-server.sh create mode 100644 tools/gen_arch.py create mode 100644 tools/gen_projects.py diff --git a/.gitea/workflows/deploy.yml b/.gitea/workflows/deploy.yml new file mode 100644 index 0000000..ed95d26 --- /dev/null +++ b/.gitea/workflows/deploy.yml @@ -0,0 +1,26 @@ +# CI: при пуше в main заходим на сервер по ssh и делаем git pull. +# Всё остальное уже настроено на сервере (nginx раздаёт /opt/vizitka-site/web, см. deploy/setup-server.sh). +# Нужен один секрет: DEPLOY_SSH_KEY (приватный ключ с доступом к серверу). +name: deploy + +on: + push: + branches: [main] + workflow_dispatch: + +jobs: + deploy: + runs-on: ubuntu-latest + steps: + - name: Подключение к серверу и git pull + env: + DEPLOY_SSH_KEY: ${{ secrets.DEPLOY_SSH_KEY }} + run: | + command -v ssh >/dev/null || { apt-get update -qq && apt-get install -y -qq openssh-client; } + umask 077 + install -d "$HOME/.ssh" + printf '%s\n' "$DEPLOY_SSH_KEY" > "$HOME/.ssh/id_deploy" + # отпечаток ключа сервера закреплён: подмена сервера не пройдёт + echo "192.168.10.112 ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIHFLwAGOvgF5ZSBiZ9YRe78gT9HN1MeESQIaM6Aou/Ud" > "$HOME/.ssh/known_hosts" + ssh -i "$HOME/.ssh/id_deploy" -o IdentitiesOnly=yes -o BatchMode=yes -o StrictHostKeyChecking=yes \ + root@192.168.10.112 'cd /opt/vizitka-site && git pull --ff-only && git log -1 --oneline' diff --git a/README.md b/README.md index 37f45f5..f4a08eb 100644 --- a/README.md +++ b/README.md @@ -1,68 +1,211 @@ -# Сайт-визитка +# Сайт-визитка Амана Ибраша -Одна страница на чистом HTML + CSS + JS, без сборки и бэкенда. +Личный сайт для закрепа в профилях соцсетей: человек заходит, видит, кто это, и может написать. Дальше есть разделы про архитектуру, проекты и хоумлаб. +Чистый HTML + CSS + JS, без сборщиков и фреймворков, без бэкенда. Статика раздаётся nginx. + +- Репозиторий: `git@git.ibrash.duckdns.org:aibrash/vizitka-site.git` (Gitea 1.27), ветка `main` +- Сервер: `root@192.168.10.112` (Debian 12, имя хоста `visitka-site`): клон репозитория в `/opt/vizitka-site`, nginx отдаёт его папку `web/`, пока по HTTP внутри сети +- Публичного домена пока нет: в OG-тегах и `sitemap.xml` стоит заглушка `https://example.com` (как заменить: раздел 5) + +--- + +## 1. Стилистика сайта + +Если добавляешь страницу или блок, держись этих правил: сайт должен остаться одним целым. + +### Настроение +Светлый, воздушный, дружелюбный минимализм. Не «портфолио архитектора» и не «хакерский терминал» (оба варианта пробовали и от них отказались). Это визитка парня, который живёт «весело и всерьёз»: тренировки, работа, фикс, учёба. Картинок мало, но хорошие. + +### Палитра (токены в `web/css/style.css`, блок `:root`) +| Токен | Цвет | Для чего | +|---|---|---| +| `--bg` | `#f4f6fb` | фон страницы | +| `--card` | `#ffffff` | карточки, плитки, подложки | +| `--ink` | `#121a2b` | основной текст и заголовки | +| `--muted` | `#55627a` | второстепенный текст (контраст 5,5:1 на фоне) | +| `--line` | `#e2e8f3` | рамки и разделители | +| `--accent` | `#3556ff` | кнопки, ссылки, активные пункты, цифры | +| `--accent-soft` | `#e8edff` | фон чипов и иконок | +| `--pop` | `#ffd84d` | «солнечный» жёлтый: аватар и пятно на фоне | +| `--good` | `#1fb865` | статус «на связи» | + +Фон: два размытых цветных пятна (`.blob--a` жёлтое, `.blob--b` голубое), больше ничего. Тёмной темы нет, `color-scheme: light`. + +### Шрифт +Только **Onest** (variable, `wght` 100..900), локально: `web/fonts/onest-{cyrillic,latin}-wght-normal.woff2`. Заголовки 700 и 800 с отрицательным `letter-spacing` (`-.02em` и меньше), текст 400. Никаких внешних шрифтов и CDN. + +### Форма +Всё скруглённое: картинки и плитки 22 px, крупные карточки 24 до 28 px, ряды ссылок 18 px, чипы и кнопки капсулой (`99px`). Одна общая мягкая тень `--shadow`. Рамок почти нет, глубину даёт тень. + +### Раскладка +- Mobile first. Проверять на ширине 360 px (и 320): горизонтального скролла быть не должно. +- Главная: на телефоне одна колонка, на ПК две (слева «обо мне», справа карточка «Давай общаться»). +- Внутренние страницы: контейнер `.page--wide` (до 62 rem), текст ограничен 44 rem ради читаемости. +- Тапаемые элементы не меньше 44 px. + +### Анимации +Должны быть красивыми, но дешёвыми для слабого телефона: только `transform` и `opacity`. +- Главная: одна «сцена» входа (аватар «выпрыгивает», слова строки о себе появляются по очереди, теги появляются и потом чуть парят, фон дрейфует, «волна» у приветствия). +- Внутренние страницы: появление блоков по мере прокрутки (`animation-timeline: view()`, в браузерах без поддержки просто статика), картинки «оседают» (scale 1,12 → 1), числа в карточках проекта «набегают» от нуля (`web/js/count.js`), карточки и картинки приподнимаются или плавно увеличиваются при наведении, блик на кнопках ссылок, переходы между страницами (`@view-transition`). +- Первый экран страницы (обложка проекта, шапка) **не анимируется появлением**: иначе просядет LCP. +- Обязательно уважать `prefers-reduced-motion: reduce` (в CSS всё выключается одним правилом). + +### Тон текстов +Живой, лёгкий, без пафоса и канцелярита. Русский язык. К посетителю на «ты» («Хочешь пообщаться? Пиши»), о себе от первого лица. Короткие предложения, лёгкая самоирония («Скучать некогда»), заголовки с заглавной только первого слова. Эмодзи только в тегах и фактах на главной. **Не выдумывать факты о владельце** (см. раздел 3): если чего-то не знаешь, пиши нейтрально или помечай `TODO`. + +### Требования к качеству +- Lighthouse mobile: performance 90+ на каждой странице (сейчас от 93 до 100), доступность, практики и SEO по 100. +- Строгий CSP: **никаких inline-скриптов и inline-стилей**, никаких внешних ресурсов. Стили элементам из JS задаются через `element.style.setProperty` (это разрешено). +- Картинки: `width` и `height` обязательны (нет сдвигов), `loading="lazy"` для всего ниже первого экрана, у обложки `fetchpriority="high"`. + +--- + +## 2. Как устроен сайт ``` -web/index.html главная страница -web/arch/ список проектов, у каждого своя страница: web/arch/<проект>/ -web/projects/ список проектов, у каждого своя страница: web/projects/<проект>/ (сейчас Aman's World) -web/training|work|fixed/ заготовки будущих страниц (черновики) -templates/page.html шаблон новой страницы -web/config.json всё содержимое: имя, статус, описание, теги, почта, соцсети, фото -web/css, js, fonts стили, скрипт, шрифты (локально) -web/og/home.png превью для соцсетей 1200x630 -web/404.html страница 404 +web/ то, что уходит на сервер (nginx root) + index.html главная (body[data-hide]: скрыта, пока не загрузится config.json) + config.json ВСЁ содержимое главной и меню: имя, факты, теги, статус, ссылки, фото, список страниц + css/style.css единственный файл стилей + js/boot.js в : флаг .js, запрос config.json, window.siteReady + js/card.js заполняет главную из config.json + js/nav.js верхнее меню из config.pages (скрывает draft), подсветка текущего раздела + js/count.js числа «набегают» при появлении + arch/ список проектов + arch/<проект>/ (три страницы) + projects/ список + projects/amans-world/ + projects/homelab/ + training/ work/ fixed/ ЧЕРНОВИКИ будущих страниц (draft, noindex), в меню не видны + img/ me.webp, arch/ (рендеры и чертежи), proj/ (скриншоты игры, иллюстрация хоумлаба) + og/ превью для соцсетей 1200x630 (png/jpg) + fonts/ woff2 Onest и лицензия + 404.html, favicon.svg, robots.txt, sitemap.xml +templates/page.html шаблон новой страницы +tools/ gen_arch.py, gen_projects.py: генераторы страниц архитектуры и проектов +deploy/ nginx-site.conf, setup-server.sh (разовая настройка сервера) +.gitea/workflows/deploy.yml CI ``` -## Что править -Только `web/config.json`. Всё, где `username`, `example.com` и `TODO`, заменить своим. -Скриншоты игры лежат в `web/img/proj/`. Картинки архитектуры лежат в `web/img/arch/` в трёх размерах: `имя.webp`, `имя-md.webp`, `имя-sm.webp` (телефонам отдаются лёгкие). -Новый проект в архитектуре: скопируйте любую страницу `web/arch/<проект>/index.html`, замените текст и картинки, добавьте карточку в `web/arch/index.html` и адрес в `sitemap.xml`. -Фото: положите файл в `web/img/` и впишите путь в `photo` (например `"/img/me.webp"`, квадрат от 192 px). -Если `photo` пустое, показываются инициалы. +### Главная +Содержимое берётся из `web/config.json` (имя, `photo`, `status`, `tagline`, `facts`, `tags`, `cta`, `email`, `socials`). Если `photo` пустое, показываются инициалы. До загрузки конфига страница скрыта (`html.js:not(.ready) body[data-hide] .page`), чтобы вёрстка не прыгала; без JS всё видно сразу. +Хоумлаб на главной не упоминается **намеренно** (так просил владелец). -## Страницы -Опубликованы `web/arch/` и `web/projects/` (в обеих карточки ведут на страницы проектов). Заготовки (черновики) лежат в `web/training/` (Тренировки), `web/work/` (Работа), `web/fixed/` (Фикс). Сейчас это черновики: их нет в меню, а поисковикам они закрыты (`noindex`). +### Меню и страницы +Меню рисует `js/nav.js` из `config.json` → `pages`. На главной оно появляется, только если есть опубликованные страницы. Внутренние страницы всегда показывают имя и пункты. На узких экранах фамилия в шапке прячется (чтобы влезли все пункты). -Опубликовать готовую страницу: -1. Заполните текст в `web/<имя>/index.html` (абзацы, заголовки `h2`, ссылки оформятся сами). -2. В `web/config.json` в `pages` у нужной записи уберите `"draft": true`: она появится в меню на всех страницах. -3. В самой странице удалите строку ``. -4. Добавьте адрес в `web/sitemap.xml`. +Новая страница: +1. Скопируй `templates/page.html` в `web/<имя>/index.html`, поменяй `title`, `description`, `og:*`, текст. +2. В `web/config.json` в `pages` добавь `{ "label": "Название", "url": "/<имя>/" }`. +3. Добавь адрес в `web/sitemap.xml`. -Новая страница с нуля: скопируйте `templates/page.html` в `web/<имя>/index.html`, правьте так же, а в `pages` добавьте `{ "label": "Название", "url": "/<имя>/" }`. -Пока в `pages` нет опубликованных страниц, на главной меню не показывается. +Черновики (`training`, `work`, `fixed`): в `pages` у них `"draft": true`, в самой странице есть ``. Чтобы опубликовать: убери `draft`, удали `noindex`, добавь в sitemap. +Страницу можно не вносить в меню (так сделан хоумлаб: он открывается из карточки на `/projects/`). -## Запуск локально +### Страницы архитектуры и проектов +Они **сгенерированы** скриптами, но результат обычный HTML, его можно править руками. ```bash -python3 -m http.server 8787 --directory web # открыть http://localhost:8787 +python3 tools/gen_arch.py # /arch/ и /arch/<проект>/ +python3 tools/gen_projects.py # /projects/, /projects/amans-world/, /projects/homelab/ ``` +Тексты, подписи и списки картинок лежат прямо в скриптах (`CASES` в `gen_arch.py`, секции в `gen_projects.py`). Скрипты идемпотентны: после запуска `git status` не должен показывать изменений, если ничего не правил. Дописывают недостающие адреса в `sitemap.xml`, остальное не трогают. -## Выкладка -Это просто статика: скопируйте папку `web/` на сервер и раздайте любым веб-сервером. -Пример для Caddy (HTTPS получится сам): -``` -my.domain { - root * /srv/visit-site/web - encode zstd gzip - file_server - handle_errors { - rewrite * /404.html - file_server - } - header { - Content-Security-Policy "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self' data:; font-src 'self'; connect-src 'self'; object-src 'none'; frame-ancestors 'none'" - X-Content-Type-Options "nosniff" - Referrer-Policy "strict-origin-when-cross-origin" - -Server - } -} -``` -Потом подставьте домен в превью и поисковые файлы: +### Картинки +В `web/img/arch/` и `web/img/proj/` каждая картинка в трёх размерах: `имя.webp` (1200 до 1600 px по ширине), `имя-md.webp` (960), `имя-sm.webp` (640). Страницы отдают их через `srcset`, поэтому телефонам идут лёгкие. Рецепт: ```bash -sed -i 's|https://example.com|https://my.domain|g' web/index.html web/robots.txt web/sitemap.xml +magick src.png -strip -resize 1400x1400\> -quality 78 имя.webp +magick src.png -strip -resize 960x960\> -quality 76 имя-md.webp +magick src.png -strip -resize 640x640\> -quality 74 имя-sm.webp ``` -Если сервер стоит дома, лучше публиковать через Cloudflare Tunnel или держать его в отдельной сети, а не рядом с остальными устройствами. +Для чертежей (много мелкого текста) качество 80. Фото-подобные рендеры сжимаются хорошо (от 150 до 230 КБ при 1200 px). -## Проверено -Ширина 360 px без горизонтального скролла, вес страницы около 38 КБ вместе со шрифтами, Lighthouse (mobile и desktop) см. ниже в сообщении. +--- + +## 3. Что известно о владельце (источник правды для текстов) + +Известно и можно использовать: Аман Ибраш, 18 лет, студент KazGASA в Алматы (архитектура), работает системным администратором и растёт в сторону DevOps, любит тренировки, фикс (фиксед гир) и работу. Дома хоумлаб (домашний сервер, на нём Nextcloud; адреса через DuckDNS; браузерная игра Aman's World; в планах переезд этого сайта на сервер и CI). Сам пользуется Fedora Linux (на своём компьютере, про ОС сервера ничего не известно, на сервере сейчас Debian 12). +Контакты, соцсети и e-mail лежат в `web/config.json`. + +Не известно, не выдумывать: годы обучения, места работы, технологический стек DevOps, цифры тренировок и велосипеда, детали игры сверх написанного. + +**Нельзя публиковать:** внутренние адреса и IP, имена хостов, данные работодателя, адрес и содержимое закрытого Nextcloud, имена заказчиков из папок с проектами. Страница хоумлаба называет только сервисы. + +### Откуда материалы +- Архитектурные проекты из Nextcloud владельца: готовые рендеры «Тихого двора» лежат в `…/2026-09_ИЖД_Аман_Ибраш/03_Out/02_Рендеры/`, схемы и аксонометрии в `…/02_Work/05_Presentation/img/`; павильон и «Лофт» вырезаны из PDF-альбомов в `03_Out/01_PDF/`. Ссылка-доступ к Nextcloud не хранится в репозитории. +- Это студенческие работы. Про то, как сделаны рендеры дома, на сайте ничего не утверждается. +- Скриншоты игры: заставка и хаб сняты автоматически, два кадра гонок прислал владелец. + +--- + +## 4. Игра Aman's World (что известно) +3D-игра на Godot 4 (веб-экспорт, около 40 МБ при первом запуске), адрес `https://grid.ibrash.duckdns.org/`. Работает **только на ПК**, можно играть клавиатурой и мышью или геймпадом (вроде Xbox). Неоновый хаб с 5 порталами (Sandbox, Backrooms, ещё один, Race, Race 2), ник до 16 символов, над гоночными порталами таблицы рекордов. Sector 3 Run (Race): 8 чекпоинтов; Ascend Only (Race 2): 13 чекпоинтов; перед стартом «R: готов (0/1)». По звукам и файлам: бег по стенам, прыжок от стены, рывок, скольжение, двойной прыжок, подтягивание на уступ, ускорители. Детали геймплея я только выводил из интерфейса и ассетов, владелец формулировки не проверял целиком. + +--- + +## 5. Деплой и CI + +### Схема (простая) +`push в main` → Gitea Actions (`.gitea/workflows/deploy.yml`) заходит по ssh на `root@192.168.10.112` и делает `git pull` в `/opt/vizitka-site` → nginx раздаёт `/opt/vizitka-site/web`, перезапуск не нужен. Сборки нет: что лежит в `web/`, то и на сайте. + +Репозиторий публичный, поэтому сервер клонирует и обновляет его по HTTPS без ключей и паролей: `https://git.ibrash.duckdns.org/aibrash/vizitka-site.git`. Если репозиторий станет закрытым, на сервер придётся добавить deploy-ключ (в Gitea: репозиторий → Настройки → Deploy keys) или токен. + +### Что настроено на сервере (сделано, `deploy/setup-server.sh`) +```bash +./deploy/setup-server.sh root@192.168.10.112 # ставит nginx и git, клонирует репозиторий в /opt/vizitka-site, подключает deploy/nginx-site.conf +``` +Скрипт безопасно запускать повторно: если клон уже есть, он делает `git pull`, и заново применяет конфиг nginx (там `root /opt/vizitka-site/web`, сжатие, кэш, 404, строгий CSP, скрытые файлы закрыты). +Если нужно поменять конфиг nginx: правь `deploy/nginx-site.conf` и снова запусти скрипт. Если `/opt/vizitka-site` уже был не репозиторием, скрипт откладывает его в `/opt/vizitka-site.old-<время>`, а не удаляет (одна такая папка там сейчас лежит, это старая выкладка через rsync, её можно удалить). + +### Что нужно для работы CI +1. **Секрет** `DEPLOY_SSH_KEY` в Gitea (репозиторий → Настройки → Actions → Секреты): приватный ssh-ключ, у которого есть доступ к `root@192.168.10.112`. Владелец положил туда свой ключ (он уже добавлен). Ключ с правами root: безопаснее отдельный ключ только для CI (`ssh-keygen -t ed25519 -N "" -C gitea-ci`, публичную часть добавить в `/root/.ssh/authorized_keys` с опциями `no-port-forwarding,no-agent-forwarding,no-X11-forwarding,no-pty`). +2. **Runner** `act_runner` с меткой `ubuntu-latest`, который видит `192.168.10.112` по ssh (порт 22), то есть стоит в той же сети. Раннеру нужен только ssh-клиент (workflow доустановит `openssh-client`, если его нет), `actions/checkout` не используется. Есть ли у владельца runner, на момент написания неизвестно: без него workflow просто ждёт в очереди. +3. Отпечаток ключа сервера закреплён прямо в workflow (`known_hosts`). Если сервер переустановят, обновить: `ssh-keyscan -t ed25519 192.168.10.112` и подставить строку в `deploy.yml`. + +### Быстро выложить вручную (без CI) +```bash +ssh root@192.168.10.112 'cd /opt/vizitka-site && git pull --ff-only' +``` +Проверка, что сайт жив: `curl -I http://192.168.10.112/` (ожидается 200). Откат: `ssh root@192.168.10.112 'cd /opt/vizitka-site && git reset --hard <коммит>'`. + +### HTTPS и домен (позже) +Сейчас сервер отдаёт HTTP только внутри сети. Для публичного доступа лучше поставить перед ним обратный прокси (Caddy или nginx на отдельном хосте с сертификатом) или Cloudflare Tunnel, а сам сервер с сайтом не выставлять наружу напрямую рядом с остальными домашними устройствами. +Заглушка `https://example.com` лежит в OG-тегах всех `.html`, в `web/sitemap.xml` и `web/robots.txt`. Раньше домен подставлял скрипт выкладки, теперь выкладки-скрипта нет, поэтому когда выберешь домен, замени один раз и закоммить: +```bash +grep -rlF 'https://example.com' web tools | xargs sed -i 's|https://example.com|https://ТВОЙ.ДОМЕН|g' +``` +(в `tools/` она тоже есть, чтобы генераторы не вернули заглушку). + +--- + +## 6. Проверка перед выкладкой +```bash +python3 -m http.server 8787 --directory web # локальный просмотр: http://localhost:8787 +``` +- Страницы открываются, в консоли нет ошибок (в том числе нарушений CSP), нет горизонтального скролла на 360 px, нет битых картинок. +- Lighthouse mobile (через Chromium от Playwright: `CHROME_PATH=…/chrome npx lighthouse URL --only-categories=performance,accessibility,best-practices,seo`) на каждой странице: 90+. +- После `tools/gen_*.py` `git status` чистый. +- Быстрый осмотр после выкладки: `curl -I http://192.168.10.112/` и открыть сайт на телефоне (выкладка идёт через `git pull`, значит, на сервер попадает только закоммиченное и запушенное). + +--- + +## 7. Заметки для следующих сессий (в том числе для ИИ-ассистента) + +**Предпочтения владельца.** Минимализм (его слова: «верни минимализм, мне нравилось»), светлый и приятный дизайн, упор на мобильную версию, «красивые анимации», только реально хорошие фото. Просил упрощать, когда становилось сложно. Хочет, чтобы всё лишнее удаляли, но без потерь для нужного: однажды удалил папки со старыми версиями сам, а потом спрашивал «куда всё делось». Перед удалением чего-либо в проекте лучше спросить. Коммитить и пушить только по прямой просьбе. + +**Окружение.** +- Оболочка zsh: незакавыченный глоб (`--include=*.html`) падает с «no matches found», берите в кавычки. +- `pkill -f "шаблон"` убивает собственную оболочку, если шаблон есть в самой команде. Останавливайте процессы по порту (`fuser -k 8787/tcp`) или по PID. +- `cp` и `ls` в интерактивном окружении могут быть алиасами (запрос на перезапись, цветной вывод): используйте `command cp -f`, `command ls`. +- Рабочий каталог сбрасывается после каждой команды, пишите абсолютные пути. +- Система может блокировать действия вроде добавления ключей в `authorized_keys` на сервере. Это нормально: подготовьте всё остальное и скажите владельцу, что сделать руками. +- Headless Chromium из Playwright по умолчанию светлый, поэтому для проверок подходит; Lighthouse можно запускать с его бинарником. + +**Ловушки в вёрстке.** +- Вложенные `display: grid` раздувают колонку по содержимому: ставьте `grid-template-columns: minmax(0, 1fr)`, иначе карточка выходит за край на телефоне. +- Анимацию появления по прокрутке нельзя вешать на первый кадр страницы (LCP вырастает в разы): есть исключения для `.gallery--one`, `.shot--lead` первого проекта. +- Страницы с данными из JSON прячутся до загрузки только на главной (`body[data-hide]`); на внутренних страницах `has-nav` проставлен прямо в HTML, чтобы меню не двигало вёрстку. +- `@view-transition` и `animation-timeline: view()` работают не везде; везде есть запасной вариант без анимации. + +**Что осталось сделать (на момент написания).** +1. Убедиться, что в Gitea есть runner и CI срабатывает на пуш (секрет `DEPLOY_SSH_KEY` уже добавлен). Удалить с сервера `/opt/vizitka-site.old-*`. +2. Выбрать домен, включить HTTPS через прокси или туннель, заменить заглушку `example.com` (раздел 5). +3. Реальные ники (в `config.json` у Telegram и Instagram стоят короткие ники и их handle могут быть временными), проверка текстов про игру и про хоумлаб. +4. Страницы Тренировки, Работа, Фикс (черновики уже лежат в `web/`). +5. Фото сервера для хоумлаба вместо иллюстрации, больше кадров игры (Backrooms, песочница, паркур). diff --git a/deploy/nginx-site.conf b/deploy/nginx-site.conf new file mode 100644 index 0000000..dfe8882 --- /dev/null +++ b/deploy/nginx-site.conf @@ -0,0 +1,49 @@ +# nginx: статический сайт-визитка. Репозиторий клонирован в /opt/vizitka-site, раздаём его папку web/ +server { + listen 80 default_server; + listen [::]:80 default_server; + server_name _; + + root /opt/vizitka-site/web; + index index.html; + + # сжатие + gzip on; + gzip_vary on; + gzip_min_length 512; + gzip_types text/css application/javascript application/json image/svg+xml text/plain application/xml; + + # заголовки безопасности (строгий CSP: на сайте нет inline-скриптов и стилей, внешних ресурсов нет) + server_tokens off; + add_header Content-Security-Policy "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self' data:; font-src 'self'; connect-src 'self'; object-src 'none'; base-uri 'self'; form-action 'self'; frame-ancestors 'none'" always; + add_header X-Content-Type-Options "nosniff" always; + add_header Referrer-Policy "strict-origin-when-cross-origin" always; + add_header Permissions-Policy "camera=(), microphone=(), geolocation=(), payment=()" always; + + location / { + try_files $uri $uri/ =404; + } + + # кэш: картинки и шрифты надолго, стили и скрипты на час, данные без кэша + location ~* \.(woff2|webp|png|jpe?g|svg|ico)$ { + expires 30d; + add_header Cache-Control "public, max-age=2592000" always; + # add_header в location сбрасывает наследуемые, поэтому дублируем безопасные заголовки + add_header Content-Security-Policy "default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self' data:; font-src 'self'; connect-src 'self'; object-src 'none'; base-uri 'self'; form-action 'self'; frame-ancestors 'none'" always; + add_header X-Content-Type-Options "nosniff" always; + } + location ~* \.(css|js)$ { + add_header Cache-Control "public, max-age=3600" always; + add_header X-Content-Type-Options "nosniff" always; + } + location = /config.json { + add_header Cache-Control "no-cache" always; + add_header X-Content-Type-Options "nosniff" always; + } + + # скрытые файлы наружу не отдаём + location ~ /\. { deny all; } + + error_page 404 /404.html; + location = /404.html { internal; } +} diff --git a/deploy/setup-server.sh b/deploy/setup-server.sh new file mode 100755 index 0000000..734017a --- /dev/null +++ b/deploy/setup-server.sh @@ -0,0 +1,34 @@ +#!/usr/bin/env bash +# Разовая подготовка сервера: nginx, git, клон репозитория в /opt/vizitka-site. Безопасно запускать повторно. +# Использование: ./deploy/setup-server.sh root@192.168.10.112 +# Обновления потом приходят через `git pull` (его делает CI, см. .gitea/workflows/deploy.yml). +set -euo pipefail +TARGET="${1:?укажите сервер: ./deploy/setup-server.sh root@192.168.10.112}" +REPO_URL="${REPO_URL:-https://git.ibrash.duckdns.org/aibrash/vizitka-site.git}" # репозиторий публичный: ключи не нужны +HERE="$(cd "$(dirname "$0")" && pwd)" + +scp -q "$HERE/nginx-site.conf" "$TARGET:/tmp/vizitka-nginx.conf" +ssh "$TARGET" "REPO_URL='$REPO_URL' bash -s" <<'REMOTE' +set -euo pipefail +export DEBIAN_FRONTEND=noninteractive +if ! command -v nginx >/dev/null || ! command -v git >/dev/null; then + apt-get update -qq + apt-get install -y -qq nginx git >/dev/null +fi + +DIR=/opt/vizitka-site +if [ -d "$DIR/.git" ]; then + git -C "$DIR" pull --ff-only +else + [ -e "$DIR" ] && mv "$DIR" "$DIR.old-$(date +%s)" # старое содержимое (не репозиторий) откладываем, не удаляем + git clone "$REPO_URL" "$DIR" +fi + +install -m 644 /tmp/vizitka-nginx.conf /etc/nginx/sites-available/vizitka-site +ln -sf /etc/nginx/sites-available/vizitka-site /etc/nginx/sites-enabled/vizitka-site +rm -f /etc/nginx/sites-enabled/default +nginx -t +systemctl enable --now nginx >/dev/null 2>&1 +systemctl reload nginx +echo "готово: nginx $(nginx -v 2>&1 | cut -d/ -f2), сайт: $DIR/web (коммит $(git -C "$DIR" rev-parse --short HEAD))" +REMOTE diff --git a/tools/gen_arch.py b/tools/gen_arch.py new file mode 100644 index 0000000..753f296 --- /dev/null +++ b/tools/gen_arch.py @@ -0,0 +1,209 @@ +"""Генератор страниц раздела «Архитектура»: список /arch/ и страницы проектов /arch/<проект>/. +Запуск из корня репозитория: python3 tools/gen_arch.py +Содержание проектов (тексты, картинки, подписи) лежит в списке CASES ниже.""" +import os, html +W = os.path.join(os.path.dirname(os.path.dirname(os.path.abspath(__file__))), 'web') + '/' +E = html.escape + +def head(title, desc, og, depth=1): + return f''' + + + + +{E(title)}: Аман Ибраш + + + + + + + + + + + + + + + + + + + + + + +''' +TAIL = ''' + + + + +''' + +# ---------- данные проектов ---------- +CASES = [ + dict(slug='quiet-courtyard', title='Тихий двор', sub='Дом в Конаеве вокруг внутреннего двора', + year='2026', place='Конаев', kind='жилой дом', cover='house-pond', og='arch-quiet-courtyard.jpg', + card='Бетон, дерево и двор, в который приходят небо и свет.', + desc='Тихий двор: одноэтажный бетонный дом в Конаеве вокруг внутреннего двора. Проект в диалоге с архитектурой Тадао Андо.', + intro='Дом, который отвернулся от улицы и повернулся к небу.', + stats=[('1','этаж',''),('32','м² внутренний двор',''),('41','м² гостиная-кухня',''),('3','спальни','')], + sections=[ + ('Улица остаётся снаружи', 'Со стороны улицы это глухая бетонная стена с одной узкой щелью света. Она прячет вход от чужих глаз: чтобы попасть в дом, нужно пройти вдоль сада и только потом повернуть к двери. Рядом под бетонным навесом стоит машина, а сам дом остаётся спокойным и закрытым.'), + ('Всё собрано вокруг двора', 'Внутри всё держится на дворе площадью 32 м². Утреннее солнце заходит в него, галерея обходит двор по кругу, а комнаты открываются на гравий, воду и тонкие деревья. Над центром плана стоит зенитный фонарь: он приносит верхний свет в самую глубину дома.'), + ('Бетон и тёплое дерево', 'Главный материал один: бетон с отпечатками опалубки. Рядом с ним тёплое дерево дверей и потолочных обшивок, чёрный металл рам и зелень. Проект сделан в диалоге с архитектурой Тадао Андо: меньше деталей, больше света, тишины и тени.')], + gallery=[('house-street','Фасад с улицы: глухая стена и въезд под навес','',1200,896), + ('house-courtyard','Двор: стекло, дерево и гравий','',1200,896), + ('house-pond','Фасад в сад: бетон, вода и зелень','',1200,896), + ('house-gallery','Галерея вокруг двора','',1200,896), + ('house-corridor','Коридор вдоль двора','',1200,896), + ('house-entry','Вход: свет и тени на бетоне','',1200,896)], + drawings=[('house-concept','Путь и свет: вход с улицы, щель света, путь вдоль сада, зенитный фонарь и утреннее солнце во двор','portrait',1070,1200), + ('house-plan','План первого этажа с зонированием','portrait',1040,1440), + ('house-axo','Аксонометрия со срезом','wide',1400,1088)]), + dict(slug='exhibition-pavilion', title='Выставочный павильон', sub='Галерея в парке', + year='2026', place='Алматы', kind='общественное здание', cover='pav-2', og='arch-exhibition-pavilion.jpg', + card='Стеклянная витрина среди деревьев и терраса для скульптур.', + desc='Выставочный павильон в Алматы: двухэтажная галерея в парке со стеклянным первым этажом и террасой для скульптур.', + intro='Витрина, которую видно с аллеи ещё до входа.', + stats=[('2','этажа',''),('26','м длина здания',''),('2','галереи',''),('1','терраса для скульптур','')], + sections=[ + ('Первый этаж как витрина', 'Павильон стоит в парке и работает как витрина: первый этаж почти целиком остеклён, поэтому экспозицию видно с аллеи ещё до входа. Входишь, и сразу попадаешь в холл, из которого открываются обе галереи.'), + ('Спокойный план', 'Из холла гости идут в две галереи, а лестница ведёт на второй уровень с открытой террасой для скульптур. Служебные помещения собраны в одном крыле, поэтому залы остаются свободными и чистыми для выставок.'), + ('Три материала', 'Фасад собран из трёх материалов: стеклянная витрина, плоскости бетона и тёплые деревянные ламели. Они держат один спокойный ритм и не спорят с парком вокруг.')], + gallery=[('pav-2','Главный фасад','',1600,896),('pav-1','Вход и холл','',1600,893),('pav-3','Вид сверху на парк','',1600,893)], + drawings=[('pav-plan','План первого этажа: две галереи и холл','wide',1600,844)]), + dict(slug='loft-complex', title='Жилой комплекс «Лофт»', sub='Три корпуса вокруг двора без машин', + year='2026', place='Алматы', kind='жилой комплекс', cover='loft-0', og='arch-loft-complex.jpg', + card='Красный кирпич и общий двор, свободный от машин.', + desc='Жилой комплекс «Лофт» в Алматы: три корпуса из красного кирпича вокруг общего двора без машин.', + intro='Красный кирпич, арки на первом этаже и двор, где можно гулять.', + stats=[('3','корпуса',''),('2,11','га участок',''),('7','этажей, корпус 1',''),('1','подземный паркинг','')], + sections=[ + ('Двор без машин', 'Комплекс стоит на участке 2,11 га в Турксибском районе Алматы. Три корпуса образуют общий двор, и машин в нём нет: парковка спрятана под землёй, а на поверхности остались площадки и озеленение.'), + ('Кирпич и арки', 'На первом этаже коммерция за арочными стальными витражами. Выше идут жилые этажи с окнами в стальных рамах. Фасад корпуса 1 выполнен из красного лицевого кирпича, а стальной пояс отделяет коммерческий этаж от квартир.')], + gallery=[('loft-0','Общий вид комплекса','',1600,1198)], + drawings=[('loft-facade','Боковые фасады корпуса 1','wide',1600,877)]), +] + +import subprocess +def dims(img): + o = subprocess.run(['magick', 'identify', '-format', '%w %h', W + f'img/arch/{img}.webp'], capture_output=True, text=True).stdout.split() + return int(o[0]), int(o[1]) +def srcset(img): + w, _ = dims(img) + parts = [] + for suf, ww in (('-sm', 640), ('-md', 960)): + if os.path.exists(W + f'img/arch/{img}{suf}.webp') and ww < w: parts.append(f'/img/arch/{img}{suf}.webp {ww}w') + parts.append(f'/img/arch/{img}.webp {w}w') + return ', '.join(parts) + +def fig(img, cap, kind, w_unused, h_unused, lead=False, sizes='(min-width: 62rem) 62rem, calc(100vw - 2.2rem)'): + w, h = dims(img) + cls = 'shot' + (f' shot--{kind}' if kind else '') + (' shot--lead' if lead else '') + lz = ' fetchpriority="high"' if lead else ' loading="lazy" decoding="async" fetchpriority="low"' + return f'''
+ {E(cap)} +
{E(cap)}
+
+''' + +# ---------- страницы проектов ---------- +for i, c in enumerate(CASES): + nxt = CASES[(i + 1) % len(CASES)] + cover = next(g for g in c['gallery'] if g[0] == c['cover']) + rest = [g for g in c['gallery'] if g[0] != c['cover']] + meta = ''.join(f'
  • {E(x)}
    • ' for x in (c['year'], c['place'], c['kind'])) + stats = ''.join(f'
  • {n}{E(l)}
    • ' for n, l, _ in c['stats']) + secs = ''.join(f'

    {E(t)}

    {E(p)}

    ' for t, p in c['sections']) + gal = ''.join(fig(g[0], g[1], g[2], g[3], g[4]) for g in rest) + dr = ''.join(fig(g[0], g[1], g[2], g[3], g[4]) for g in c['drawings']) + h = head(c['title'], c['desc'], c['og']) + h += f''' +
    +

    ← Архитектура

    +
    +
      {meta}
    +

    {E(c['title'])}

    +

    {E(c['sub'])}

    +
    + +
    +{fig(cover[0], cover[1], 'cover', cover[3], cover[4], lead=True)}
    + +
      {stats}
    + +
    +

    {E(c['intro'])}

    + {secs} +
    +''' + if rest: + h += f''' +
    +

    Кадры

    +
    +{gal}
    +
    +''' + h += f''' +
    +

    Чертежи и схемы

    +
    +{dr}
    +
    + + + Следующий проект + {E(nxt['title'])} + + +
    +''' + TAIL + os.makedirs(W + f"arch/{c['slug']}", exist_ok=True) + open(W + f"arch/{c['slug']}/index.html", 'w').write(h) + +# ---------- список проектов ---------- +cards = '' +for i, c in enumerate(CASES): + lead = ' work--lead' if i == 0 else '' + cards += f''' +
    {E(c['title'])}
    +
    +
    • {c['year']}
    • {E(c['place'])}
    +

    {E(c['title'])}

    +

    {E(c['card'])}

    + Смотреть проект +
    +     +''' +idx = head('Архитектура', 'Учусь архитектуре в KazGASA, Алматы. Мои лучшие проекты: Тихий двор, выставочный павильон и жилой комплекс.', 'arch.jpg') +idx += f''' +
    +
    +

    Архитектура

    +

    Рисую здания

    +

    Я студент KazGASA в Алматы. Здесь проекты, которыми горжусь больше всего. Выбери любой и загляни внутрь.

    +
    + +
    +{cards}
    + + +
    +''' + TAIL +open(W + 'arch/index.html', 'w').write(idx) + +# sitemap: дописываем недостающие адреса, чужие не трогаем +sm_path = W + 'sitemap.xml' +sm = open(sm_path).read() if os.path.exists(sm_path) else '\n\n\n' +for u in ['/', '/arch/'] + [f"/arch/{c['slug']}/" for c in CASES]: + if f'https://example.com{u}' not in sm: + sm = sm.replace('', f' https://example.com{u}\n') +open(sm_path, 'w').write(sm) +print('arch pages:', [c['slug'] for c in CASES]) diff --git a/tools/gen_projects.py b/tools/gen_projects.py new file mode 100644 index 0000000..fb0a5a3 --- /dev/null +++ b/tools/gen_projects.py @@ -0,0 +1,175 @@ +"""Генератор страниц раздела «Проекты»: список /projects/, игра /projects/amans-world/ и хоумлаб /projects/homelab/. +Запуск из корня репозитория: python3 tools/gen_projects.py (сначала должен существовать tools/gen_arch.py: из него берётся общая шапка)""" +import os, html, subprocess, re +W = os.path.join(os.path.dirname(os.path.dirname(os.path.abspath(__file__))), 'web') + '/' +E = html.escape +src = open(os.path.join(os.path.dirname(os.path.abspath(__file__)), 'gen_arch.py')).read() +# берём head() и TAIL из генератора архитектуры, чтобы шапка была одинаковой +ns = {'os': os, 'html': html, 'W': W, 'E': E} +exec(src[src.index('def head('):src.index('# ---------- данные проектов ----------')], ns) +head, TAIL = ns['head'], ns['TAIL'] + +def dims(img): + o = subprocess.run(['magick', 'identify', '-format', '%w %h', W + f'img/proj/{img}.webp'], capture_output=True, text=True).stdout.split() + return int(o[0]), int(o[1]) +def srcset(img): + w, _ = dims(img); parts = [] + for suf, ww in (('-sm', 640), ('-md', 960)): + if os.path.exists(W + f'img/proj/{img}{suf}.webp') and ww < w: parts.append(f'/img/proj/{img}{suf}.webp {ww}w') + parts.append(f'/img/proj/{img}.webp {w}w'); return ', '.join(parts) +def fig(img, cap, kind='', lead=False): + w, h = dims(img) + cls = 'shot' + (f' shot--{kind}' if kind else '') + (' shot--lead' if lead else '') + lz = ' fetchpriority="high"' if lead else ' loading="lazy" decoding="async" fetchpriority="low"' + return f'''
    + {E(cap)} +
    {E(cap)}
    +
    +''' +GAME = 'https://grid.ibrash.duckdns.org/' +# ---------- страница игры ---------- +title = "Aman's World" +desc = "Aman's World: 3D-игра с паркуром и гонками, которая запускается прямо в браузере. Неоновый хаб, гонки Sector 3 Run и Ascend Only." +stats = [('5','порталов в хабе'),('8','чекпоинтов, Sector 3 Run'),('13','чекпоинтов, Ascend Only'),('40','МБ при первом запуске')] +secs = [ + ('Неоновый хаб', 'Ты начинаешь в хабе: зал с неоновыми колоннами, вращающейся скульптурой-атомом и порталами на карты. Над гоночными порталами висят таблицы рекордов. Перед входом вводишь ник до 16 символов.'), + ('Паркур', 'Движение собрано под паркур: бег, прыжок, двойной прыжок, рывок, скольжение, бег по стенам, прыжок от стены и подтягивание на уступы. На трассах лежат полосы-ускорители.'), + ('Две гоночные трассы', 'Sector 3 Run гонит по вечернему оранжевому городу, на трассе 8 чекпоинтов. Ascend Only ведёт всё выше по фиолетовому ночному городу, там 13 чекпоинтов. Перед стартом нажимаешь R, то есть «готов», а счётчик (0/1) показывает, сколько игроков готово. Время идёт, и побеждает самый быстрый.'), + ('На чём играть', 'Игра работает только на компьютере, на телефоне она не запустится. Управлять можно клавиатурой и мышью или геймпадом вроде Xbox.'), + ('Песочница и Backrooms', 'Ещё из хаба можно уйти в песочницу, где просто отрабатываешь движение, и на карту Backrooms.'), + ('Под капотом', 'Игру я сделал сам на движке Godot 4 и выложил на свой сервер. При первом запуске браузер загружает около 40 МБ, зато потом всё работает быстро.')] +stat_html = ''.join(f'
  • {n}{E(l)}
    • ' for n, l in stats) +body = ''.join(f'

    {E(t)}

    {E(p)}

    ' for t, p in secs) +h = head(title, desc, 'projects-amans-world.jpg') +h += f''' +
    +

    ← Проекты

    +
    +
    • 3D
    • в браузере
    • только на ПК
    • Godot 4
    +

    {E(title)}

    +

    Паркур и гонки в неоновом городе. Запускается прямо в браузере.

    +
    Играть

    Работает только на компьютере. Можно играть с геймпадом (Xbox).

    +
    + +
    +{fig('game-ascend','Ascend Only: старт трассы вверх, 13 чекпоинтов', 'cover', True)}
    + +
      {stat_html}
    + +
    +

    Игра, в которую можно зайти по ссылке. Без установки и без регистрации.

    + {body} +
    + +
    +

    Кадры из игры

    +
    +{fig('game-sector3','Sector 3 Run: старт трассы, 8 чекпоинтов')}{fig('game-hub','Хаб: порталы Sandbox, Backrooms, Race и Race 2')}{fig('game-splash','Заставка игры', 'wide')}
    +
    + + +
    +''' + TAIL +os.makedirs(W + 'projects/amans-world', exist_ok=True) +open(W + 'projects/amans-world/index.html', 'w').write(h) + +CARD2 = ''' +
    Иллюстрация: домашний сервер с тремя сервисами
    +
    +
    • дома
    • Linux
    • Fedora
    +

    Хоумлаб

    +

    Мой домашний сервер: файлы, игра и эксперименты. И Linux, на котором я всё делаю.

    + Смотреть проект +
    +     +''' +# ---------- список проектов ---------- +w0, h0 = dims('game-ascend') +idx = head('Проекты', "Мои проекты: Aman's World, 3D-игра с паркуром и гонками, которая запускается прямо в браузере.", 'projects.jpg') +idx += f''' +
    +
    +

    Проекты

    +

    Что я делаю

    +

    Кроме учёбы и работы я собираю свои штуки. Выбери проект и загляни внутрь.

    +
    + +
    + +
    Aman's World: старт трассы Ascend Only
    +
    +
    • 3D
    • в браузере
    • только на ПК
    • Godot 4
    +

    Aman's World

    +

    Паркур и гонки в неоновом городе. Запускается прямо в браузере, ничего ставить не надо.

    + Смотреть проект +
    +     +''' + CARD2 + '''
    + + +
    +''' + TAIL +open(W + 'projects/index.html', 'w').write(idx) + + +# ---------- страница хоумлаба ---------- +hl_title = 'Хоумлаб' +hl_desc = 'Мой домашний сервер и Fedora Linux: Nextcloud, моя игра и эксперименты, на которых я учусь DevOps.' +hl = head(hl_title, hl_desc, 'projects-homelab.jpg') +hl += ''' +
    +

    ← Проекты

    +
    +
    • дома
    • Linux
    • Fedora
    +

    Хоумлаб

    +

    Мой домашний сервер и Linux, на котором я всё делаю.

    +
    + +
    +
    + Иллюстрация: домашний сервер с тремя сервисами +
    +
    + +
    +

    Свой маленький интернет у меня дома.

    +

    Что это

    +

    Хоумлаб — это мой домашний сервер. Я работаю системным администратором и расту в сторону DevOps, поэтому держу дома место, где можно пробовать всё на настоящем железе.

    +

    Дома можно спокойно пробовать, ломать и чинить. Так я учусь автоматизации и всему, что окружает современный сервер.

    +
    + +
    +

    Что на нём живёт

    +
    +

    Nextcloud

    Мои файлы и проекты лежат у меня, а не в чужом облаке.

    +

    Aman's World

    Моя браузерная игра запускается с этого сервера.

    Смотреть игру →     +

    DuckDNS

    Бесплатные адреса, чтобы до домашнего сервера можно было достучаться снаружи.

    +

    Этот сайт

    Он тоже переезжает сюда. Выкладку хочу автоматизировать через CI.

    +

    И много чего ещё

    Список растёт: я постоянно что-то поднимаю и пробую.

    +
    +
    + +
    +

    Fedora Linux

    +

    На своём компьютере я пользуюсь Fedora Linux. В ней я учусь, работаю и делаю свои проекты, в том числе этот сайт.

    +
    +
    +''' + TAIL +os.makedirs(W + 'projects/homelab', exist_ok=True) +open(W + 'projects/homelab/index.html', 'w').write(hl) + +# sitemap: дописываем недостающие адреса +sm_path = W + 'sitemap.xml' +sm = open(sm_path).read() +for u in ['/projects/', '/projects/amans-world/', '/projects/homelab/']: + if f'https://example.com{u}' not in sm: + sm = sm.replace('', f' https://example.com{u}\n') +open(sm_path, 'w').write(sm) +print('projects pages: ok')