- Opensophy открыла исходный код Hub — платформы для публикации документации и статей.
- Сервис уже используется в продакшене на сайте Hub и получил крупное обновление с панелью редактирования.
- Hub сочетает статическую генерацию и интерфейс веб-приложения, а также расширяет обычный Markdown без MDX и дополнительных плагинов.
Opensophy выпустила свой первый публичный open-source проект — Hub, платформу для публикации документации, статей и технических материалов. Проект уже работает на собственном сайте компании, а в свежем релизе получил встроенную панель управления контентом, которая позволяет редактировать Markdown и сразу видеть результат.
Hub описывают как гибрид SSG и SPA: сайт собирается как статический, но по ощущению работает как приложение. Основная идея сервиса — упростить ведение базы знаний без ручной настройки маршрутов и сложной структуры. Навигация, URL, боковое меню и цепочка переходов формируются автоматически из структуры папок в директории Docs. Названия разделов, иконки и адреса страниц система берёт прямо из имён файлов и каталогов.
Отдельный акцент сделан на расширенном Markdown. Платформа поддерживает карточки, колонки, пошаговые инструкции, предупреждения, формулы KaTeX и диаграммы, причём всё это можно описывать в обычных .md-файлах. По задумке Opensophy, это позволяет готовить более сложную документацию без перехода на MDX, HTML-вставки и дополнительные плагины.
Ещё одна особенность Hub — интерактивные элементы внутри документации. Обычные Markdown-таблицы здесь превращаются в компоненты с поиском, фильтрами, скрытием колонок, полноэкранным режимом и копированием данных. Кроме того, в страницы можно встраивать live playground для UI-компонентов, чтобы читатель менял параметры прямо в браузере и сразу видел результат.
В новой версии также появилась CMS-подобная панель редактирования. Через неё можно создавать страницы, категории и разделы из интерфейса, не запуская локальную сборку ради каждой правки. По словам авторов, проект вырос из внутренней потребности хранить статьи и документацию в более гибком формате, чем даёт стандартный Markdown.
Hub стал первым открытым проектом Opensophy. Его разрабатывали параллельно с UI-библиотекой и реестром компонентов, которые компания тоже готовит для публикации.
Команды, которые ведут документацию в Markdown, получают ещё один open-source инструмент с готовой структурой навигации и визуальным редактированием. Для авторов это снижает объём ручной настройки, а для читателей делает документацию более интерактивной.
