本站的书签页（/links/）通过 source/_data/link.yml 文件管理。

一、书签数据文件

所有书签数据存放在：

1
source/_data/link.yml

用任意编辑器（VS Code、Typora、记事本）打开即可编辑。

二、文件结构

文件按「分类」组织，每个分类下有多个书签，每个书签 4 个字段：

1
2
3
4
5
6
7
- class_name: 开发工具          # 分类名（顶格，0 空格）
  class_desc: 常用开发工具与平台  # 分类描述（2 空格）
  link_list:                    # 书签列表（2 空格）
    - name: GitHub              # 书签名（4 空格）
      link: https://github.com       # 网址（6 空格）
      avatar: https://github.com/favicon.ico  # 图标（6 空格）
      descr: 全球最大代码托管平台      # 描述（6 空格）

三、添加书签到已有分类

在对应分类的 link_list 下，照着已有书签的格式复制一条，改成要添加的网站信息即可。例如在「开发工具」分类末尾加一个新网站：

1
2
3
4
- name: 新网站名
  link: https://新网站.com
  avatar: https://新网站.com/favicon.ico
  descr: 一句话描述

注意 name 前面是 4 个空格，link/avatar/descr 前面是 6 个空格，和同分类下其他书签对齐。

四、新建分类

在文件末尾追加一整组，class_name 顶格写，和文件里已有的分类对齐：

1
2
3
4
5
6
7
8
9
10
11
- class_name: 设计灵感
  class_desc: 设计资源与灵感
  link_list:
    - name: Dribbble
      link: https://dribbble.com
      avatar: https://dribbble.com/favicon.ico
      descr: 设计师作品分享
    - name: Behance
      link: https://behance.net
      avatar: https://behance.net/favicon.ico
      descr: 创意作品社区

新分类前面留一个空行和上个分类隔开。

五、缩进规则（重要）

YAML 对缩进敏感，必须用空格，不能用 Tab：

层级 内容 缩进
1 class_name 0 空格（顶格）
2 class_desc / link_list 2 空格
3 name 4 空格
4 link / avatar / descr 6 空格

六、图标自动获取

avatar 字段填网站自己的 favicon，格式固定：

1
https://网站域名/favicon.ico

例如：

  • GitHub → https://github.com/favicon.ico
  • 掘金 → https://juejin.cn/favicon.ico

不用手动下载图标，浏览器会自动加载网站图标。

七、删除书签

找到对应书签的 4 行（name/link/avatar/descr），整段删除即可。注意不要破坏周围书签的缩进。

八、部署上线

改完 link.yml 后，执行：

1
hexo clean && hexo g && hexo d

等 30 秒 ~ 2 分钟，访问 https://zenty-me.github.io/links/ 即可看到更新。

GitHub Pages 有 CDN 缓存，如果看到的还是旧内容，Ctrl+F5 强刷或等 1-2 分钟。

九、完整示例

包含两个分类的完整 link.yml：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
- class_name: 开发工具
  class_desc: 常用开发工具与平台
  link_list:
    - name: GitHub
      link: https://github.com
      avatar: https://github.com/favicon.ico
      descr: 全球最大代码托管平台
    - name: VS Code
      link: https://code.visualstudio.com
      avatar: https://code.visualstudio.com/favicon.ico
      descr: 代码编辑器

- class_name: 效率工具
  class_desc: 日常使用的工具
  link_list:
    - name: Typora
      link: https://typora.io
      avatar: https://typora.io/favicon.ico
      descr: Markdown 编辑器