一个写给自己看、也欢迎你路过的技术博客。
线上: https://kyjcaster.github.io/Kairos_blog/
- Next.js 16 + React 19（App Router，
output: 'export'静态导出） - TypeScript 5
- Tailwind CSS 4
- 内容：Markdown / MDX + gray-matter（
next-mdx-remote/rsc渲染） - 代码高亮：Shiki（dual-theme，构建期完成）
- 站内搜索：Fuse.js（构建期生成
public/search-index.json，聚焦时懒加载）
部署在 GitHub Pages，base path 为 /Kairos_blog。
在 content/posts/ 里新建一个 Markdown 文件，比如 my-first-post.md：
---
title: "我的第一篇文章"
date: "2026-06-10"
tags: ["随笔"]
excerpt: "可选；不写的话会从正文自动截取。"
cover: "/Kairos_blog/cover.jpg" # 可选
published: true
---
# 正文从这里开始
随便写。代码块会自动高亮。published: false 的文章不会出现在列表里。slug 不写时使用文件名。
npm install
npm run dev # http://localhost:3000/Kairos_blog
npm run build # 输出到 ./dist
npm run lintsrc/
├── app/
│ ├── layout.tsx # 全局布局 + 字体注入
│ ├── page.tsx # 首页
│ ├── sections/ # 首页各区块（Hero / LatestPosts / AboutPreview）
│ ├── blog/page.tsx # 文章列表 + 客户端搜索
│ ├── blog/[slug]/page.tsx # 文章正文 + TOC + 进度条 + 上下篇 + 相关
│ ├── tags/page.tsx # 标签云
│ ├── tags/[slug]/page.tsx # 单标签归档
│ ├── about/page.tsx # 关于
│ ├── sitemap.ts # 自动生成 sitemap.xml
│ ├── robots.ts # 自动生成 robots.txt
│ ├── rss.xml/route.ts # RSS feed（含全文 content:encoded）
│ ├── error.tsx # 运行时错误页
│ ├── not-found.tsx # 404
│ └── globals.css # 设计系统
├── components/
│ ├── mdx/ # MDX 作者面向组件（Callout / Aside / Figure）
│ └── ... # 其他复用 UI
└── lib/
├── site.ts # 站点元信息（域名、作者等）
├── posts.ts # 读 content/posts
├── markdown.ts # Shiki + next-mdx-remote/rsc
└── reading-time.ts # CJK 友好的字数与阅读时长
content/posts/ # 文章 Markdown / MDX
scripts/build-search-index.mjs # prebuild 期生成搜索语料
| 用途 | 字体 | 颜色基调 |
|---|---|---|
| 大标题 | Fraunces (serif) | — |
| 正文 | Inter | #1F1B16 on #FAF7F2 |
| 等宽 / 标签 | JetBrains Mono | — |
| 强调 | — | 红陶橙 #C2410C |
所有颜色通过 CSS 变量定义，深色模式由 next-themes 切换 <html class="dark">。
MIT