头像 One
头像 One

更多功能请点顶栏「快捷菜单」

博客 OneBlog 920 字 4 分钟 -- 次

formatter

最后更新于:
AI 摘要

image-20260727175712.avif

formatter

本站 MD 的 front matter 里，主题实际会认的常用选项如下。

一键模式（目录页）

选项说明
catalogue: true目录页模式：关首页/翻页/最新文章/评论/版权/顶部元信息/更新时间/本页导航，隐藏右侧目录竖线与小火箭/评论浮动按钮，且不进分类标签与归档
article: false效果同 catalogue: true（兼容旧习惯）

显示开关（可单独用）

选项默认说明
home: falsetrue不出现在首页与归档，且不计入「文章数目」
prevNext: falsetrue不显示上一篇/下一篇
articleUpdate: falsetrue不显示文末「最新文章」（别名 recentArticles: false）
comments: falsetrue不显示评论区
copyright: falsetrue不显示文末版权提示
meta: falsetrue不显示顶部创建时间/分类/标签等
lastUpdated: falsetrue不显示「最后更新于」
toc: falsetrue不显示右侧「本页导航」及移动端 TOC 入口；正文限宽更易阅读
aiSummaryShow: falsetrue不显示正文上方「AI 摘要」卡片（保留已有 aiSummary 文案；本地生成也会跳过）

基础信息

选项说明
title标题
date创建/发布日期
lastmod最后修改（影响「最后更新于」）
description首页卡片 / SEO 简介（与 AI 摘要分离）
aiSummary文档页正文上方「AI 摘要」卡片文案；不进首页卡片。可用 make gen-ai-summary 本地生成；单篇关闭请用 aiSummaryShow: false
draft: true草稿（构建默认不发布）
categories分类（目录页即使写了也不会进分类列表）
tags标签（同上）
coverImg封面图 URL
url自定义路径，如 /linux/linux-index
author作者（字符串或 { name, link }）

列表与排序

选项说明
featured: true精选，优先出现在首页博客列表
weight精选排序权重（越小越靠前）
sticky: true置顶标记（卡片样式）

页面类型 / 布局（特殊页）

选项常见值说明
typeabout-site / friends / websites / moments / timeline / thoughts走对应布局
layout同名布局覆盖默认模板
sidebar: false隐藏左侧文档导航侧栏与移动端菜单抽屉

其它

选项说明
confetti: true加载撒花脚本
location / event朋友圈类页面用
aboutSite: {...}「关于本站」结构化数据
applyInfo友链申请文案

单篇关闭 AI 文章摘要

已加上单篇关闭 AI 摘要的能力。

用法（front matter）

1aiSummaryShow: false

关闭后不展示卡片，已有 aiSummary 文案会保留；make gen-ai-summary 也会跳过该篇。

已同步

  • 主题展示判断
  • formatter 文档说明
  • 后台文章编辑「显示与归档」里的 AI 摘要 开关
  • 后台 API 读写与 sanitize
  • 本地生成脚本跳过逻辑

普通文章最小示例❤️

什么都不填的话，默认会自动注入的。

 1---
 2title: 文章标题
 3date: 2026-07-27
 4categories:
 5  - 运维
 6tags:
 7  - Linux
 8coverImg: https://example.com/cover.avif
 9description: 一句话简介
10---

目录页推荐示例❤️

1---
2title: 运维
3catalogue: true
4coverImg: https://example.com/cover.avif
5categories:
6  - 运维   # 可保留，但不会进分类页
7tags:
8  - 运维   # 可保留，但不会进分类页
9---

说明：旧版 vdoing 文档里的 comment、editLink、titleTag、permalink 等，本主题并不按那套生效；评论请用 comments，链接用 url。

非文档页、非目录页 推荐示例❤️

只保留 顶部创建时间/分类/标签等、「最后更新于」、评论，其余不予展示。

效果：https://onedayxyy.cn/love/snxq 《少年心气》

1home: false
2prevNext: false
3articleUpdate: false
4copyright: false

隐藏 AI 摘要❤️

1aiSummaryShow: false

关闭后不展示正文上方 AI 摘要卡片，已有 aiSummary 文案会保留；make gen-ai-summary 也会跳过该篇。

隐藏 文档页面的右侧 本页导航❤️

1toc: false
📡
👤 作者: One
🔗 链接: https://onedayxyy.cn/topics/klsjl
🌐 版权: 本站文章除特别声明外，均采用 CC BY-NC-SA 4.0 协议，转载请注明来自 One Blog！
最新文章

文档导航