这一页展示 Nimbus 组件接入效果:提示框、徽章、按钮、可切换标签页和折叠内容。组件源码由 Nimbus 脚手架复制进本仓库(src/components/ui/),没有黑盒依赖。
提示框
徽章与按钮
默认 成功 警告 描边 快速开始 HTML 交互标签页
用
.md 编写普通文档。用
.mdx 嵌入 Nimbus 组件。完整 HTML 放在
public/demos/,通过 iframe 嵌入。折叠内容
Nimbus 组件都是 Astro 组件,默认零客户端 JavaScript,交互由很小的原生脚本完成。
技术边界
- 页面框架:Astro + Nimbus 负责导航、搜索、路由与目录。
- 正文组件:Nimbus 自带 Astro 组件(Tailwind + 设计令牌)。
- 静态部署:文档预渲染为 HTML。
- 完整 HTML:仍然可以作为独立文件,通过 iframe 嵌入。
继续扩展
如果以后需要代码执行、数据库或登录,保留静态文档并增加独立 API 即可,不需要为这些功能迁移现有文档。