Files
site-portfolio/docs/local-server.md
T

46 lines
1.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Локальный просмотр сайта
Сайт в режиме разработки обслуживается из папки `**public/**` через нативный HTTP-сервер (Node.js `http` модуль): статика + API правок контента.
## Требования
- **Node.js 22** (см. `.node-version` в корне проекта). fnm/fvm переключают автоматически.
- **npm** (идёт вместе с Node).
## Первый раз в проекте
В корне репозитория (рядом с `package.json`):
```bash
npm install
npm run vendor:copy
```
(или `npm run build` — vendor + сборка HTML из `src/`.)
## Запуск
```bash
npm run serve
```
Скрипт [`scripts/serve-dev.mjs`](../scripts/serve-dev.mjs): статика из `public/`, API правок контента. Нет авто-релиоада — после правок в `public/` обновляй страницу вручную.
## Куда смотреть
- **Сайт:** [http://localhost:4175](http://localhost:4175) — откроется `public/index.html` и остальные пути относительно `public/`.
## API правок контента
Только с localhost:
- `GET /api/content-edits?page=cases/foo.html` — правки для страницы;
- `GET /api/content-edits` — весь `pending.json`;
- `PUT /api/content-edits?page=…` — тело: `{ page, items[] }` (мерж в общий файл).
Файл: **`texts/content-edits/pending.json`**. См. [`docs/content-edit-mode.md`](content-edit-mode.md).
## Остановка
В терминале: **Ctrl+C**.