这是一个静态个人小站,用来收纳个人介绍、工具箱、相册、博客入口和一些页面实验。站点可以直接通过 GitHub Pages 托管。
index.html:主页入口。assets/:字体、图片等可复用静态资源。about/:关于页。blog/:博客列表页和构建生成的文章详情页。content/posts/:Markdown 博客源文件。scripts/build-blog.mjs:静态博客构建脚本。data/posts.json:构建生成的文章索引数据。tool/:工具箱,包含 Base64、进制转换、时间戳转换、随机图片和翻页时钟。gallery/:相册入口,当前连接到gallery/r18/的 3D 相册。Better_Alist/:底部跳动鱼效果相关脚本资源。css/site.css:全站背景和鱼容器等公共样式。assets/fonts/TeyvatBlack-Regular.woff2:首页英文欢迎语使用的特殊字体。
- 页面样式优先使用 TailwindCSS。
- 子页面应保留右上角导航,并使用与首页一致的背景和底部跳动鱼效果。
- 全站导航会通过
js/site.js自动加入夜间模式开关,并记住用户选择。 - 新增或修改功能后,同步更新本文件。
- 新增较大功能前,先在
plan.md中补充实现计划。
在 content/posts/ 目录下新增 .md 文件,并在文件顶部写入元数据:
---
title: 文章标题
date: 2026-06-18
tags: [标签一, 标签二]
cover: /assets/blog/covers/example.jpg
summary: 文章摘要。
---
这里写 Markdown 正文。cover 可省略。写完后在仓库根目录运行:
node scripts/build-blog.mjs脚本会生成 blog/index.html、blog/posts/*.html 和 data/posts.json。博客首页使用瀑布流卡片展示文章。
这是纯静态站点,可以直接打开 index.html。如果需要模拟 GitHub Pages 的根路径行为,建议在仓库根目录启动一个静态服务后访问:
python -m http.server 8000然后打开 http://127.0.0.1:8000/。