Туториал

Запустите сайт из ZIP-архива Konso

Архив мастера сайта — это готовый статический сайт и его исходный код. Покажем, как открыть его на компьютере, выложить на свой хостинг и пересобрать после правок.

Открыть мастер сайта arrow_forward
bolt

TL;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, откроется главная страница, но ссылки между страницами работать не будут: сайт рассчитан на веб-сервер. Запустите простой локальный сервер:

  1. Установите Node.js 24 или новее с nodejs.org (кнопка «LTS»).
  2. Откройте терминал в папке, куда распаковали архив (Windows: «Терминал» или PowerShell; Mac: «Терминал»).
  3. Выполните:
npx serve web
  1. Откройте адрес, который появится в терминале (обычно http://localhost:3000).

Если на компьютере уже есть Python, Node.js не нужен:

python3 -m http.server 8000 --directory web

и откройте http://localhost:8000.

[скриншот: терминал с запущенным npx serve web и сайт в браузере на localhost]

Шаг 3. Выложите сайт на свой хостинг

Программирование не нужно, понадобится только папка web.

  1. Откройте панель управления хостингом.
  2. Найдите файловый менеджер или подключитесь по FTP. Корневая папка сайта обычно называется public_html, www или htdocs.
  3. Загрузите туда всё содержимое папки web — не саму папку web, а то, что внутри. Файл index.html должен оказаться прямо в корневой папке.
  4. Откройте свой домен в браузере.

Шаг 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)
Поменять тексты без Konsotemplate/src/data/konso-content.jsonДа, для пересборки
Поменять дизайнtemplate/src/Да
Узнать ID проекта и адрес сайтаconfig/konso.jsonНет
lightbulb

Важно

Изменения в архиве не попадают в 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 и пропадут и на вашем хостинге
tips_and_updates

Совет

Держите 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, она пропадёт и с вашего сайта.