> 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 ｜ 后台路径：主题设置 → 布局设置 → 文章卡片布局

首页、归档、分类、标签、搜索结果里的文章列表长什么样，都由这里决定。列表与网格是两套独立参数，切换布局时各自的设置会保留。

## 配置项

### 通用

| 选项     | 默认值 | 说明                                      |
| ------ | --- | --------------------------------------- |
| 默认布局   | 列表  | 列表：单列，封面在卡片侧边；网格：多列，封面在卡片顶部。访客可在显示设置中覆盖 |
| 简介显示行数 | 2   | 文章简介最多显示几行，0 表示不截断（0\~6）                |

### 列表设置

| 选项       | 默认值    | 说明                                                |
| -------- | ------ | ------------------------------------------------- |
| 列表模式封面位置 | 右侧     | 封面在卡片右侧或左侧                                        |
| 列表封面比例   | 撑满卡片高度 | 撑满：封面与卡片等高；固定 16:9：内容列满宽时封面撑满，屏幕变窄后按 16:9 显示并垂直居中 |

### 网格设置

| 选项      | 默认值 | 说明                                                          |
| ------- | --- | ----------------------------------------------------------- |
| 瀑布流     | 关闭  | 卡片高度参差不齐、错落排列，适合有图无图混排                                      |
| 封面贴边    | 关闭  | 开启后封面撑满卡片顶部（仅上两角圆角）；关闭则内缩、四角圆角                              |
| 封面高度自适应 | 开启  | 开启后封面拉伸填满剩余高度，同排卡片封面等高；关闭则固定 2:1 高度，摘要下方留白。仅等高网格生效，瀑布流下自动隐藏 |

## 推荐配法

**图文博客**：列表布局 + 封面在右 + 撑满高度。视觉重心在文字，封面作为辅助信息，长标题也不会挤压图片。

**作品 / 摄影向**：网格布局 + 关闭「封面贴边」+ 关闭「封面高度自适应」。卡片留白更规整，封面统一 2:1。

**长短内容混排**：网格 + 瀑布流。短文章不会留下大片空白，但同排卡片不再等高，属于有意为之的错落感。

**纯文字站**：列表布局 + 封面位置左侧，配合较小的封面比例，让标题与摘要占主导。

## 注意事项

- 访客在「显示设置 → 外观」里切换列表 / 网格后，会覆盖后台默认布局；访客也可以单独切换瀑布流
- 「封面高度自适应」只在**等高网格**下生效，开启瀑布流后该选项隐藏（瀑布流本身高度就不固定）
- 「固定 16:9」是响应式行为：内容列足够宽时仍会撑满卡片，只有屏幕变窄后才切成 16:9，这不是配置错误
- 简介行数为 0 时不再截断，超长摘要会影响首屏高度，建议配合摘要长度控制
- 卡片边框、跟随主题色等视觉开关在「样式设置 → 样式开关」，访客也可在「外观」标签页调整
