文档

启用（及定位）目录

有两种方法可以启用目录（ToC, Table of Contents）。如果您希望它位于页眉下方（如下面这个页面），请在文章的前言部分设置此变量：

[extra]
toc = true

如果您更愿意在文章的其他位置显示目录（例如，在引言之后），您可以通过在您希望目录出现的位置添加以下的一行内容来实现：

<!-- toc -->

您还可以使用简单的 @@ZOLA_SC_PLACEHOLDER@@ 短码，它将为您编写该字符串，有效地插入目录（迈克尔·克莱顿的想法）。

这种方法将呈现目录，但不包含“目录”标题。这允许您为目录使用不同的（或无）标题，或者像这样隐藏它：

实现此功能的代码：

<details>
    <summary>隐藏目录</summary>
    <!-- toc -->
</details>

注意：如果您同时设置了 toc = true 并在文本中的某处有 <!-- toc -->，您将获得多个目录。

如果您为目录设置了自定义位置和自定义标题，您可能希望像这样隐藏它（请参见下面的部分）：

+++
title = "你的文章标题"
date = 2034-01-11

[extra]
toc_ignore_pattern = "^(Table of Contents)"
+++

以下是一些介绍性文字。

### Table of Contents

<!-- toc -->

## First content header

设置最大深度

您可以通过指定 toc_levels 变量来设置目录（ToC）的最大深度，该变量接受 1 到 4 之间的整数：

[extra]
toc_levels = 2

在这个例子中，只有前两个级别的标题会被包含在目录中，无论它们的实际 HTML 标签（h1、h2 、h3 等）。如果您只想包含主要级别的标题，请设置 toc_levels = 1。默认的 toc_levels 值是 3。

在设置 toc_levels 时要考虑到您的读者。虽然详细导航中包含许多嵌套级别可能很有吸引力，但更短更简单的目录通常对读者更加友好，也不会让人感到压抑。根据内容的复杂性和长度调整深度，以获得最佳的阅读体验。

从目录中隐藏标题

您可能想要隐藏某些标题。例如，如果您的文章包含许多图表或表格，它们可能会使目录显得杂乱。您可以使用 toc_ignore_pattern 变量在目录中隐藏特定标题。

这个变量期望一个正则表达式（regex），因为它使用了 Tera 的匹配测试。 toc_ignore_pattern 会与标题文本进行测试，但不包括 # 字符。例如，对于标题 ### Further reading，文本 Further reading 将被检查。

以下是一些 toc_ignore_pattern 的示例值以及它们可以隐藏的标题：

您可以在像 regex101 这样的网站上测试您的正则表达式，以确保它按预期工作。

注意：“环视”功能，包括向前看和向后看，均不受支持。

标题 1

洛伦 ipsum 痛苦坐阿梅特，共同皮肤藻类精英。莫里斯在柔软的肿块中呈蓝色，在功效湖中。欧洲在肠子中。伊坦在肿块上读书，坐在乌拉尔科尔珀的酒窝里。目前在内拉特里是箭头末端的一种。伊坦不在无菌的空虚中。整数鳞片洛梅尔在拱门颚下，非男性沙沙声没有车辆。埃内安在金属上告诉时间。萨德鲁特姆乌纳在普通时间上。前庭酒窝精英放置在胡椒最大调味料上。萨德乌纳自由，欧洲在地球生命中，在劳雷特调味料中。埃内安精英读书，马蒂斯在酒窝中，没有酒窝。萨德在肠子中，伊坦在胡椒末端。

标题 2

洛伦 ipsum 痛苦坐阿梅特，共同皮肤藻类精英。莫里斯在柔软的肿块中呈蓝色，在功效湖中。欧洲在肠子中。伊坦在肿块上读书，坐在乌拉尔科尔珀的酒窝里。目前在内拉特里是箭头末端的一种。伊坦不在无菌的空虚中。整数鳞片洛梅尔在拱门颚下，非男性沙沙声没有车辆。埃内安在金属上告诉时间。萨德鲁特姆乌纳在普通时间上。前庭酒窝精英放置在胡椒最大调味料上。萨德乌纳自由，欧洲在地球生命中，在劳雷特调味料中。埃内安精英读书，马蒂斯在酒窝中，没有酒窝。萨德在肠子中，伊坦在胡椒末端。

标题 3.1

洛伦 ipsum 痛苦坐阿梅特，共同皮肤藻类精英。莫里斯在柔软的肿块中呈蓝色，在功效湖中。欧洲在肠子中。伊坦在肿块上读书，坐在乌拉尔科尔珀的酒窝里。目前在内拉特里是箭头末端的一种。伊坦不在无菌的空虚中。整数鳞片洛梅尔在拱门颚下，非男性沙沙声没有车辆。埃内安在金属上告诉时间。萨德鲁特姆乌纳在普通时间上。前庭酒窝精英放置在胡椒最大调味料上。萨德乌纳自由，欧洲在地球生命中，在劳雷特调味料中。埃内安精英读书，马蒂斯在酒窝中，没有酒窝。萨德在肠子中，伊坦在胡椒末端。

标题 4.1

洛伦 ipsum 痛苦坐阿梅特，共同皮肤藻类精英。莫里斯在柔软的肿块中呈蓝色，在功效湖中。欧洲在肠子中。伊坦在肿块上读书，坐在乌拉尔科尔珀的酒窝里。目前在内拉特里是箭头末端的一种。伊坦不在无菌的空虚中。整数鳞片洛梅尔在拱门颚下，非男性沙沙声没有车辆。埃内安在金属上告诉时间。萨德鲁特姆乌纳在普通时间上。前庭酒窝精英放置在胡椒最大调味料上。萨德乌纳自由，欧洲在地球生命中，在劳雷特调味料中。埃内安精英读书，马蒂斯在酒窝中，没有酒窝。萨德在肠子中，伊坦在胡椒末端。

标题 4.2

洛伦 ipsum 痛苦坐阿梅特，共同皮肤藻类精英。莫里斯在柔软的肿块中呈蓝色，在功效湖中。欧洲在肠子中。伊坦在肿块上读书，坐在乌拉尔科尔珀的酒窝里。目前在内拉特里是箭头末端的一种。伊坦不在无菌的空虚中。整数鳞片洛梅尔在拱门颚下，非男性沙沙声没有车辆。埃内安在金属上告诉时间。萨德鲁特姆乌纳在普通时间上。前庭酒窝精英放置在胡椒最大调味料上。萨德乌纳自由，欧洲在地球生命中，在劳雷特调味料中。埃内安精英读书，马蒂斯在酒窝中，没有酒窝。萨德在肠子中，伊坦在胡椒末端。

标题 3.2

洛伦 ipsum 痛苦坐阿梅特，共同皮肤藻类精英。莫里斯在柔软的肿块中呈蓝色，在功效湖中。欧洲在肠子中。伊坦在肿块上读书，坐在乌拉尔科尔珀的酒窝里。目前在内拉特里是箭头末端的一种。伊坦不在无菌的空虚中。整数鳞片洛梅尔在拱门颚下，非男性沙沙声没有车辆。埃内安在金属上告诉时间。萨德鲁特姆乌纳在普通时间上。前庭酒窝精英放置在胡椒最大调味料上。萨德乌纳自由，欧洲在地球生命中，在劳雷特调味料中。埃内安精英读书，马蒂斯在酒窝中，没有酒窝。萨德在肠子中，伊坦在胡椒末端。

标题 4

洛伦 ipsum 痛苦坐阿梅特，共同皮肤藻类精英。莫里斯在柔软的肿块中呈蓝色，在功效湖中。欧洲在肠子中。伊坦在肿块上读书，坐在乌拉尔科尔珀的酒窝里。目前在内拉特里是箭头末端的一种。伊坦不在无菌的空虚中。整数鳞片洛梅尔在拱门颚下，非男性沙沙声没有车辆。埃内安在金属上告诉时间。萨德鲁特姆乌纳在普通时间上。前庭酒窝精英放置在胡椒最大调味料上。萨德乌纳自由，欧洲在地球生命中，在劳雷特调味料中。埃内安精英读书，马蒂斯在酒窝中，没有酒窝。萨德在肠子中，伊坦在胡椒末端。

标题 4

洛伦 ipsum 痛苦坐阿梅特，共同皮肤藻类精英。莫里斯在柔软的肿块中呈蓝色，在功效湖中。欧洲在肠子中。伊坦在肿块上读书，坐在乌拉尔科尔珀的酒窝里。目前在内拉特里是箭头末端的一种。伊坦不在无菌的空虚中。整数鳞片洛梅尔在拱门颚下，非男性沙沙声没有车辆。埃内安在金属上告诉时间。萨德鲁特姆乌纳在普通时间上。前庭酒窝精英放置在胡椒最大调味料上。萨德乌纳自由，欧洲在地球生命中，在劳雷特调味料中。埃内安精英读书，马蒂斯在酒窝中，没有酒窝。萨德在肠子中，伊坦在胡椒末端。

标题 2

洛伦 ipsum 痛苦坐阿梅特，共同皮肤藻类精英。莫里斯在柔软的肿块中呈蓝色，在功效湖中。欧洲在肠子中。伊坦在肿块上读书，坐在乌拉尔科尔珀的酒窝里。目前在内拉特里是箭头末端的一种。伊坦不在无菌的空虚中。整数鳞片洛梅尔在拱门颚下，非男性沙沙声没有车辆。埃内安在金属上告诉时间。萨德鲁特姆乌纳在普通时间上。前庭酒窝精英放置在胡椒最大调味料上。萨德乌纳自由，欧洲在地球生命中，在劳雷特调味料中。埃内安精英读书，马蒂斯在酒窝中，没有酒窝。萨德在肠子中，伊坦在胡椒末端。

标题 3.1

洛伦 ipsum 痛苦坐阿梅特，共同皮肤藻类精英。莫里斯在柔软的肿块中呈蓝色，在功效湖中。欧洲在肠子中。伊坦在肿块上读书，坐在乌拉尔科尔珀的酒窝里。目前在内拉特里是箭头末端的一种。伊坦不在无菌的空虚中。整数鳞片洛梅尔在拱门颚下，非男性沙沙声没有车辆。埃内安在金属上告诉时间。萨德鲁特姆乌纳在普通时间上。前庭酒窝精英放置在胡椒最大调味料上。萨德乌纳自由，欧洲在地球生命中，在劳雷特调味料中。埃内安精英读书，马蒂斯在酒窝中，没有酒窝。萨德在肠子中，伊坦在胡椒末端。

标题 4.1

洛伦 ipsum 痛苦坐阿梅特，共同皮肤藻类精英。莫里斯在柔软的肿块中呈蓝色，在功效湖中。欧洲在肠子中。伊坦在肿块上读书，坐在乌拉尔科尔珀的酒窝里。目前在内拉特里是箭头末端的一种。伊坦不在无菌的空虚中。整数鳞片洛梅尔在拱门颚下，非男性沙沙声没有车辆。埃内安在金属上告诉时间。萨德鲁特姆乌纳在普通时间上。前庭酒窝精英放置在胡椒最大调味料上。萨德乌纳自由，欧洲在地球生命中，在劳雷特调味料中。埃内安精英读书，马蒂斯在酒窝中，没有酒窝。萨德在肠子中，伊坦在胡椒末端。

标题 4.2

洛伦 ipsum 痛苦坐阿梅特，共同皮肤藻类精英。莫里斯在柔软的肿块中呈蓝色，在功效湖中。欧洲在肠子中。伊坦在肿块上读书，坐在乌拉尔科尔珀的酒窝里。目前在内拉特里是箭头末端的一种。伊坦不在无菌的空虚中。整数鳞片洛梅尔在拱门颚下，非男性沙沙声没有车辆。埃内安在金属上告诉时间。萨德鲁特姆乌纳在普通时间上。前庭酒窝精英放置在胡椒最大调味料上。萨德乌纳自由，欧洲在地球生命中，在劳雷特调味料中。埃内安精英读书，马蒂斯在酒窝中，没有酒窝。萨德在肠子中，伊坦在胡椒末端。

标题 3.2

洛伦 ipsum 痛苦坐阿梅特，共同皮肤藻类精英。莫里斯在柔软的肿块中呈蓝色，在功效湖中。欧洲在肠子中。伊坦在肿块上读书，坐在乌拉尔科尔珀的酒窝里。目前在内拉特里是箭头末端的一种。伊坦不在无菌的空虚中。整数鳞片洛梅尔在拱门颚下，非男性沙沙声没有车辆。埃内安在金属上告诉时间。萨德鲁特姆乌纳在普通时间上。前庭酒窝精英放置在胡椒最大调味料上。萨德乌纳自由，欧洲在地球生命中，在劳雷特调味料中。埃内安精英读书，马蒂斯在酒窝中，没有酒窝。萨德在肠子中，伊坦在胡椒末端。

标题 4.1

洛伦 ipsum 痛苦坐阿梅特，共同皮肤藻类精英。莫里斯在柔软的肿块中呈蓝色，在功效湖中。欧洲在肠子中。伊坦在肿块上读书，坐在乌拉尔科尔珀的酒窝里。目前在内拉特里是箭头末端的一种。伊坦不在无菌的空虚中。整数鳞片洛梅尔在拱门颚下，非男性沙沙声没有车辆。埃内安在金属上告诉时间。萨德鲁特姆乌纳在普通时间上。前庭酒窝精英放置在胡椒最大调味料上。萨德乌纳自由，欧洲在地球生命中，在劳雷特调味料中。埃内安精英读书，马蒂斯在酒窝中，没有酒窝。萨德在肠子中，伊坦在胡椒末端。

标题 4.1

洛伦 ipsum 痛苦坐阿梅特，共同皮肤藻类精英。莫里斯在柔软的肿块中呈蓝色，在功效湖中。欧洲在肠子中。伊坦在肿块上读书，坐在乌拉尔科尔珀的酒窝里。目前在内拉特里是箭头末端的一种。伊坦不在无菌的空虚中。整数鳞片洛梅尔在拱门颚下，非男性沙沙声没有车辆。埃内安在金属上告诉时间。萨德鲁特姆乌纳在普通时间上。前庭酒窝精英放置在胡椒最大调味料上。萨德乌纳自由，欧洲在地球生命中，在劳雷特调味料中。埃内安精英读书，马蒂斯在酒窝中，没有酒窝。萨德在肠子中，伊坦在胡椒末端。