博客使用指南：如何写作与发布

这篇文章就是本站的"说明书"，忘了流程随时回来看。

1. 新建一篇文章

在 D:\MyBlog 目录下执行：

1

hugo new content posts/我的新文章/index.md

生成的文件开头有一段 front matter（两行 --- 之间的部分）：

1
2
3
4
5
6
7
8
9

---
title: "我的新文章"   # 标题
date: 2026-09-10T16:30:00+08:00
draft: true            # 改成 false 才会发布
description: "一句话摘要，会显示在列表和搜索里"
tags: ["标签A", "标签B"]
categories: ["分类"]
featured_image: "cover.jpg"   # 可选：封面图（放在同目录下）
---

2. 插入图片

每篇文章是一个独立的文件夹（Page Bundle），图片直接放在文章旁边即可：

1
2
3
4

content/posts/我的新文章/
├── index.md
├── cover.jpg      ← 封面图
└── screenshot.png ← 正文配图

正文中引用：![截图说明](screenshot.png)

3. 本地预览

1

hugo server -D

打开 http://localhost:1313 实时预览，保存即刷新。-D 表示连草稿（draft: true）一起显示。

4. 发布

1
2
3

git add -A
git commit -m "新增文章：我的新文章"
git push

push 之后 GitHub Actions 会自动构建并发布到 GitHub Pages，大约一分钟后生效。

5. 常用管理操作

FixIt 主题的配置在 config/_default/ 目录下：

• 改博客标题：编辑 hugo.toml 的 title
• 改站点描述：编辑 params.toml 的 description
• 改首页作者卡片（名字、一句话、社交链接）：编辑 params.toml 的 [author]、[home.profile]、[social]
• 改导航菜单：编辑 menus.toml
• 改外观功能（明暗主题、代码块、目录、搜索等）：编辑 params.toml
• 放头像：图片放到 assets/img/avatar.png，在 params.toml 的 [author] 里加一行 avatar = "img/avatar.png"
• 升级主题：git submodule update --remote themes/FixIt（升级后需本地构建验证）
• 本地完整构建测试：hugo --minify，结果输出到 public/ 目录