一个现代化、功能丰富的静态博客模板,基于 Astro & Mizuki 构建,具有先进的功能和精美的设计。
- 统一配置架构: 全新的模块化组件配置体系,支持动态组件管理和顺序配置
- 配置驱动的组件加载: 重构 SideBar 组件,实现完全基于配置的组件加载机制
- 统一控制开关: 移除音乐播放器和公告组件的独立 enable 开关,统一由 sidebarLayoutConfig 控制
- 响应式布局适配: 组件支持响应式布局,可根据设备类型自动调整显示
- 侧边栏位置动态调整: 支持左右侧边栏切换,布局自动适配
- 文章目录智能定位: 当侧边栏在右侧时,文章导航自动移至左侧,提供更好的阅读体验
- 网格布局改进: 优化 CSS Grid 布局,解决容器宽度异常问题
- 标准化配置格式: 创建统一的组件配置文件格式规范
- 类型安全: 完善的 TypeScript 类型定义,确保配置的类型安全
- 可扩展性: 支持自定义组件类型和配置选项
- 测试文件清理: 移除未使用的测试配置和依赖,减少项目体积
- 代码结构优化: 改进组件架构,提升代码可维护性
- 性能提升: 优化组件加载逻辑,提升页面渲染性能
- 基于 Astro 和 Tailwind CSS 构建
- 使用 Swup 实现流畅的动画和页面过渡
- 明暗主题切换,支持系统偏好检测
- 可自定义主题色彩和动态横幅轮播
- 全屏背景图片,支持轮播、透明度和模糊效果
- 全设备响应式设计
- 使用 JetBrains Mono 字体的优美排版
- 基于 Pagefind 的高级搜索功能
- 增强的 Markdown 功能,支持语法高亮
- 交互式目录,支持自动滚动
- RSS 订阅生成
- 阅读时间估算
- 文章分类和标签系统
- 多语言支持,实时翻译功能
- 自动语言检测,基于用户偏好
- 客户端翻译,由 Edge Translate 驱动
- 支持多种语言(中文、英文等)
- 追番页面 - 追踪动画观看进度和评分
- 游戏页面 - 展示游戏统计页面
- 友链页面 - 精美卡片展示朋友网站
- 归档页面 - 有序的文章时间线视图
- 关于页面 - 可自定义的个人介绍
- 增强代码块,基于 Expressive Code
- 数学公式支持,KaTeX 渲染
- 图片优化,PhotoSwipe 画廊集成
- SEO 优化,包含站点地图和元标签
- 性能优化,懒加载和缓存机制
- 评论系统,支持 Twikoo 集成
| 命令 | 操作 |
|---|---|
pnpm install |
安装依赖 |
pnpm dev |
在 localhost:4321 启动本地开发服务器 |
pnpm build |
构建生产站点到 ./dist/ |
pnpm preview |
在部署前本地预览构建 |
pnpm check |
运行 Astro 错误检查 |
pnpm format |
使用 Biome 格式化代码 |
pnpm lint |
检查并修复代码问题 |
pnpm new-post <文件名> |
创建新博客文章 |
pnpm astro ... |
运行 Astro CLI 命令 |
我们欢迎贡献!请随时提交问题和拉取请求。
- Fork 仓库
- 创建功能分支 (
git checkout -b feature/amazing-feature) - 提交更改 (
git commit -m 'Add some amazing feature') - 推送到分支 (
git push origin feature/amazing-feature) - 打开拉取请求
本项目基于 MIT 许可证 - 查看 LICENSE 文件了解详情。