生活随笔模板

生活随笔重在记录真实经历和个人感受，结构可以比技术文章松弛，但发布前必须额外检查隐私。互联网上的公开页面一旦被搜索引擎、RSS 或读者保存，就很难真正撤回。

用途

记录一次旅行、一次见面、一段日常、一个阶段的感受。
把当时的场景、选择和情绪写下来，日后回看。
用较轻的结构整理一段经历，不需要教程或复盘的硬性章节。
记录照片、声音、地点或小事带来的触动。

放在哪里

随笔仍然是公开文章，放在 docs/posts/生活随笔/。可以在一级分类下，也可以放进二级目录；二级目录不是分类。

场景	目标文件	`categories`	`permalink`	公开地址
一级分类下	`docs/posts/生活随笔/10.weekend-walk.md`	`[生活随笔]`	`/posts/生活随笔/weekend-walk`	`https://www.baecon.cn/posts/生活随笔/weekend-walk`
二级目录下	`docs/posts/生活随笔/旅行记录/20.west-lake-trip.md`	`[生活随笔]`	`/posts/生活随笔/旅行记录/west-lake-trip`	`https://www.baecon.cn/posts/生活随笔/旅行记录/west-lake-trip`

公式：

text

文件：docs/posts/<一级分类>/[<子目录>/]<slug>.md
permalink：/posts/<一级分类>/[<子目录>/]<slug>
公开地址：https://www.baecon.cn/posts/<一级分类>/[<子目录>/]<slug>

categories 只写一级分类 生活随笔。如果新建「旅行记录」二级目录并希望有目录入口，还应另外创建 docs/catalog/生活随笔/旅行记录.md 目录页。

什么时候使用

内容以个人经历、观察、情绪和生活变化为主。
你愿意让这段经历公开发布，并能承担被搜索、转载或评论的后果。
已经取得照片中人物、聊天记录、住址等信息的发布授权，或完成脱敏。
想留下当时的真实感受，而不是写一篇完整教程。

什么时候不要使用

这是只给自己看的日记、家庭隐私、感情纠纷或未经同意的他人故事。不要放进公开仓库。
涉及未成年人、身份证件、票据、车牌、门牌、学校班级、精确位置、联系方式或医疗信息。
想把文章设为私密访问。当前站点配置没有启用可靠的私密文章访问控制，frontmatter 不能替代权限系统。
内容其实是技术教程、项目复盘、算法题解或建站记录，请使用对应模板。
需要创建分类目录入口，请使用目录页模板。

完整可复制文件

markdown

---
title: 周末早起散步
description: 记录一个普通周末清晨的散步路线、城市声音和当时的真实感受，同时说明照片脱敏、人物授权和发布前隐私检查，避免公开可识别身份的信息。
permalink: /posts/生活随笔/weekend-walk
categories:
  - 生活随笔
tags:
  - 生活记录
  - 散步
  - 城市
article: true
sidebar: true
pagefind-indexed: true
comment: true
---

# 周末早起散步

用一两句话交代这段记录的时间和心情，例如：这是一个没有计划的清晨，我沿着熟悉的街道慢慢走了一圈。不要在第一段就堆入完整地址、同行者姓名或可识别身份的信息。

## 起因

写清为什么想记录这件事。可能是一个突然冒出的念头、一次久违的早起、一段变化中的生活，或某个想留住的瞬间。

例如：连续几周都在赶进度，周末醒来时突然想出门走走，不带耳机，也不设目的地。

## 经过

按时间或空间顺序记录发生了什么。不必每件事都写，选择最能说明这段经历的细节：看见的、听见的、闻到的、做过的和改变路线的瞬间。

### 出门

写清大致时间段和不可识别的环境，例如「早上七点左右，从小区门口出发」，不要公开精确门牌和实时位置。

### 路上

记录两三个具体细节：

- 早餐店刚开门，蒸汽从窗口飘出来。
- 路边的树开始落叶，清洁工在扫人行道。
- 临时改变路线，走进一条以前没注意的小巷。

![清晨街道的局部照片，不包含车牌、门牌和清晰人脸](/images/posts/weekend-walk/street.webp)

> 图片提示：照片发布前检查反光、背景、票据和定位信息；没有合适图片或未取得授权时删除整行。

## 感受

写下当时和现在回看时的感受。可以承认矛盾、疲惫、平静或不确定，不需要把经历包装成励志结论。

例如：那天没有发生特别的事，但慢下来之后，我重新注意到很多平时被忽略的声音。回看时才发现，自己需要的可能不是更努力，而是给生活留一点空白。

## 后记

如果过了一段时间再补充，可以写新的理解、后续变化或一句简短的提醒。后记不是必需章节；没有新内容就删除。

例如：一周后我又走了一次同一条路，早餐店已经换了招牌。记录并不是为了留住一切，而是为了记得自己曾经怎样经过。

复制后必须修改或确认

值	位置	应该怎么改	为什么必须确认
`title` 和正文 H1	frontmatter 与 `# 周末早起散步`	改成完全一致的真实标题	页面只能有一个 H1，标题也会出现在首页和搜索中。
`description`	frontmatter	换成 50–150 个中文字符的真实摘要	SEO 和首页摘要都需要清楚、克制，不要泄露隐私。
`date`	frontmatter	通常不要手填；文件首次 Git commit 后启动/构建会自动写入	自动写入后不要为了「更新」而改它；更新信息用 `updated`。
`permalink`	frontmatter	改成全站唯一的 `/posts/生活随笔/.../slug`	决定文章公开 URL；不要保留示例 slug。
`categories`	frontmatter	只写 `[生活随笔]`	二级目录不是分类。
`tags`	frontmatter	换成 2–5 个不暴露隐私的具体标签	不要使用精确地点、真实姓名、公司名或可定位标签。
`coverImg`	frontmatter	通常删除以使用正文图片/随机背景；只在需要固定卡片或分享图时写真实路径	显式写后会固定，不再随机；路径必须存在。
`article`	frontmatter	保持 `true`	确保随笔作为文章进入首页和归档。
`sidebar`	frontmatter	保持 `true`	正常文章显示侧边栏。
`pagefind-indexed`	frontmatter	保持 `true`；如果只想降低搜索曝光可改 `false`	但它不是隐私保护，文章仍可被直接访问、RSS 或分享链接传播。
`comment`	frontmatter	根据是否愿意接受公开讨论选择 `true` 或 `false`	评论会扩大暴露面；敏感内容不要发布。
人物和地点	body	使用化名、模糊地点和不可识别背景	防止读者或搜索引擎反推出真实身份和位置。
图片与 alt	body	只使用有授权的图片，删除元数据和敏感画面，alt 不写身份信息	图片路径采用 `/images/posts/<slug>/<file>.webp`，alt 必填。

可选字段

字段	什么时候用	推荐值	注意
`titleTag`	想标示这是一篇随笔	`随笔` 或 `记录`	只是短标签，不替代 tags。
`top`	想让随笔进入首页精选	`1`	只适合适合公开传播的内容，不是排名。
`sticky`	想置顶这篇随笔	`1` 或较小数字	必须是数字，越小越靠前。
`sidebarSort`	需要覆盖侧边栏顺序	`10`、`20`	优先使用文件名数字前缀。
`inHomePost`	不想让随笔进入首页主列表	省略或 `false`	会影响首页及分类/标签的 HomePost 列表，不是隐私开关。
`updated`	需要覆盖 SEO 修改时间	`YYYY-MM-DD HH:mm:ss`	通常省略，不能代替 `date`。
`author`	需要多人署名	不写；如确需覆盖，用对象 `{ name, link }`	本站默认站点作者；涉及他人署名必须先取得同意。

文章 frontmatter 字段总表

字段	类型	省略时默认	推荐值	级别	完整说明
`title`	`string`	无可用默认；不要依赖自动推导	与正文唯一 H1 完全一致	必填	页面标题，也是首页卡片、侧边栏、搜索结果和浏览器标题的来源。复制模板后必须改成真实标题，并保证正文只有一个 H1。
`description`	`string`	SEO 会回退到站点描述；首页摘要质量不可控	50–150 个中文字符，说明问题、内容与读者收益	推荐	供 SEO 描述、首页卡片摘要和分享信息使用。应写成完整的一句话或两句话，不要堆关键词，也不要直接复制标题。
`desc`	`string`	未设置	省略	可选（旧字段）	旧目录页的兼容显示字段，主要给 catalogue 页面使用；它不是 SEO 主字段，也不参与首页摘要。新文章不要写；目录页如保留 `desc`，需与 `description` 同值。
`date`	`string`	文件首次 Git commit 的作者时间；已有值保留	通常省略，不手填；需要人工指定发布时间时才覆盖	自动维护；通常不手填	文章的创建/发布时间，用于展示、首页排序、归档和 SEO 的 `datePublished`。新文章不需要写；首次 commit 后启动/构建会写入并保持稳定。
`updated`	`string`	未显式设置；SEO 修改时间由构建或最后更新时间兜底	正常省略；确实需要覆盖时再用同一日期格式	可选	只用于覆盖 SEO 的 `dateModified`，不是文章发布时间，也不能代替 `date`。除非有明确的更新日期要展示给搜索引擎，否则不要填。
`permalink`	`string`	自动插件通常跳过已有 frontmatter，不能依赖自动生成	全站唯一：`/posts/<一级分类>/[<子目录>/]<slug>`	必填	决定文章的公开 URL。本项目要求显式填写，不能包含 `.md`，不能以 `docs/` 开头，也不能与其他页面重复。
`categories`	`string[]`	自动插件通常跳过；缺省时没有可靠分类	显式写一级分类，如 `[技术笔记]`	推荐	分类归档和分类卡片使用。只写一级分类；二级目录属于路径，不是第二个分类。一篇文章通常只写一个一级分类。
`tags`	`string[]`	`[]`	2–5 个具体标签，如 `[VitePress, 部署]`	推荐	标签用于聚合主题和搜索。标签应短而具体，避免把整句话、分类名或大量近义词都写成标签。
`coverImg`	`string` 或 `string[]`	首页卡片：正文图片随机 → `/home/bg*.webp` 随机；SEO 分享图回退站点默认	需要固定封面/分享图时才写真实路径；否则省略	可选（按需）	首页卡片优先使用；文章 Banner、OG 和分享图也会读取。显式写后不再随机；路径必须真实存在；不写时分享图不会自动取正文图。
`article`	`boolean`	在 `/posts/` 下省略时按 `true` 处理	`true`	推荐	明确声明这是文章，让首页、归档、分类和标签等文章能力正常工作。教程、复盘、随笔、题解和建站记录都应显式写 `true`。
`sidebar`	`boolean`	VitePress 默认为 `true`	`true`	推荐	控制文章页是否显示左侧文章导航。本站文章应保持 `true`；只有特殊全宽页面才考虑关闭。
`sidebarSort`	`number`	使用文件名数字前缀；没有前缀时按 `9999`	省略；确需覆盖时用 `10`、`20` 这类数字	可选	覆盖该文章在侧边栏中的排序，数字越小越靠前。优先用文件名前缀排序；同时使用两种方式会增加理解和维护成本。
`pagefind-indexed`	`boolean`	`true`	`true`	推荐	控制 Pagefind 是否索引此页。文章应保持 `true`；设为 `false` 只是不进入站内搜索，并不会把页面变成私有页面。
`comment`	`boolean`	未写 `false` 时按开启处理	`true`	推荐	控制文章评论区。普通文章保持 `true`；目录页、纯功能页或含敏感信息的页面应关闭或不要发布。
`top`	`boolean 或 number`	未设置，即不进入精选	省略；只有需要首页精选时写 `1`	可选	首页「精选文章」的真值筛选标记，不是排名：写 `1` 表示入选，数字大小本身不会排序。是否显示还受首页精选数量上限影响。
`sticky`	`number`	未设置，即不置顶	省略；确需置顶时用较小数字，如 `1`	可选	置顶排序字段，数字越小越靠前。它和 `top` 分工不同：`top` 负责进入精选卡片，`sticky` 负责置顶排序。不要用 `true` 代替数字。
`inHomePost`	`boolean`	`true`	省略或显式 `true`；只有特殊文章才写 `false`	可选	设为 `false` 时会从首页、分类页和标签页等 HomePost 列表隐藏；文章的 URL、侧边栏、归档、精选和搜索等不会自动变成私有。不要把它当作隐私开关。
`inCatalogue`	`boolean`	`true`	通常省略；不想让文章出现在目录页时写 `false`	高级	目录插件扫描开关；不影响侧栏、Pagefind、首页、归档或 RSS。
`titleTag`	`string`	无标签	省略；需要短标识时用 `原创`、`教程`、`复盘`、`题解`、`记录`	可选	标题旁的小标签，只用于视觉提示，不替代分类或标签。保持 2–4 个汉字最清晰，不要塞入长句。
`author`	`object`	使用站点级作者 `Baecon`	省略，不在单篇文章覆盖	可选（不建议）	若覆盖需用 `{ name: string, link?: string }` 对象；普通文章不要填写。

高级 VitePress 字段

以下字段控制页面布局，不是随笔内容。它们都不能提供隐私保护，普通随笔应全部省略。

字段	类型	省略时默认	推荐值	级别	完整说明
`layout`	`string 或 false`	使用 VitePress 标准文章布局	省略	高级	切换页面布局。文章模板不需要设置；目录页才固定使用 `layout: page`。初学者不要为了外观而改它。
`outline`	`false`、数字、`[number, number]` 或 `"deep"`	由 VitePress 与主题的默认大纲配置决定	省略	高级	控制右侧标题大纲。普通文章沿用站点统一配置即可，除非全站规范明确要求，否则不要逐篇覆盖。
`aside`	`boolean` 或 `"left"`	默认跟随 VitePress 文章布局	省略	高级	控制右侧辅助栏。与全站布局相关，不应由每篇文章随意切换。
`lastUpdated`	`boolean`	跟随站点 `lastUpdated: true`	省略	高级	控制页面是否显示最后更新时间。本站已统一开启，不需要在每篇文章重复设置。
`editLink`	`boolean`	跟随站点主题配置	省略	高级	控制是否显示编辑链接。它属于站点能力，不是文章内容字段。
`pageClass`	`string`	空	省略	高级	给页面根元素追加 CSS 类，只在有配套样式时使用。随意填写不会产生视觉效果。
`layoutClass`	`string`	空	省略	高级	当前项目会把它作为布局组件 class 读取，但只有配套 CSS 才有意义；普通写作不需要填写。
`head`	`array`	`[]`	省略	高级	为单个页面追加 `<head>` 标签。站点已统一生成 SEO 和分享标签，重复配置容易冲突。
`titleTemplate`	`string 或 false`	使用站点标题模板	省略	高级	覆盖浏览器标题拼接方式。除非页面有特殊 SEO 要求，否则不要覆盖全站一致性。
`autoTitle`	`boolean`	doc 布局默认允许自动注入 H1	省略；正文已手写 H1	高级	设为 `false` 可禁止自动 H1 注入。
`articleUpdate`	`boolean 或 object`	跟随站点配置，默认启用	省略	高级	设为 `false` 隐藏文章页最近更新模块。
`articleBanner`	`boolean 或 object`	跟随站点配置；本站开启	省略	高级	设为 `false` 关闭单文章 Banner；通常仅无侧栏 doc 文章生效。
`coverBgColor`	`string`	跟随站点 defaultCoverBgColor，本站为空	省略	高级	单文章 Banner 背景色覆盖；无 Banner 时不可见。
`prev`	`boolean`	`true`（有上一页时）	省略	高级	设为 `false` 隐藏上一页链接。
`next`	`boolean`	`true`（有下一页时）	省略	高级	设为 `false` 隐藏下一页链接。

catalogue、path、pageTitle 是目录页专用字段，文章模板不要填写。若需要创建分类或子目录入口，请使用目录页模板。

章节	写什么	示例
`## 起因`	为什么想记录这段经历，当时的触发点	连续忙碌后的一个清晨。
`## 经过`	按时间、地点或事件顺序写关键片段	出门、路上看到的事、临时改变计划。
`## 感受`	当时的情绪和现在回看的理解	平静、释然、遗憾或仍未想清的问题。
`## 后记`	过一段时间后的补充或变化	后来又去了一次，想法发生了什么变化。