返回项目
开发中AstroStarlightMDXMarkdown2025
黑客笔记
使用 Astro 5 与 Starlight 主题生成的静态站点：笔记存放在 `docs` 集合（`src/content/docs`），通过 Content Collections 管理，必要时使用 Markdown 与 MDX。侧栏与主题顺序由 `starlight-sidebar.mjs` 定义；样式通过 Starlight 的 `customCss` 加载 `theme.css` 与 `markdown-layout.css`。包含标题与正文搜索、适当时的目录、明暗主题，并以配置的 `base` 路径部署到 GitHub Pages。
项目截图
1 / 7
我学到了什么
- 使用 Astro 5 与 Starlight 搭建文档站点（静态输出与 SEO）
- 通过 Content Collections 与 Starlight 的 `docsLoader` 组织内容
- 用 `starlight-sidebar.mjs` 显式控制侧栏结构
- 用自定义 CSS 与 MDX 定制 Starlight 并丰富页面
更多说明
- 项目最初以 React 构建；该版本保留在 GitHub 分支 `archive/react`。
- 包含与用户在界面所选主题一致（默认为深色）的自定义 404 页面。
技术细节
- •Astro 5（`output: 'static'`）集成 Starlight 与 `@astrojs/mdx`
- •在 `src/content.config.ts` 中用 Starlight 的 `docsSchema` 定义 `docs` 集合
- •侧栏由 `starlight-sidebar.mjs` 驱动
- •`customCss`：`theme.css` 与 `markdown-layout.css`
- •GitHub Pages：`site` + `base: '/WEB-Notas-de-Hacking'`
- •在 `src/pages/404.astro` 自定义 404（Starlight `disable404Route`）