Назад к проектам
В разработкеAstroStarlightMDXMarkdown2025

Заметки о взломе

Статический сайт на Astro 5 и теме Starlight: заметки в коллекции `docs` (`src/content/docs`) через Content Collections, Markdown и MDX по необходимости. Боковое меню и порядок тем задаются в `starlight-sidebar.mjs`; оформление — пользовательским CSS (`theme.css`, `markdown-layout.css`) через `customCss` Starlight. Есть поиск по заголовкам и тексту, оглавление где уместно, светлая/тёмная тема и публикация на GitHub Pages с настроенным `base`.

Смотреть демоСмотреть код

Скриншоты проекта

Заметки о взломе — vista previa

1 / 7

Чему я научился

  • Сборка документации на Astro 5 и Starlight (статический вывод и SEO)
  • Организация контента через Content Collections и `docsLoader` Starlight
  • Явное управление боковым меню через `starlight-sidebar.mjs`
  • Настройка темы Starlight своим CSS и MDX для более насыщенных страниц

Дополнительно

  • Проект изначально создавался на React; та версия сохранена в ветке GitHub `archive/react`.
  • Есть пользовательская страница 404, согласованная с выбранной пользователем темой интерфейса (по умолчанию — тёмная).

Технические детали

  • •Astro 5 (`output: 'static'`) с интеграциями Starlight и `@astrojs/mdx`
  • •Коллекция `docs` в `src/content.config.ts` со схемой `docsSchema` Starlight
  • •Боковое меню из `starlight-sidebar.mjs`
  • •`customCss`: `theme.css` и `markdown-layout.css`
  • •GitHub Pages: `site` + `base: '/WEB-Notas-de-Hacking'`
  • •Свой 404 в `src/pages/404.astro` (`disable404Route` в Starlight)