启用手动目录输出可让你通过模板函数、简码或区块放置目录。
当你希望把目录放入主题模板时，模板函数会很实用。
当你希望把目录放入内容区或简码区块时，简码会很实用。
当你希望在区块编辑器中以可视方式放置目录时，区块会很实用。

模板函数：

<?php if ( function_exists( 'airygen_the_toc' ) ) { airygen_the_toc(); } ?>

简码：

[airygen_toc]

区块：

<!-- wp:airygen/toc /-->

自动插入

启用自动目录插入会把目录自动插入符合条件的文章。
插入位置支持内容前与第一段之后。

区块标题

标题可决定目录是否显示可见标题。
标题文字字段可更改清单上方显示的文案。
标题层级字段可更改该标题使用的 HTML 标题层级。

范围

要包含的文章类型用来决定哪些内容类型符合目录输出资格。

结构

最少标题数会在文章标题数量不足时隐藏目录。
标题层级可让你决定目录要包含 H2、H3 与 H4。

行为

平滑滚动会在读者点击目录链接时加入平滑滚动效果。
添加编号会把清单改成编号式大纲。
加载时折叠会让目录在初始载入时保持折叠状态。

锚点

锚点前缀会为生成的标题 ID 加上前缀，避免与页面其他锚点冲突。
排除标题可让你用逗号分隔输入要跳过的标题文字。

布局分页

这个分页用来调整目录的视觉样式。

主题

雪板岩会套用中性的白色与石板灰风格。
蜂蜜纸会带来温暖的纸张风格。
天空微风会带来浅蓝色外观。
薄荷冷静会带来柔和的绿色外观。
玫瑰腮红会带来偏柔和的粉色外观。
薰衣草雾会带来淡紫色外观。

样式

标头控制项可调整标题容器的边框宽度、边框样式、圆角、边框颜色、内距、外距、背景色、标题颜色、标题字号与标题字体样式。
主体控制项可调整目录容器的边框宽度、边框样式、圆角、边框颜色、内距、外距与背景色。
链接控制项可调整目录链接颜色、字号，以及粗体、斜体或下划线样式。
列表控制项可调整目录清单使用的内部缩进。

预览分页

这个分页可让你在笔记本电脑、平板电脑与手机预览中检查目录效果。

预览刻意保持简洁。
启用中的主题仍可能影响最终前台输出。
页面也会显示生成的 HTML 与 CSS 示例。

编辑器面板

在区块编辑器中，目录面板可让你只为单篇文章控制这个功能，而不必改动全站默认值。

目录显示模式支持自动、手动与停用。
当模式为手动时，面板会显示插入目录按钮，让你插入区块或简码。

如何使用

打开 Airygen SEO -> 设置 -> 目录。
在设置分页中，决定要使用启用手动目录输出、启用自动目录插入，或只保留其中一种方式。
如果你要手动放置目录，请开启手动输出，并复制符合工作流的模板函数、简码或区块片段。
如果你要自动放置目录，请开启自动插入，并选择内容前或第一段之后作为插入位置。
如果你希望目录有可见标题，请开启标题显示，并设置标题文字与标题层级。
在范围中，选择哪些文章类型可以显示目录。
在结构中，设置最少标题数，并选择要纳入的标题层级。
在行为中，决定是否启用平滑滚动、编号与默认折叠模式。
在锚点中，设置锚点前缀，并列出要排除的标题。
打开布局，选择一组默认主题，并微调标题区、内容容器、链接与清单间距。
如有需要，请打开特定文章的编辑器，使用目录显示模式将该文章切换为自动、手动或停用。
保存设置、检查预览分页，然后再打开一篇有足够标题的正式文章确认最终结果。

保存后请确认以下项目：

只有符合最少标题数的文章才会显示目录。
点击目录链接后，读者会被带到正确段落。
单篇文章的目录显示模式与你为该篇文章选择的方法一致。
套用主题 CSS 后，正式页面外观仍然正确。

SEO 效益

好的目录能让长篇内容更容易扫读，也更容易导航。这能帮助读者更快到达需要的段落，并让长文页面呈现更清楚的结构。

使用场景

长篇教程文章

调整前：安装指南有很多段落，但读者必须一路往下滚动，才能找到需要的步骤。

调整后：目录把标题转成可点击大纲，让读者可以直接跳到安装、示例或疑难排查段落。

文档与知识库页面

调整前：支持文档已经有清楚标题，但第一次阅读的用户仍会觉得页面信息量很重。

调整后：目录会立即把页面结构显示出来，让读者在深入阅读前就能先掌握页面全貌。

常见问题

为什么有些文章没有显示目录？

请检查最少标题数、所选的标题层级、允许的文章类型，以及单篇文章的目录显示模式。

我该用自动插入还是手动放置？

如果你希望大量文章都自动加入目录，请用自动插入。若你需要精准控制显示位置，请使用手动放置。

为什么预览与正式页面不同？

预览是简化版参考画面。你的主题与真实文章内容仍会影响前台最终结果，因此一定要检查正式页面。

概览

设置

设置 分页

手动输出