Opensophy Hub — первый open-source проект от Opensophy: статическая платформа для документации с богатым Markdown

Всем привет! Opensophy выпустила свой первый публичный open-source проект — Hub, гибридную SSG+SPA платформу для публикации технических знаний, статей и документации.

Задача звучала так: нужна была платформа для хранения статей Opensophy и мануалов, где возможностей обычного Markdown было бы недостаточно. Параллельно шла работа над проектом UI-библиотеки с реестром компонентов (об этом писал раньше). И третья задача — показать интересный эксперимент: ИИ полностью пишет проект, а DevSecOps-процессы делают код чище, грамотнее и сам проект безопаснее.

Чтобы решить три проблемы одновременно, был создан Hub.

Сейчас Hub уже работает в продакшне(да и до этого он был доступен но получил недавно мощный апдейт https://hub.opensophy.com/). UI-библиотека пополняется потихоньку (ещё не вышла в релиз). Параллельно пишется статья про принципы безопасной разработки вайбкода — звучит забавно, ИИ и безопасность кода в одном предложении, но именно это интересно показать: как интеграция DevSecOps-инструментов в процесс разработки с ИИ даёт проектам заметно более высокий балл качества кода, чем вообще без него.

Пожалуй, самое элегантное решение в проекте. Папки в Docs/ — это и есть навигация на сайте. Никакой настройки роутинга вручную: сайдбар, breadcrumbs и URL генерируются автоматически из файловой структуры.

Это всё. Раздел, категория, статья — три уровня, три типа папок с префиксами [N], [C], [A]. Slug, иконка и название берутся прямо из имени папки или файла. Подробнее написал здесь

Обычный Markdown умеет текст, таблицы, код. Hub расширяет его прямо из коробки: карточки, колонки, степпер, диаграммы, алерты — всё это пишется в чистом .md.

Например, чтобы вставить предупреждение в стандартном HTML, нужно:

В Hub это выглядит так:

Или вставить