### [08.02.030 配置文档导航与分类展示模块](https://guaqi.com/docs/77638)

**Published:** 2026-09-11T02:30:33

**Author:** 二丿小青年

**Excerpt:** 一、这个功能能做什么 文档菜单、分类菜单与普通文章列表是不同模块。选择目标内容类型，再配置分类来源、层级和展示…

[08 页面构建器](/docs-archive/1264) / [08.02 模块与展示](/docs-archive/1266)

## 一、这个功能能做什么

文档菜单、分类菜单与普通文章列表是不同模块。选择目标内容类型，再配置分类来源、层级和展示；不要把文章分类当成文档分类使用。

### 文档和导航的具体展示选项

| 设置  | 功能与效果 |
| --- | --- |
| 文档列表三种布局 | 标准列表、紧凑目录、卡片网格，分别适合阅读列表、密集目录和图文入口 |
| 文档排序 | 按最新发布、最近更新或标题升序展示，适应持续更新或按名称查找的文档 |
| 文档显示内容 | 控制图标、摘要和附加信息，调整每行数量、内边距、间距及加载方式 |
| 文档内容范围 | 选择分类，或在适用归档页根据当前页面自动取得内容 |
| 正文目录 | 关联本页正文模块 ID，从二级、三级、四级标题生成目录 |
| 链接导航三种布局 | 站点网格、紧凑列表、导航卡片，配合列表标题、更多按钮和背景使用 |
| 导航筛选 | 链接分类和标签可组合筛选，同时设置热门或时间排序 |
| 导航数量与加载 | 调整每行上限、最多条数、卡片间距及适用触底加载 |
| 内页与直接访问 | 按导航样式和设置安排本站详情与外链入口；导航卡片的直接访问按钮与卡片主体是不同入口 |
| 分类菜单展示 | 选择适用菜单类型、图标、数量、特色图片与间距，设置顶部文案和更多链接 |
| 菜单联动 | 填写要筛选的列表模块 ID，让分类菜单控制同页指定列表 |

正文目录需要正文中有相应标题，菜单筛选需要关联同页正确的列表。改变菜单样式不会自动创建分类或文档。

## 二、设置后会有什么效果

可以把文档和分类组织成可浏览的菜单，帮助访客按层级查找。文档首页路径、文档分类和相邻文档链接各自配置。

## 三、怎么使用

文档详情应配合文档内容与导航模块，分类展示应配合对应归档页面。瓜奇文档首页默认链接是 `/doc`；已有站点保存的自定义值不会因为默认值调整而自动变更。

### 配置与验证

先准备已发布文档和正确的文档分类，再在构建器选中目标分类。检查父子层级、展开、排序和实际跳转，之后测试另一种语言。

分类翻译关联会影响目标语言下的数据查找。没有关联时存在兼容回退分支，不能承诺一定自动隐藏，也不能据此认为配置正确。应补齐目标语言分类与文档归属。

手动“上一篇／下一篇”保存的是文档选择关系，复制后需要核对目标链接是否仍指原语言。菜单翻译与文档手动相邻关系不能混为一谈。

## 四、常见问题

### 文档菜单为什么跳到原语言？

检查菜单目标、分类翻译关联和译文是否发布。固定粘贴的原文链接不会自动变成译文；手动上一篇和下一篇也要分别核对。



---