你好,Shaggy Singularity
这是一篇置顶的示例文章,用来展示这个 Astro 博客主题的排版、目录、阅读进度与深浅色切换能力。
欢迎来到 Shaggy Singularity —— 一个追求极简、专注阅读的 Astro 博客主题。它没有花哨的动效,没有臃肿的依赖,只保留写作与阅读最需要的东西。
这个主题有什么
主题开箱即用,但每个细节都可以按你的喜好调整:
- 内容集合驱动:文章通过
src/content/post下的 Markdown 文件管理,frontmatter 支持标签、封面、置顶、草稿等字段 - 原生性能:没有引入任何前端框架,页面体积以 KB 计
- 极简排版:衬线标题 + 无衬线正文,中西文混排都舒服
- 阅读体验:阅读进度条、侧边目录、深色模式、预估阅读时长
好博客的核心不是功能多,而是让人愿意把一篇文章读完。
怎么开始写文章
在 src/content/post/ 下新建一个 Markdown 文件即可:
---
title: '我的第一篇文章'
description: '一段简短的描述'
pubDate: 2026-09-01
tags: ['随笔']
---
这里是正文。保存后,开发服务器会自动热更新,文章会出现在首页列表、归档和标签页中。
自定义站点信息
站点标题、导航、社交链接都集中在 src/consts.ts 里:
| 配置 | 说明 |
|---|---|
SITE.title | 站点名称,显示在页头与页脚 |
SITE.url | 部署后的站点地址,用于 RSS 与 SEO |
NAV | 顶部导航项,增删改都在这 |
SOCIAL | 页脚社交链接 |
改完配置,再换上 public/favicon.svg 和你的头像,博客就真正属于你了。
深色模式
主题默认跟随系统偏好,也可以点击页头右上角的月亮/太阳图标手动切换,选择会被记住。
就这样,少即是多。祝写作愉快。