这个博客是怎么搭起来的

发布于 2026-11-08 14:00 274 字 2 min read 手写 每个字都是我自己敲的。

若竹時雨Shigure avatar

若竹時雨Shigure

若竹時雨的博客,记录幻想、音乐与代码的日常。

Astro 7 + astro-koharu 主题,内容用 Markdown 写,最后部署到 Vercel。

想有个地方放长一点的东西,于是有了这个站。

用了什么

  • 框架: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/。

就这样,能跑起来了。

执笔 手写

随机文章

© 2026 若竹時雨Shigure @Shigure
Powered by theme astro-koharu · Inspired by Shoka
加载中...