想有个地方放长一点的东西,于是有了这个站。
用了什么
- 框架:Astro 7 —— 静态输出,打开就是 HTML,没有多余的 JS
- 主题:astro-koharu,Shoka 风格的排版,深色模式、目录、搜索都是现成的
- 部署:Vercel,推一次构建一次
目录长什么样
config/site.yaml 站点配置:名称、导航、社交、评论……
src/content/blog/ 文章,Markdown 放进来就是一篇
src/pages/about.md 关于页
src/pages/music.md 歌单页
public/img/ 头像与封面图写一篇新文章,只要在 src/content/blog/ 下建一个 .md:
---
title: 标题
link: url-用的短名
date: 2026-11-08 20:00:00
categories:
- 笔记
tags:
- 随便
---
正文。几个当时踩过的点
- 文章的分类要在
config/site.yaml的categoryMap里登记过,/categories/<英文名>才会生成 - 改了
site.yaml要重启 dev server,配置是构建期缓存的 - 评论默认关着,想开的话把
comment.provider改成giscus/twikoo之类的
最后
主题还带了写作室(/editor),不想开编辑器的时候可以直接在网页里写,导出的 Markdown 再放进 src/content/blog/。
就这样,能跑起来了。