最小的资源帖

只要在 front-matter 里加 resource 字段，普通文章就变成资源帖：

1
2
3
4
5
6
7
8
9
10
---
title: 某某电影 4K 蓝光原盘
date: 2026-10-02 14:00:00
categories:
  - 影视资源
cover: /images/covers/movie.svg
resource:
  enable: true
  type: movie
---

type 的取值由站点 _config.yml 里 resources.types 的 key 决定，
常见的有 movie / game / mod / translation / software / other。

完整字段

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
---
title: 演示：游戏 MOD《示例模组》v3.1.4
date: 2026-10-04 15:20:00
categories:
  - 游戏MOD
tags:
  - MOD
  - 玩法扩展
description: MOD 类资源演示，展示多版本、多网盘链接的呈现。
cover: /images/covers/mod.svg
resource:
  enable: true
  type: mod
  version: v3.1.4
  platform: Windows
  size: 1.8 GB
  language: 简体中文
  updated: 2026-10-04
  links:
    - name: 蓝奏云
      url: https://wwi.lanzouq.com/example-mod
      password: echo
      size: 1.8 GB
      note: 不限速
    - name: 百度网盘
      url: https://pan.baidu.com/s/example-mod
      password: 1234
      size: 1.8 GB
---

字段说明：

字段 必填 说明
enable 是 设为 true 才会进入资源库
type 是 资源类型，对应 resources.types 的 key
version 否 版本号，显示在卡片和详情表格里
platform 否 适用平台，如 Windows / Android / 全平台
size 否 文件大小
language 否 语言，如 简体中文 / 多语言
updated 否 资源更新日期，会显示在封面右上角
links 否 网盘链接数组，详见下节

网盘链接

links 是一个数组，每一项就是一张网盘卡片：

1
2
3
4
5
6
7
8
9
10
11
links:
  - name: 百度网盘
    url: https://pan.baidu.com/s/xxxx
    password: abcd
    size: 42.6 GB
    note: 需要客户端
  - name: 夸克网盘
    url: https://pan.quark.cn/s/xxxx
    password: ''
    size: 42.6 GB
    note: 在线解压
字段 说明
name 网盘名称，同时用于匹配配色
url 分享链接
password 提取码，留空则不显示复制按钮
size 该网盘内的文件大小（可与资源总大小不同）
note 备注，如「不限速」「需客户端」

几个实用技巧：

  • 多版本：同一资源的多个版本，建议每篇一个版本，用 version 区分，方便单独更新链接。
  • 多网盘：同一版本放多个网盘，全部写进 links，访客可以自己选。
  • 失效链接：直接把对应条目删掉重新发布即可，不用改正文。

网盘配色

每个网盘卡片会按名称自动取色。内置了这些：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
resource:
  pan_colors:
    百度网盘: '#2932e1'
    阿里云盘: '#ff6a00'
    夸克网盘: '#2f7dff'
    天翼云盘: '#0090ff'
    123云盘: '#1677ff'
    迅雷云盘: '#2f6bff'
    蓝奏云: '#3ba0ff'
    微云: '#12b7f5'
    奶牛快传: '#ffb02e'
    Google Drive: '#34a853'
    OneDrive: '#0f6cbd'
    Mega: '#d9272e'
    磁力链接: '#7a5cff'
    BT 种子: '#f59e0b'

要加新网盘，直接补一行；名称要和 links[].name 完全一致（包括空格）。
没匹配到的网盘会使用主题主色。

资源卡片显示哪些字段

1
2
3
4
5
6
resource:
  show_fields:
    - version
    - platform
    - size
    - language
  • 可用字段只有这四个，顺序即卡片上的展示顺序。
  • 字段的中文名（版本 / 平台 / 大小 / 语言）由主题内置映射，
    想改名要改 scripts/helper.js 里的 RESOURCE_FIELD_LABELS。
  • 卡片上最多显示 3 个（写死的，避免卡片高度参差），多余的折叠掉；
    详情页不受此限制，配置的字段 + 「更新日期」都会展示。
  • 字段值留空时自动跳过，四个都没写则显示一个「资源 / 查看详情」的占位。

字段映射与过滤逻辑统一在 helper.js 的 echo_resource_fields helper 里，
三处模板（资源卡片、详情页摘要、普通卡片）共用同一份实现。

版权提示与密码显示

1
2
3
resource:
  show_password: true
  notice: '资源仅供学习交流，请在下载后 24 小时内删除。'
  • show_password: false 可以全局隐藏提取码（如果你用其它方式发放），
    隐藏时显示为 ••••，但复制按钮仍然可用。
  • notice 显示在下载区块上方，留空则不显示。

资源详情页的结构

一篇资源帖从上到下依次是：

  1. 字数 / 阅读时间 / 资源类型标签
  2. 标题与分类、标签、日期
  3. 简介（取 description 或摘要）
  4. 字段表格：版本 / 平台 / 大小 / 语言 / 更新日期
  5. 正文（安装方法、注意事项等）
  6. 下载区块：网盘卡片列表 + 提取码复制按钮
  7. 版权提示、上一篇 / 下一篇

正文里不需要再手写「版本：v3.1.4」这类信息，交给字段就好。

图标清单

resources.types[].icon 和 Hero 按钮的 icon 都从这个内置集合里取值：

图标 适用
film 影视
gamepad 游戏
puzzle MOD
language 汉化 / 多语言
app 软件工具
box 其它 / 通用
layers 资源库
archive 归档
tag / folder 标签 / 分类
download 下载
clock / calendar 时间 / 日期
file-text 文章
trending-up 统计
fire 热门
list 目录

填错名字不会报错，会回退成通用的盒子图标。

下一篇

下一篇讲写作：front-matter 全部字段、代码块、目录、摘要与封面。