Author: qytlix(qytlix@gmail.com)

新建站点

hugo new site <site-name>
# 或者可以
hugo new site .

设置gitignore

# .gitignore
public

配置文件

很需要调整的hugo的文件有：

• hugo.toml
• .github/workflows/hugo.yaml
• content/*
• config/*
• data/*

按需求调整即可。

Hint

我这个皮肤需要把博文放在content/post/目录下面才能被检测到post的统计信息中，如果发现统计信息有误，可以尝试更换路径。

Hint

如果有特别的需求，把blog部署到奇怪的地方（例如部署到mysite.com/x），可以参考.github/workflows/hugo.yaml42行，hugo.toml1行、6行。

添加皮肤

git submodule add <好看皮肤的仓库地址>

在hugo.toml中设置theme=<主题名字>。

一般会复制主题中的config和data用于本地配置。

添加blogs

往content文件夹里面塞东西即可。

Warning

hugo需要文章有元数据（front matter），实例如下

---
title: This is title
draft: false
date: 2026-04-08 11:08:03+08:00
categories:
- test
- only for test
tag:
- notag
---

More content

---

Published on 2026-04-19 at qytlix no blogs, last modified on 2026-04-19

]]>Diary