友情链接 (Friends) 添加与管理

早期的个人网站之所以充满生命力，很大程度上得益于博主之间真诚交换「友情链接」。一个个互相关联的独立站点，共同织成了一张去中心化的中文互联网知识网络。同时，相互引用，也有利于搜索引擎尤其是谷歌，对个人站点 PR 值的提升。

在 RustPress 中，维护友链不再是手写一串混乱的 HTML 链接列表。系统提供了结构化的 友情链接模型（Friends），以自适应卡片网格呈现，支持自定义头像、权重排序与站点说明。

一、友链目录规范

所有友情链接存放在 source/friends/ 目录下：

source/friends/
├── README.md                 # 友链总览主页与申请规范（必须）
├── assets/                   # 友链专属头像与 Logo
│   ├── tvp.ico
│   ├── rust-lang_logo.png
│   └── friend-avatar.jpg
├── 1.md                      # 单个友链定义
├── 2.md
└── 3.md

二、单条友链 Markdown 格式规范

在 source/friends/ 下新建一个 Markdown 文件（如 1.md），填入 Frontmatter：

---
title: "腾讯云最具价值专家 (TVP)"
slug: "tvp"
link: "https://cloud.tencent.com/tvp"
description: "腾讯云最具价值专家计划，汇聚行业顶尖技术精英与布道者。"
avatar: "assets/tvp.ico"
domain: "cloud.tencent.com"
weight: 1
layout: friend
createTime: 2025-11-05 08:00:00
---

属性字段速查清单

• title（String · 必填）
  • 友链网站名称或博主昵称。
• link（String · 必填）
  • 目标跳转 URL。
• description（String · 可选）
  • 站点一句话简述（展示于卡片下方）。
• avatar（String · 可选）
  • 头像路径，可为 assets/ 相对路径或外部 URL。
• domain（String · 可选）
  • 友链域名标识。
• weight（Integer · 可选）
  • 排序权重，数字越小排在越前面。
• layout（String · 必填）
  • 固定指定为 friend。

三、友链总览与申请说明（README.md）

source/friends/README.md 是友链页面的头部说明，在这里写明本站信息与互换友链的要求：

---
title: "友情链接"
layout: friends
description: "海内存知己，天涯若比邻，欢迎志同道合的博主交换友链。"
createTime: 2025-11-05 08:00:00
---

# 友情链接

欢迎来到艺述论的友情链接页面！这里收录了优秀的开源项目、技术社区与同行好友。

## 友链申请规范

如果希望与本站互换友链，请确保贵站满足：
1. 原创技术内容为主，保持更新；
2. 网站支持 HTTPS 访问，无恶意广告；
3. 请先在贵站添加本站链接后，在本页下方留言或发邮件联系。

### 本站信息
- **名称**：艺述论
- **网址**：`https://yishulun.com`
- **简介**：一花一世界，一树一菩提。
- **头像**：`https://yishulun.com/static/images/avatar.png`

四、前端呈现效果

构建完成后，访问 /f/ 页面：

• 顶部展示 README.md 的申请说明与本站档案；
• 下方以卡片网格渲染所有友链（圆形头像、网站名、描述与外链跳转）；
• 底部自动挂载原生评论区，同行访客可以直接在下方提交申请。

下一篇，我们来看如何配置「个人著作展示（Works）」，管理出版的书籍和课程。