CMS YouWebsite · 2.0.0

Обзор и возможности CMS

← Все руководства

Версия 2.0.0.

Лёгкая CMS для сайтов небольших организаций: посетители получают готовые HTML-страницы, а сайт ведут в консоли /console/ — публикации, страницы, шапка и меню, пользователи, резервные копии — без работы с кодом.

Чем отличается от привычных CMS. Страница собирается не при каждом заходе посетителя, а один раз — когда редактор нажал «Сохранить»: сервер записывает готовый HTML-файл, и nginx отдаёт его как обычную страницу. Нет базы данных и PHP, на сервере — только стандартный Python, nginx и systemd, в браузере — без фреймворков и сторонних скриптов. Поэтому сайт быстрый, его трудно взломать, и он продолжает открываться, даже если консоль остановлена.

Установка: скачал → установил

Нужны свой сервер (VDS с Ubuntu 24.04+, от 1 ГБ памяти), домен и почтовый ящик для писем сайта. Собирать ничего не нужно — в архиве готовый сайт.

  1. Скачайте архив cms-youwebsite-<версия>.zip и отправьте его на сервер.
  2. На сервере распакуйте архив и выполните sudo bash install.sh — команда спросит домен и название сайта, остальное сделает сама: nginx, сертификат HTTPS, служба сайта, ночные резервные копии.
  3. Откройте ссылку, которую напечатает установка, и в окнах в браузере задайте почту сайта и владельца.

Подробно, с командами и ответами на вопросы установки, — в INSTALL.md. Обновление — та же команда из нового архива.

Что умеет

  • готовый демонстрационный сайт: адаптивная главная с полноэкранным первым экраном, страницы «О проекте», «Руководитель», «Публикации» и «Контакты»;
  • свои страницы из блоков (текст, фото, галерея, файлы, кнопка, таблица, вопрос — ответ, колонки, HTML для админа) создаются в консоли («Страницы»): админ создаёт, публикует и удаляет, редакторы правят содержание; новая страница сама встаёт в оба меню (памятка);
  • шапка и меню настраиваются в консоли («Шапка и меню», только админ): две версии — для компьютера и телефона — с общим содержимым и своими меню, подменю, просмотр на настоящей странице; свой цвет из палитры с ползунками оттенка и яркости (все 360 вариантов проверены на читаемость); сайт сам показывает кнопку меню, если шапка не помещается (памятка);
  • подвал настраивается там же («Подвал»): текст, колонка разделов, контакты, строка с годом; подпись «Сайт на CMS YouWebsite» можно убрать (памятка);
  • стеклянная шапка после прокрутки на телефоне;
  • новости и объявления с постоянным номером и смысловой частью URL;
  • автоматическая транслитерация адресов и варианты адреса из заголовка;
  • свободный порядок блоков: текст, изображение, галерея и PDF;
  • свой редактор текста без библиотек: Enter даёт абзац, вставка из Word и с сайтов очищается сразу, быстрые метки (## — заголовок, - — список, **жирный**), ссылка вставкой адреса на выделенный текст и по Ctrl+K; подсказка в консоли и памятка для редакторов;
  • типограф для публикаций («ёлочки», тире, неразрывные пробелы после предлогов) — включает админ в «Настройках»; работает при сборке страниц и не меняет текст редактора;
  • правка кода постоянных страниц прямо в консоли — только для админа: HTML основной части страницы, загрузка файла со ссылкой, история версий и откат;
  • из загружаемых фото сервер удаляет метаданные (GPS, модель камеры, дату съёмки, XMP, IPTC, C2PA, комментарии), не пережимая фото и сохраняя пометку поворота;
  • галерея без обрезки исходников, полноэкранный просмотр, листание, скачивание и системная кнопка «Поделиться» на поддерживаемых устройствах;
  • вход по логину и паролю с одноразовым кодом на почту;
  • установка одной командой sudo bash install.sh; почту сайта (с проверкой) и владельца задают в браузере, в окнах установки, без правки файлов в терминале (INSTALL.md, шаг 3);
  • роли: суперадмин (владелец сайта), админ, редактор и автор — каждый видит в консоли только своё; пользователей приглашают из консоли письмом, каждое изменение подтверждается кодом; права суперадмина передаются с согласия обеих сторон (памятка);
  • проверка публикаций авторов (включает суперадмин): новые публикации и правки ждут проверки, на сайте до этого остаётся проверенная версия;
  • обновление той же командой: данные сайта не затрагиваются, входы в консоль сохраняются, сайт ни на секунду не остаётся без стилей;
  • серверные ограничения, CSRF-защита, ограничение попыток входа, безопасные cookie, шаблоны Nginx и systemd;
  • резервные копии: каждую ночь на сервере, скачивание ZIP из консоли; владелец восстанавливает сайт прямо в консоли — из копии на сервере или загрузив свою с компьютера (переезд после поломки сервера), либо командой на сервере (для редакторов, для администратора);
  • своя проверка «не робот» для кнопки «Написать письмо» — без сторонних сервисов, ключей и cookie; на сайте нет ни одного внешнего скрипта.

Документация

Кому Что
Тому, кто ставит сайт INSTALL.md — установка, обновление, что делать, если что-то пошло не так
Владельцу и админам Пользователи и роли, Шапка и меню, Подвал, Страницы
Редакторам Редактор текста, Как сохранить копию сайта
Администратору сервера Как устроена установка, Резервные копии
Разработчику Что где лежит в исходниках и раздел ниже

Для разработчиков

В архиве, кроме готового сайта (dist/), лежат исходники: страницы и стили (Vite, TypeScript без фреймворков), сервер (server/, только стандартная библиотека Python) и шаблоны nginx и systemd (deploy/).

Локальный запуск

Нужны Node.js 20+ и Python 3.9+.

npm ci
npm run dev

Для публикаций и консоли нужен локальный сервер. Во втором окне терминала:

npm run dev:api

Команда при первом запуске копирует демонстрационные данные из server/seed/ в .dev-data/ (каталог не попадает в git) и собирает в .dev-data/public/ страницы публикаций. Vite отдаёт их так же, как nginx на сервере. Чтобы начать с чистых демонстрационных данных, удалите .dev-data/.

Сайт откроется по адресу, который покажет Vite. Для входа в /console/ нужно положить файл пользователей в .dev-data/editors.json (образец — deploy/editors.example.json) и настроить почту.

Проверка и сборка архива

npm run check
npm run test:api
npm run build

Архив для скачивания собирает одна команда — она же запускает все проверки:

npm run release

Результат — release/cms-youwebsite-<версия>.zip и файл .sha256 рядом.

Как устроены страницы публикаций

Публикации не отрисовываются в браузере. Служба сайта (server/site_pages.py) при сохранении, снятии с публикации или удалении материала пишет готовые HTML-страницы с полным текстом, заголовком, описанием, canonical, Open Graph и JSON-LD, список /news/, /news/latest.json для главной и sitemap.xml. При запуске службы все страницы собираются заново. Скрипты в браузере только включают просмотр фотографий и фильтр списка.

Шаблоном служит собранный news/index.html: в нём размечены блоки <!-- yw:head -->, <!-- yw:list-only --> и <!-- yw:content -->. Оформление страниц публикаций меняется в этом файле и в стилях, как у остальных страниц.

Текст публикаций сервер очищает дважды — при сохранении и при сборке страницы: остаются абзацы, заголовки, списки, цитаты, жирный, курсив, подчёркнутый и ссылки, а <div> и подобные блоки становятся абзацами. Если включён типограф (settings.typograph в content.json, server/typograph.py), он обрабатывает заголовок, анонс и текст при сборке, сохранённый текст не меняется.

Редактор текста в консоли (src/scripts/rich-editor.ts) построен на document.execCommand: команда устаревшая, но её поддерживают все браузеры и она даёт встроенные «Отменить» и «Повторить». Если браузеры объявят об её удалении, редактор переписывается на событиях beforeinput; серверная очистка при этом не меняется, поэтому сайт от такой замены не зависит.

Номер публикации постоянен. Если поменять адрес после номера, старый адрес и /news/<номер>/ ведут на новый.

Лицензия

CMS YouWebsite бесплатна. Её можно ставить на любые сайты, в том числе коммерческие, брать плату за создание и сопровождение сайтов на ней и менять код под себя. Изменённую программу можно распространять только под другим названием и без знака YouWebsite. Подпись «Сайт на CMS YouWebsite» со знаком YouWebsite в подвале можно убрать — в консоли, «Подвал»; логотип в шапке заменяется своим в «Шапке и меню». Программа предоставляется «как есть».

Полный текст — в файле LICENSE: открытая лицензия по статье 1286.1 Гражданского кодекса РФ. Шрифты Cormorant Garamond и Manrope распространяются по SIL Open Font License 1.1.

© 2026 Дмитриев Дмитрий Николаевич. Разработано YouWebsite.