1.hugo博客的文章规范
Markdown 写作格式：
---
title: "{{ replace .Name "-" " " | title }}"
description: "{{ .Name }}"
keywords: "{{replace .Name "-" ","}}"
date: {{ .Date }}
lastmod: {{ .Date }}
math: false
mermaid: false
categories:
-
tags:
-
-
---
{{ replace .Name "-" " " | title }}
格式说明：
前置元数据（Front Matter）部分：
title- 文章标题（自动从文件名生成）description- 文章描述（自动从文件名生成）keywords- 文章关键词（自动从文件名生成，用逗号分隔）date- 文章发布日期lastmod- 文章最后修改日期math- 是否启用数学公式（boolean）mermaid- 是否启用 Mermaid 图表（boolean）categories- 文章分类（列表）tags- 文章标签（列表）
正文部分：
- 自动生成的标题
<!--more-->- 摘要分割线，这行之前的内容将作为文章摘要显示在列表页
2.创建博客的注意事项
当你需要使用他人的模板，一般都会使用子模板来引入作者的仓库，如果你需要自己定义，需要将子模板取消并入自己的总仓库内。 当前你在 /d/blog 主仓库，子模块已初始化但无本地修改。
1. 删除子模块的 Git 元数据，但保留实际文件
cd /d/blog
# 1. 把子模块里的 .git 文件夹移动走（或者直接删除，但为了安全先备份）
mv themes/reimu/.git themes/reimu/.git.bak
# 2. 从主仓库的 Git 索引中移除子模块记录（但不删除实际文件）
git rm --cached themes/reimu
执行 git rm --cached 后，themes/reimu 这个路径会变成未跟踪的文件（因为之前是子模块，现在 .git 没了，Git 看到的是普通文件夹）。
2. 把主题文件正式加入主仓库
# 将 themes/reimu 下的所有文件加入 Git 索引
git add themes/reimu/
# 查看状态，确认 themes/reimu 变成了普通文件
git status
此时你应该看到类似：
text
new file: themes/reimu/...
3. 清理子模块配置
# 删除 .gitmodules 文件（如果存在）
rm -f .gitmodules
# 从 .git/config 中删除子模块配置（可选，因为无影响）
git config --remove-section submodule.themes/reimu 2>/dev/null
4. 提交变更
git commit -m "将主题解除子模块状态，成为仓库直接内容"
5. 推送到你自己的远程仓库
git push origin main
6. （可选）删除备份的 .git.bak
确认一切正常后：
bash```
rm -rf themes/reimu/.git.bak
日常调试
如果你需要在本地调试网站，下载hugo的官方程序，在博客文件夹的根目录运行hugo server即可在本地启动服务器，默认地址为：http://localhost:1313/
背景图的设置
存储在static/covers文件夹中，使用时使用相对路径：“covers/文件名.后缀”，同时如果需要添加新的图片，需要在根目录的data/covers.yml里加入新配置。