博客内容发布与维护操作指南
本文档旨在规范 Miles’ Archive 博客的内容更新流程，提供关于文章（Post）与动态（Moment）的标准化写作规范、元数据（Front Matter）配置说明，以及代码仓库（GitHub）的提交流程。
1. 核心概念与路径规范
基于 Hugo 静态站点生成器的架构，博客的所有文字内容均作为 Markdown (.md) 文件存储于特定的文件树节点中。文件上传至 GitHub 仓库后，Cloudflare Pages 将自动触发构建并更新线上环境。
1.1 文件分类与存储路径
博客内容分为两种独立类型，需严格存放于对应的 GitHub 目录中：
-
长篇文章（Posts）
- 定义：结构化、篇幅较长的博客文章，通常包含完整的标题、分类、标签与多级标题。
- GitHub 目标路径：
content/posts/ - 文件命名规范：使用英文小写字母与连字符组合，必须以
.md结尾。例如：my-python-learning-notes.md。避免在文件名中使用空格或特殊符号。
-
碎片动态（Moments）
- 定义：短篇幅、类似社交媒体的时间线动态，记录即时想法或短内容。
- GitHub 目标路径：
content/moments/ - 文件命名规范：建议按日期或核心关键词命名，以保证排序。例如：
2026-08-01-daily-thought.md。
2. 元数据（Front Matter）参数详解
每个 Markdown 文件的顶部必须包含一块以 +++ 包裹的区域，被称为 Front Matter。当前站点使用 TOML 语法解析此区域。该区域不显示在文章正文中，但控制着网页的生成逻辑（如标题、时间、标签归属、是否可见）。
2.1 结构示例
+++
title = "这里是文章的标题"
date = "2026-08-01T13:41:29+09:00"
draft = false
tags = ["Python", "随笔"]
+++
2.2 核心参数说明
编写 +++ 与 +++ 之间的内容时，必须遵守严格的键值对（Key-Value）数据类型：
| 参数名 | 数据类型 | 填写说明与约束条件 |
|---|---|---|
title |
字符串 (String) | 网页及列表中显示的主标题。必须使用双引号包裹，如 "学习笔记"。对于部分动态（Moments），如果模板不需要显示标题，该项留空或保留默认即可。 |
date |
日期时间 (Datetime) | 决定文章在列表中的排序依据。标准格式推荐使用 YYYY-MM-DD（如 "2026-08-01"）或 ISO 8601 标准包含时间与时区（如 "2026-08-01T13:41:29+09:00"）。无需加双引号。 |
draft |
布尔值 (Boolean) | 控制内容是否在线上环境显示。填 true 为草稿模式（上传至 GitHub 后不会被 Cloudflare 构建并展示），填 false 为正式发布。无需加双引号。 |
tags |
字符串数组 (Array) | 用于生成侧边栏或底部的“标签云”。支持多标签，需用中括号包裹，各项用逗号与双引号分隔，如 ["技术", "生活"]。空标签写为 []。 |
严格语法警告： TOML 语法对格式极为敏感。参数名必须全小写；除了布尔值和日期，字符串内容必须包含在英文状态的双引号中；每行仅书写一个参数；
+++符号必须独占首行和末行，且前后不能有空格。