友链管理
控制“朋友们”页面的链接展示,支持多语言分组与随机排列。
数据文件位置
在你的站点目录下创建:data/friends.yaml (也可以是 .toml 或 .json)。
数据格式示例
yaml
- name:
zh-Hans: "我的站点"
en-US: "My Site"
default: "My Site" # 可选,缺失当前语言时的兜底
description:
zh-Hans: "你好"
en-US: "Hello"
url: "https://example.com"
avatar: "https://example.com/avatar.png"
# 可选,用于“当前语言优先”分组 + 卡片语言标签。
language: ["zh-Hans", "en-US"]
# 如果不需要 i18n
- name: "我的站点"
description: "你好"
url: "https://example.com"
avatar: "https://example.com/avatar.png"
# 可选,用于“当前语言优先”分组 + 卡片语言标签。关键特性
- 多语言适配:
name和description可以是简单的字符串,也可以是按语言代码区分的地图(Map)。 - 随机排列:为了公平起见,友链顺序会在站点生成时被随机打乱(例如本地重新构建、部署时重新生成)。静态站点部署后,读者单纯刷新页面通常不会改变顺序。
- 当前语言优先:如果友链标记的
language包含当前站点的语言,它会被放入“优先展示”组。