> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# 文章页

> 适用版本 ≥ 2.0.0 ｜ 后台路径：主题设置 → 文章

决定文章正文长什么样：封面、目录、摘要、版权，以及文末的点赞 / 分享 / 打赏操作栏。

## 配置项

### 内容显示

| 选项    | 默认值        | 说明                                            |
| ----- | ---------- | --------------------------------------------- |
| 显示封面图 | 开启         | 关闭后文章页不再重复显示封面，列表 / 卡片仍正常显示                   |
| 字体大小  | prose-base | prose-sm / base / lg / xl / 2xl，影响正文排版密度      |
| 颜色主题  | prose-gray | gray / slate / zinc / neutral / stone，正文的灰阶倾向 |

### 目录

| 选项     | 默认值  | 说明                            |
| ------ | ---- | ----------------------------- |
| 启用目录   | 开启   | 关闭后文章页不生成目录                   |
| 目录位置   | 右侧边栏 | 右侧 / 左侧，**仅三栏布局生效**；两栏仍使用悬浮目录 |
| 目录最大深度 | 2    | 收录到几级标题，默认 h2                 |

### 文章摘要

| 选项     | 默认值   | 说明         |
| ------ | ----- | ---------- |
| 启用文章摘要 | 开启    | 在封面下方显示摘要框 |
| 摘要标题   | 文章摘要  | 留空则不显示标题   |
| 摘要文字动效 | 打字机效果 | 打字机 / 文字下坠 |

### 版权声明

| 选项 | 默认值             | 说明        |
| -- | --------------- | --------- |
| 启用 | 关闭              | 在文末显示版权卡片 |
| 名称 | CC BY-NC-SA 4.0 | 协议名称      |
| 链接 | CC 协议地址         | 点击跳转      |

### 文章操作栏

| 选项      | 默认值 | 说明                  |
| ------- | --- | ------------------- |
| 启用文章操作栏 | 开启  | 在版权声明上方显示点赞、分享、打赏卡片 |
| 启用点赞    | 开启  | 关闭后图标仅展示、不可点击       |
| 启用分享    | 开启  | 点击生成分享海报            |
| 启用打赏    | 开启  | 点击弹出微信 / 支付宝收款码     |

打赏设置子组：

| 选项         | 默认值                   | 说明             |
| ---------- | --------------------- | -------------- |
| 打赏文案       | 如果这篇文章对你有帮助，可以请我喝杯咖啡！ | 弹窗顶部文案         |
| 微信收款码      | 空                     | 建议 1:1 正方形     |
| 支付宝收款码     | 空                     | 建议 1:1 正方形     |
| 显示「打赏页面」按钮 | 关闭                    | 弹窗底部显示跳转按钮     |
| 打赏页面路径     | `/reward`             | 需先在「页面」中创建对应页面 |

## 推荐配法

**技术博客**：目录开启、位置右侧、深度 2；摘要开启、打字机效果；版权开启 CC BY-NC-SA；操作栏三项全开，打赏只放微信码。

**轻阅读**：关闭摘要与版权，目录深度 2 放左侧，操作栏只保留分享。文章底部更干净。

**多作者 / 转载站**：版权声明必开，名称和链接指向你的协议页；摘要开启，避免首屏只有封面。

## 注意事项

- **目录位置只在三栏布局下有效**：两栏布局统一使用悬浮目录，改这里不会移动位置
- 目录所在栏在文章页**只保留前 2 个吸顶小组件**，其余吸顶组件在该页隐藏，给目录留空间
- 目录为空通常是因为正文没有 h2 / h3，或「最大深度」设得过浅
- 摘要内容来自文章后台填写的摘要字段，没填写时摘要框可能为空
- 关闭「显示封面图」不会影响社交分享时使用的封面
- 分享海报由前端绘制，封面 / 头像跨域会导致生成失败，建议使用同域图片或配置 CORS
- 打赏页面的按钮依赖页面真实存在，路径要与创建页面时一致