
这个站点是怎么搭起来的
站点很轻:没有数据库,没有后端,构建出来就是一堆静态文件。
骨架
主框架是 Astro。页面用 .astro 写,默认零 JS;真正需要交互的地方才挂 React 岛屿。
页面结构就四个:
| 路径 | 内容 |
|---|---|
/ |
首页,全屏背景 + 头像 |
/blog |
文章列表,带搜索、标签和归档 |
/shows |
项目作品与展示 |
/friends |
友链 |
内容用 Markdown 管
src/content.config.ts 里声明集合,Markdown 丢进对应目录就能被识别:
const blog = defineCollection({
loader: glob({ pattern: '**/*.md', base: './src/content/blog' }),
schema: z.object({
title: z.string(),
description: z.string().optional().default(''),
date: z.coerce.date(),
tags: z.array(z.string()).default([]),
draft: z.boolean().default(false),
}),
})
draft: true 的文章不会出现在列表里。frontmatter 写错字段名,构建会直接报错,而不是悄悄渲染出一个空标题——这是内容集合比手写 Markdown 解析值钱的地方。
搜索是唯一的交互
列表页的搜索、标签筛选、按月归档都在客户端完成。整个列表序列化后交给 Fuse.js 建索引,输入即过滤,不需要请求。
数据量小的时候,这比做一套搜索接口简单得多。
背景视频
首页那段循环没有用视频控件,而是自己算透明度:
- 开头 0.5 秒淡入;
- 结束前 0.5 秒淡出;
ended事件里把currentTime归零再play()。
靠 requestAnimationFrame 读 currentTime,比 CSS 动画更可控,也不依赖视频是否支持无缝循环。
一点取舍
装了 Tailwind 的 Vite 插件,但页面其实主要用原生 CSS 和变量。规模还小的时候,手写样式表反而更好改——等页面多到需要复用一整套间距和颜色,再迁移也不迟。