主题友链物理头像池修改记录

博客友链页已改为 Matter.js 物理头像池。本文只记录最终版本需要维护的文件，以及安装和恢复方法。

涉及文件

新增：

1 2	themes/flatpaper/source/js/friend-physics.js themes/flatpaper/source/css/_partials/_components/friends-physics.styl

替换：

1	themes/flatpaper/layout/link.ejs

修改：

1 2	themes/flatpaper/source/css/style.styl _config.flatpaper.yml

友链内容仍由以下文件维护：

1 2	source/_data/links.yml source/links/index.md

安装

将最终包中的文件按原目录覆盖到博客根目录。

确认 themes/flatpaper/source/css/style.styl 中存在：

1	@import '_partials/_components/friends-physics'

建议放在原友链组件样式附近。

然后执行：

1
2
3

pnpm clean
pnpm build
pnpm run server

访问：

1	http://localhost:4000/links/

维护友链

友链数据继续写在：

1	source/_data/links.yml

格式：

- class_name: 朋友们
  class_desc: 那些仍在认真记录与分享的人。
  link_list:
    - name: 示例站点
      link: https://example.com/
      avatar: https://example.com/avatar.png
      descr: 站点简介
      rss: https://example.com/atom.xml

新增、修改或删除友链时，只需要维护这个文件。

页面下方的友链申请说明位于：

1	source/links/index.md

检查

更新主题或修改代码后检查：

头像能正常加载、下落和碰撞
头像可以拖动和点击
鼠标位于物理容器内时页面仍可滚动
鼠标移出容器后松开不会继续拖动
头像不会被甩出容器
亮色和暗色模式显示正常
手机端可以正常纵向滑动页面

主题升级后，重点确认以下文件没有被覆盖：

1
2
3

themes/flatpaper/layout/link.ejs
themes/flatpaper/source/js/friend-physics.js
themes/flatpaper/source/css/_partials/_components/friends-physics.styl

同时检查 style.styl 中的物理友链样式导入仍然存在。

恢复原版友链

最终包的 restore 目录中已经附带原版 link.ejs，恢复时不依赖以前是否做过备份。

1. 恢复原版模板

将：

1	restore/original/themes/flatpaper/layout/link.ejs

复制并覆盖到：

1	themes/flatpaper/layout/link.ejs

2. 删除物理友链文件

删除：

1 2	themes/flatpaper/source/js/friend-physics.js themes/flatpaper/source/css/_partials/_components/friends-physics.styl

3. 移除样式导入

打开：

1	themes/flatpaper/source/css/style.styl

删除：

1	@import '_partials/_components/friends-physics'

不要删除原主题自带的：

1 2	@import '_partials/_components/friends' @import '_partials/_components/friends-feed'

4. 移除物理友链配置

打开：

1	_config.flatpaper.yml

只删除 links 下新增的 physics 配置块。

不要删除原主题中其他 links 配置。删除后如果只剩下一个空的 links:，再将这个空字段一起删除。

5. 重新生成

执行：

1
2
3

pnpm clean
pnpm build
pnpm run server

打开友链页并强制刷新。页面重新显示原版静态友链卡片，即表示恢复完成。