Запустите сайт из ZIP-архива Konso
Архив мастера сайта — это готовый статический сайт и его исходный код. Покажем, как открыть его на компьютере, выложить на свой хостинг и пересобрать после правок.
Открыть мастер сайта arrow_forwardTL;DR
- check_circleАрхив site-<ID проекта>.zip содержит три папки: web (готовый сайт), template (исходники) и config (инструкция и konso.json)
- check_circleДля хостинга нужна только папка web: загрузите её содержимое в корень сайта (public_html, www или htdocs)
- check_circleПосмотреть сайт локально: установите Node.js 24+ и выполните npx serve web
- check_circleМенять дизайн — в папке template: pnpm install, pnpm dev, затем pnpm build; результат в template/dist
- check_circleПравки в архиве не попадают в Konso: следующая публикация из Konso соберёт сайт из контента CMS
Что вы получите в конце
Сайт, открытый на вашем компьютере с работающими ссылками между страницами, и тот же сайт, размещённый на вашем хостинге или домене. По желанию — собственная версия шаблона с изменённым дизайном.
Что понадобится
- check_circleZIP-архив сайта из мастера сайта (кнопка «Скачать ZIP», см. туториал «Создайте сайт с мастером сайта Konso»)
- check_circleДля просмотра на компьютере и пересборки — Node.js версии 24 или новее с nodejs.org
- check_circleДля пересборки — pnpm (ставится одной командой, см. шаг 5)
- check_circleДля размещения — любой хостинг, который умеет отдавать статические HTML-файлы
Шаг 1. Распакуйте архив и разберитесь в папках
Распакуйте site-<ID проекта>.zip в любую папку. Внутри:
- web/ — готовый сайт. Ровно то, что опубликовано на konso.space: index.html, папки страниц (about/index.html, blog/…), стили в _astro/, 404.html и robots.txt;
- template/ — исходный код: package.json, pnpm-lock.yaml, astro.config.mjs, konso-template.json и папка src. Тексты и цвета сайта лежат в template/src/data/konso-content.json;
- config/ — README.md с короткой инструкцией и konso.json (projectId, buildId, siteUrl, template).
[скриншот: распакованный архив с папками web, template, config]
Шаг 2. Посмотрите сайт на компьютере
Если дважды щёлкнуть web/index.html, откроется главная страница, но ссылки между страницами работать не будут: сайт рассчитан на веб-сервер. Запустите простой локальный сервер:
- Установите Node.js 24 или новее с nodejs.org (кнопка «LTS»).
- Откройте терминал в папке, куда распаковали архив (Windows: «Терминал» или PowerShell; Mac: «Терминал»).
- Выполните:
npx serve web
- Откройте адрес, который появится в терминале (обычно http://localhost:3000).
Если на компьютере уже есть Python, Node.js не нужен:
python3 -m http.server 8000 --directory web
и откройте http://localhost:8000.
[скриншот: терминал с запущенным npx serve web и сайт в браузере на localhost]
Шаг 3. Выложите сайт на свой хостинг
Программирование не нужно, понадобится только папка web.
- Откройте панель управления хостингом.
- Найдите файловый менеджер или подключитесь по FTP. Корневая папка сайта обычно называется public_html, www или htdocs.
- Загрузите туда всё содержимое папки web — не саму папку web, а то, что внутри. Файл index.html должен оказаться прямо в корневой папке.
- Откройте свой домен в браузере.
Шаг 4. Поменяйте тексты
Проще всего — в Konso: Динамическая CMS → Контент, поправьте нужную страницу, затем в Мастере сайта нажмите «Опубликовать заново» и скачайте архив ещё раз. Так тексты останутся синхронизированы с CMS и сайтом на konso.space.
Без Konso: откройте template/src/data/konso-content.json в любом текстовом редакторе. Меняйте только текст внутри кавычек, сами кавычки, запятые и скобки не трогайте. После правок пересоберите сайт (шаги 5–7).
Шаг 5. Подготовьте шаблон к сборке
Установите pnpm и зависимости шаблона:
npm install -g pnpm
cd template
pnpm install --frozen-lockfile
Флаг --frozen-lockfile ставит ровно те версии пакетов, с которыми Konso собирал ваш сайт.
Шаг 6. Меняйте дизайн с живым просмотром
Запустите режим разработки в папке template:
pnpm dev
Откройте адрес из терминала (обычно http://localhost:4321). Просмотр обновляется при каждом сохранении файла.
Где что лежит:
- template/src/pages — маршруты сайта;
- template/src/layouts/Base.astro — общий каркас страницы (шапка, меню, подвал);
- template/src/components — блоки страниц и списки записей;
- template/src/data/konso-content.json — тексты, меню, цвета (site.colors) и шрифт (site.font).
[скриншот: редактор кода с файлом Base.astro и сайт в режиме pnpm dev]
Шаг 7. Соберите готовый сайт
Остановите pnpm dev (Ctrl+C) и выполните:
pnpm build
Готовый сайт появится в template/dist. Проверьте его локально:
npx serve dist
и загрузите содержимое template/dist на хостинг так же, как папку web в шаге 3.
Какую папку использовать
| Задача | Папка | Нужен Node.js |
|---|---|---|
| Выложить сайт на хостинг как есть | web/ | Нет |
| Посмотреть сайт на компьютере | web/ | Да (или Python) |
| Поменять тексты без Konso | template/src/data/konso-content.json | Да, для пересборки |
| Поменять дизайн | template/src/ | Да |
| Узнать ID проекта и адрес сайта | config/konso.json | Нет |
Важно
Изменения в архиве не попадают в Konso. Если потом нажать «Опубликовать заново» в мастере, сайт на konso.space снова соберётся из контента CMS, а не из ваших локальных правок. Решите, где источник правды: тексты удобнее вести в Konso, глубокие правки дизайна — в своей копии шаблона.
Типичные ошибки
- check_circleЗагрузка самой папки web на хостинг — сайт откроется по адресу /web/ вместо корня домена. Загружайте содержимое папки
- check_circleОткрытие index.html двойным щелчком и вывод «ссылки сломаны» — нужен локальный сервер (шаг 2)
- check_circleСломанный JSON после правки konso-content.json — сборка падает с ошибкой парсинга. Проверьте кавычки и запятые рядом с изменённым местом
- check_circlepnpm install без --frozen-lockfile — могут поставиться другие версии пакетов, и сборка будет отличаться от сайта в Konso
- check_circleУдаление картинок в Konso — изображения в текстах загружаются с серверов Konso и пропадут и на вашем хостинге
Совет
Держите template в git-репозитории и подключите его к Cloudflare Pages или Netlify с командой сборки pnpm build и папкой dist. Тогда каждый коммит будет публиковать сайт автоматически.
Ещё нет архива?
Создайте сайт в мастере сайта Konso за несколько минут и скачайте его одной кнопкой
Открыть туториал arrow_forwardЧастые вопросы
Нужен ли сервер с PHP, Node.js или базой данных? expand_more
Нет. Папка web — статический сайт из HTML, CSS и картинок. Подойдёт любой хостинг, который отдаёт файлы.
Почему при открытии index.html двойным щелчком не работают ссылки? expand_more
Ссылки между страницами указаны от корня сайта (например, /about), а браузер при открытии файла не знает, где корень. Запустите локальный сервер: npx serve web.
Какая версия Node.js нужна? expand_more
24 или новее. Её указывает поле node в template/konso-template.json.
Можно ли использовать npm или yarn вместо pnpm? expand_more
Шаблон рассчитан на pnpm и содержит pnpm-lock.yaml. С другим менеджером версии пакетов могут отличаться. Рекомендуем pnpm.
Будет ли мой сайт обновляться, когда я меняю контент в Konso? expand_more
Нет. Копия на вашем хостинге не связана с Konso. После правок в CMS нажмите «Опубликовать заново», скачайте новый архив и загрузите обновлённую папку web.
Откуда берутся картинки на сайте? expand_more
Изображения в текстах подгружаются с серверов Konso по ссылкам. Если удалить картинку в Konso, она пропадёт и с вашего сайта.