配置文档导航与分类展示模块

08 页面构建器 / 08.02 模块与展示

准备内容并选择模块

先在后台准备好已发布文档、文档分类及父子层级。使用有构建器编辑和保存权限的账号，打开目标网站的文档首页、文档归档或文档详情模板，再添加需要的模块。

文档列表展示文档，文档菜单组织文档分类，正文目录用于跳转到本页标题，链接导航展示收录的链接。选择分类时要对应内容类型，不要把文章分类当作文档分类。

配置文档列表

选中文档列表，进入「内容设置」，先确定内容范围，再调整排序和外观。

设置	怎么使用
数据来源	选择「常规列表」或「当前内容相关」。相关文章式的文档推荐需要当前详情内容作为依据。
分类与自动归档	普通页面选择要展示的文档分类；归档页可根据当前页面取得对应内容。
指定文章 ID	常规列表提供此项。可用逗号分隔多个 ID，也可每行填写一个。这里应填写要展示的文档 ID。
列表样式	标准列表适合阅读目录，紧凑目录适合较密集的条目，卡片网格适合图文入口。
默认排序	选择发布时间、更新时间或标题。
排序方向	可单独选择升序或降序。按更新时间降序可把最近更新的文档放在前面；按标题升序可按名称组织目录。
显示项	选择是否显示图标、摘要和附加信息，并检查分页导航或加载更多按钮是否开启。
数量和间距	调整每行数量、卡片内边距和间距，再检查窄屏下的排列。
加载方式	选择分页或加载更多；需要连续浏览时，再检查自动加载更多设置。

排序字段和排序方向是两个独立设置，不限于“最新发布、最近更新、标题升序”这三种固定组合。

配置分类菜单和正文目录

1. 添加文档菜单或对应内容类型的分类菜单，选择需要展示的分类。
2. 核对父子层级和顺序，再调整菜单类型、图标、数量、特色图片与间距。
3. 需要标题或更多入口时，填写顶部文案和更多链接，并测试实际跳转。
4. 需要菜单筛选同页列表时，填写目标列表模块 ID。不要把分类 ID 或正文模块 ID 填到这里。
5. 需要正文目录时，添加目录模块，填写同页正文模块 ID，并确保正文使用了二级、三级或四级标题。

分类菜单和正文目录关联的对象不同：前者控制列表，后者读取正文标题。改变菜单样式不会创建分类，也不会给正文补上标题。

配置链接导航

设置	怎么使用
布局	选择站点网格、紧凑列表或导航卡片，再配置列表标题、展示项、更多按钮和背景。
内容范围	选择链接分类和标签；需要时使用当前归档条件。保存后检查筛选结果是否符合预期。
默认排序	选择热门或时间排序。使用热门排序时，同时检查热门天数。
数量与间距	设置每行上限、读取数量和卡片间距。
加载方式	选择分页或加载更多，再决定是否开启自动加载。
内页与外链	检查「打开内页」设置。导航卡片主体和直接访问按钮可能是两个入口，应分别点击验证。

核对文档入口和相邻文档

文档首页入口、文档分类菜单和上一篇／下一篇是不同设置。检查首页入口时，以当前网站保存的路径为准；已有的自定义路径不会因为更换模块样式而改变。

文档编辑设置中可分别选择上一篇和下一篇。复制文档或调整顺序后，重新核对这两个目标，避免继续指向不合适的文档。

保存后逐项验证

1. 打开实际文档页面，检查列表内容、排序和加载按钮。
2. 展开多级菜单，确认层级、顺序和链接都正确。
3. 点击分类菜单，确认变化的是同页指定列表。
4. 点击正文目录，确认能跳到本页对应标题。
5. 分别测试文档首页、上一篇、下一篇，以及导航卡片的内页和外链入口。
6. 切换网站语言，重新检查分类、文档归属、译文发布状态和实际跳转。

多语言页面出现原语言内容时，先检查分类翻译关联和菜单目标。手动填写的链接、手动选择的上一篇和下一篇都要单独核对，不能仅凭菜单名称已经翻译就认为目标也已切换。

列表或菜单可见，不代表其中所有内容都已向当前访客开放。存在访问限制时，还应使用普通访客账号检查实际阅读结果。