$ 轻盈的鱼

$ cat about.md

关于本站

本站是一个基于 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 构建,感谢开源社区。
# 评论

加载中...

$ cd top