Skip to content

友链管理

控制“朋友们”页面的链接展示,支持多语言分组与随机排列。

数据文件位置

在你的站点目录下创建: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"
  # 可选,用于“当前语言优先”分组 + 卡片语言标签。

关键特性

  • 多语言适配namedescription 可以是简单的字符串,也可以是按语言代码区分的地图(Map)。
  • 随机排列:为了公平起见,友链顺序会在站点生成时被随机打乱(例如本地重新构建、部署时重新生成)。静态站点部署后,读者单纯刷新页面通常不会改变顺序。
  • 当前语言优先:如果友链标记的 language 包含当前站点的语言,它会被放入“优先展示”组。