Источник
Только docs/ является каноническим источником учебных материалов.
Engineering
Как StackMIREA превращает MDX в статическую образовательную платформу
Один pipeline отвечает за навигацию, страницы, поиск и проверку качества — без отдельной CMS и backend.
Путь материала
docs/**/*.mdx
Validation + manifest
Next.js static build
Navigation
Docs pages
Search index
GitHub Pages
Компоненты pipeline
Content manifest
Содержит маршруты, метаданные, TOC, темы, превью и данные для навигации.
Поисковый индекс
На build-time материал делится на смысловые фрагменты и получает ключевые слова.
Quality gates
CI проверяет frontmatter, дубликаты, ссылки, orphan pages, TypeScript, тесты и build.
Технологии
- Next.js 14
- App Router, маршруты и статический export.
- TypeScript
- Строгая типизация компонентов и data layer.
- MDX
- Учебный текст вместе с переиспользуемыми компонентами.
- Shiki
- Build-time подсветка синтаксиса без тяжёлого runtime.
- GitHub Actions
- Проверки качества и воспроизводимая сборка.
- GitHub Pages
- Хостинг готовых статических файлов с basePath.