Skip to content

TOC 控制

功能描述

优化了文章目录（TOC）的显示逻辑，现在支持更智能的 TOC 显示控制。

自动判断规则

系统会自动判断是否显示 TOC，基于以下条件：

  1. TOC 内容存在：页面必须有实际的标题内容
  2. 内容长度：文章字数需要大于 200 字
  3. TOC 项目数量：TOC 中的标题数量需要大于 1 个（避免只有一个标题的情况）

手动控制

你可以在文章的 front matter 中使用 toc 参数来强制控制 TOC 的显示：

强制显示 TOC

---
title: "文章标题"
toc: true
---

强制隐藏 TOC

---
title: "文章标题"
toc: false
---

使用自动判断（默认）

---
title: "文章标题"
# 不设置 toc 参数，系统会自动判断
---

显示效果

  • 显示 TOC 时：在页面右侧的侧边栏显示文章目录
  • 不显示 TOC 时：在页面右侧的侧边栏显示文章基础信息，包括：
  • 发布时间
  • 最后更新时间（如果不同于发布时间）
  • 字数统计
  • 阅读时长估算
  • 文章分类
  • 文章标签（最多显示 3 个）
  • 针对短文章的特殊提示

典型使用场景

  1. 短文章：自动隐藏 TOC，显示文章信息
  2. 只有一个标题的文章：自动隐藏 TOC，避免显得冗余
  3. 手动控制：作者可以根据需要强制显示或隐藏 TOC

这个功能让网站的 TOC 显示更加智能和用户友好。