这个博客是怎么搭起来的:开源模型怎么选、浮岛和瀑布怎么用代码造出来,以及部署到 GitHub Pages 时要注意的几件事。
首页那座浮空庄园其实是个站内导航:城堡对应归档,缮写室放技术笔记,工坊放项目手记,旅店是随笔,集市按标签索引,信鸦塔里是关于页。下面记一下这个站是怎么搭的。
站点骨架
静态页面用 Astro 生成。文章放在 src/content/posts/ 下,每篇 Markdown 开头带一段 frontmatter:
---
title: 文章标题
description: 一句话摘要,会出现在列表和 RSS 里
date: 2026-11-05
category: tech # tech / projects / essays 三选一
tags: [ROS2, SLAM]
draft: false # true 时只在本地预览里出现
---
Astro 构建时会检查这些字段,分类写错或者漏了日期会直接报错退出。
庄园的模型
建筑、地块和树木用的都是 Kay Lousberg 的 KayKit Medieval Hexagon Pack(CC0 协议)。原包有 200 多个 glTF 模型,我只挑了用得上的 50 个左右,用 glTF Transform 合并成单文件再做 meshopt 压缩,最后不到 1 MB。
原包配色很亮,看着像玩具,我在着色器里加了一步调色,压低饱和度再往暖色偏一点,跟羊皮纸底色放一起才协调。
其余几样没有找现成模型,都是代码直接画的。浮岛底下的岩石用几圈带随机扰动的多边形一层层往尖里收;瀑布是一张弯折的平面,片元着色器里叠两层噪声做出往下流的水纹;城堡顶上的燕尾旗是张网格,每帧拿正弦波推顶点,旗面上的「何」字用 Canvas 画好贴上去。绕着城堡飞的渡鸦就是一个圆锥身体加两片三角形翅膀,关于页的火漆印则是先在 Canvas 上画出印面当高度图,再把圆盘中间压出浮雕。
白天与夜晚
右上角的按钮可以切换昼夜。切到夜晚后,光照换成冷色月光,窗户亮起暖色的灯,地面飘着萤火虫。几组光照参数是在一秒左右里渐变过去的。
部署到 GitHub Pages
博客放在 Blog 仓库里,地址是 leonhart999.github.io/Blog/。因为不在根路径,所有链接都得带上 /Blog 前缀,所以 astro.config.mjs 里配了 base: '/Blog',页面里的链接统一经过 url() 函数拼接。要是直接写死 /archive/ 这种绝对路径,上线后就会 404。
推送到 main 分支后,GitHub Actions 会自动构建并发布,不用手动上传 dist。
还想做的
评论打算接 giscus,直接存在仓库的 Discussions 里;文章多起来以后再考虑加 Pagefind 做站内搜索,它构建时就能生成索引,不用搭服务器。
封缄于 2026 年 11 月 5 日