这个站点是怎么搭起来的

这个站点是怎么搭起来的

站点很轻:没有数据库,没有后端,构建出来就是一堆静态文件。

骨架

主框架是 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 和变量。规模还小的时候,手写样式表反而更好改——等页面多到需要复用一整套间距和颜色,再迁移也不迟。

← 返回博客列表