这是第一篇文章,用来验证主题、代码高亮、目录和构建流程是否都正常。你可以直接删掉它,或者把它改造成自己的第一篇文章。

为什么要自己搭博客

平台写作省心,但内容、排版和访问速度都受制于人。静态站点只产出一堆 HTML,托管在 CDN 上,打开快、几乎不会挂、也几乎不花钱。

怎么写文章

新建

hugo new content posts/我的文章.md

新文件默认是 draft: true,写完把 draft 改成 false 再推送才会发布。

本地预览

hugo server -D

打开 http://localhost:1313,-D 表示连草稿一起渲染。改文件会实时刷新。

发布

git add -A && git commit -m "post: 我的文章" && git push

推送后 Cloudflare Pages 会自动构建,一分钟左右线上就能看到。

代码高亮效果

package main

import "fmt"

func main() {
	fmt.Println("hello, hugo")
}

常用 front matter

字段作用
title标题
date发布日期,决定排序
drafttrue 时只在 -D 预览,不会发布
tags / categories标签与分类,自动生成归档页
summary列表页摘要,不写则自动截取正文
cover.image封面图,放在同目录下写相对路径

提示:标题层级从 ## 开始写,目录(TOC)会自动抓取二级和三级标题。

接下来

  • 把 hugo.toml 里的 baseURL、title、首页介绍改成自己的
  • 建 GitHub 仓库并推送
  • 在 Cloudflare Pages 里连上仓库,构建命令 hugo --gc --minify,输出目录 public