VitePress-сайт бизнес-учебника

Актуальность: 3 августа 2026 года.

Назначение

VitePress превращает общие Markdown-стандарты и шаблоны в статический сайт с навигацией, полнотекстовым поиском и адаптивной темой. Каноническим источником остаётся Markdown: отдельная копия контента для сайта не создаётся.

Команды

corepack pnpm install
corepack pnpm dev
corepack pnpm build
corepack pnpm preview

Локальные dev/preview-серверы привязаны к 127.0.0.1. Production-артефакт создаётся в .vitepress/dist/ и не публикуется автоматически без настроенного целевого хостинга.

Что включено

• главная страница index.md;
• спецификация ../../SPEC.md;
• весь бизнес-учебник;
• все рабочие шаблоны.
• презентационная главная с тремя маршрутами, картой системы и сквозным кейсом.

Материалы конкретных бизнесов хранятся в соседних независимых проектах ../snt и ../i и не попадают в сборку bis.

Конфигурация

• .vitepress/page-registry.mjs — единый реестр страниц и групп sidebar;
• .vitepress/config.mts — nav, генерация sidebar из реестра, поиск и подписи;
• .vitepress/theme/index.ts, custom.css и HomeShowcase.vue — расширение стандартной темы и презентационная главная;
• public/favicon.svg — локальный знак без внешних запросов;
• public/business-system-hero.svg — адаптивная hero-иллюстрация;
• package.json и lock-файл — воспроизводимая версия VitePress;
• .gitignore — исключение зависимостей, кэша и production-сборки.

Вёрстка использует фиолетово-бирюзовую палитру с оранжевыми акцентами, мягкие карточки, крупную презентационную типографику, русские подписи поиска и раздельные боковые меню.

При добавлении страницы нужно добавить ссылку в тематический маршрут и один раз зарегистрировать её в .vitepress/page-registry.mjs; sidebar строится из этого реестра. Проверка останавливает сборку для незарегистрированной страницы, дубликата заголовка, битой внутренней ссылки или устаревшего реестра таблиц.

Каждая Markdown-таблица получает серверно отрендеренную кнопку «Скачать CSV». Клиентский обработчик защищает опасные первые символы, добавляет UTF-8 BOM и формирует имя из пути страницы и ближайшего заголовка.

Кнопка экспортирует только статическое содержимое текущей страницы. Сайт не редактирует, не принимает и не хранит данные бизнеса. Не каждая таблица является формой: справочные таблицы скачиваются как снимок, а рабочие копии создаются из шаблонов по инструкции WORKING_WITH_FILLED_DATA.md.

cleanUrls отключён: действующий Caddy file_server раздаёт физические .html-файлы без rewrite. Поэтому внутренние ссылки сборки содержат .html и работают без изменения production-конфигурации reverse proxy.

Связанные документы

• инструменты и зависимости — ../TOOLS_AND_EXTENSIONS.md;
• поддержание ссылок и версий — ../KNOWLEDGE_MAINTENANCE.md;
• правила табличных файлов — ../data/INDEX.md.
• метрики прохождения — USEFULNESS_METRICS.md.