PLANET

Knowledge Base

欢迎来到 Planet

一个带固定侧边栏的 Astro 文档壳子。

结构目标

这个项目不是普通博客首页,而是一个偏文档式的阅读壳子。

  • 左侧固定 sidebar
  • 右侧主内容区
  • 菜单点击后切换对应 MDX 页面
  • 移动端通过 Menu 按钮展开导航

为什么用 MDX

MDX 允许你把内容和组件能力组合在一起,后面你可以继续往正文里插入:

  • 自定义卡片
  • Demo 组件
  • 数据图表
  • 代码片段

路由方式

当前实现是“一篇 MDX 对应一个页面路由”。

比如这篇内容的地址就是:

/welcome

由于 sidebar 放在统一布局里,所以用户的感受会是“只换了 main 内容”。