关于本站
本站是一个基于 Astro 5 构建的技术博客,用于发布技术文章、学习笔记与资源整理。内容以 Markdown / MDX 编写,支持分类、标签、归档与全文搜索,具备评论、短链接和后台管理,界面采用终端 / 代码风格,方便阅读与导航。
技术架构
框架与构建
- Astro 5 — 主框架,SSR 模式 + 按需岛屿,首屏精简、交互按需加载
- Tailwind CSS 4 — 样式与布局,配合
@tailwindcss/typography排版文章 - Node 适配器 — 使用
@astrojs/node(middleware 模式),支持 session 等能力
内容与 Markdown
- Content Collections — 文章、页面、作者、友链等均通过集合管理
- MDX — 支持在 Markdown 中嵌入 JSX 组件
- Shiki — 代码高亮,亮色 / 暗色主题(github-light、github-dark)随站点主题切换
- remark-toc / rehype-slug — 自动目录与标题锚点
- GFM — GitHub 风格 Markdown(表格、任务列表等)
搜索与交互
- FlexSearch — 前端全文搜索,生成
search-index.json供检索 - 主题与色相 — 亮 / 暗模式 +
--hue色相调节,用 CSS 变量统一控制
可选集成
- React — 已集成,用于评论、主题切换、后台等交互组件
- Vue — 已集成,可在页面或 MDX 中使用 Vue 组件
内容与功能
- 首页 — 最新文章列表,终端式列表展示(
export、路径式标题) - 归档 — 按年 / 月分组的文章列表
- 分类与标签 — 按分类、标签筛选文章
- 文章页 — Markdown 渲染、目录(TOC)、代码高亮、评论、版权与链接说明(CC BY-NC-SA 4.0)
- 关于博主 — 作者介绍(本页为「关于本站」)
- 友情链接 — 友链列表,终端风格展示
- 类库导航 — 按分类整理的前端文档与资源链接
- 短链接 —
/s/{slug}访问,后台可新增、管理,跳转到目标 URL - 评论 — 文章与页面支持评论,lowdb 存储,后台可审核、删除
- 搜索 — 弹窗内关键词搜索,结果与列表风格一致
- 后台 —
/admin管理评论、短链接、站点配置、内容数据,Token 登录 - 返回顶部 — 滚动后显示「$ cd top」按钮,平滑滚动
界面与风格
- 终端 / 代码风 — 导航与列表使用
$、#、export、路径等符号,整体像在「读代码」 - 字体 — 等宽字体(
--font-mono)用于导航、列表、代码块与提示文案 - 配色 — 基于
oklch()与--hue的配色,亮 / 暗模式与色相可调 - 动效 — 列表与卡片使用
fade-in-up等入场动画,链接与按钮有 hover / active 过渡,支持prefers-reduced-motion降级 - 响应式 — 移动端导航折叠、侧栏下移,阅读与点击区域适配小屏
版权与说明
- 文章采用 CC BY-NC-SA 4.0 许可,转载需署名、非商用、相同方式共享。
- 本站基于 Astro 构建,感谢开源社区。
加载中...