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


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

## 1. 新建一篇文章

在 `D:\MyBlog` 目录下执行：

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

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

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

## 2. 插入图片

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

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

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

## 3. 本地预览

```bash
hugo server -D
```

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

## 4. 发布

```bash
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/` 目录


---

> 作者: [wArn](https://github.com/21346asz)  
> URL: https://blog.1urkers.cn/p/blog-guide/