跳到主要内容

使用方法

最后更新于:

使用方法

image-20260726213122.avif

formatter选项

🟢 问题

 1我想实现一个需求:
 2
 3在md文档formatter有一些key: value能控制页面一些内容是否显示
 4
 5控制该md页面是否出现在首页 (注意,如果开启了这个选项,首页的站点统计里文章数目就需要减去这个页面)
 6控制页面是否显示上一篇、下一篇
 7控制页面是否显示最近文章
 8控制页面是否显示评论
 9
10请实现这个功能。

🟢回答

记录于2026年7月26日,来自@cusor,亲测有效。

已实现。在任意文档 front matter 里用下面这些开关即可(不写则默认开启):

1---
2title: 示例
3
4home: false            # 不出现在首页,且站点统计「文章数目」不计本页
5prevNext: false        # 不显示上一篇 / 下一篇
6articleUpdate: false   # 不显示文末「最新文章」(也可用 recentArticles: false)
7comments: false        # 不显示评论区
8# article: false       # 兼容旧写法:视为非文章页,等同 home: false
9---

生效范围

  • home: false → 首页博客列表、博客列表页不收录;侧栏「文章数目」与近一周/近一月也不计
  • prevNext: false → 文末翻页隐藏
  • articleUpdate: false → 文末最新文章隐藏
  • comments: false → 评论区与对应 Twikoo 初始化跳过

示例:某页只作专题入口、不进首页也不开评论:

1home: false
2comments: false

🟢常用(亲测有效)

1home: false            # 不出现在首页,且站点统计「文章数目」不计本页
2prevNext: false        # 不显示上一篇 / 下一篇
3articleUpdate: false   # 不显示文末「最新文章」(也可用 recentArticles: false)
4comments: false        # 不显示评论区
最新文章

本页导航

文档导航