经过上面一段操作猛如虎的配置之后,我们来添加个文章看看最终网站的效果吧。
创建关于页面
到网站根目录的地址栏,输入cmd
,我们先创建一个关于页面,输入
hugo new content/about/_index.md
或
hugo new about/_index.md
这个content/
可加可不加,但要知道所有的独立页面、文章、分类都在content目录下。
这个关于页面属于独立页面,这种独立页面里面的文档都要叫_index.md
,注意下划线,至于独立页面怎么创建,很简单,直接在hugo new
后面加上路径就行了,文件夹会自动创建,但最后的文件一定叫_index.md
至于如何把它显示在首页的我们稍后再说
进入content/about
,打开_index.md你会看到如下内容
+++
date = '2025-09-27T09:39:06+08:00'
draft = true
title = 'about'
+++
我们来一个一个看都是什么意思
-
date:很显然了,就是写作时候的日期,同样如需修改只修改数字,格式别乱动
-
draft:草稿,这里只接受布尔值,及true、false,默认是true,也就是草稿模式,在这种状态下,如果正常生成网站目录,它是不会被显示的,在你正在撰写一篇文章但还没写完的时候就最好开着它。
-
title:这就很明显了吧,就是标题了,默认是文件名,你可以自由修改,不过要在单引号内。
在最后的三个加号后面我们空出一行,然后随便写点什么,保存,命令行应该还没关掉吧,关掉自己打开哈,输入
hugo server -D
开始调试,访问
就能看到网站的样子了,点关于链接,里面就是你刚才写的内容了。
hugo server
是正常调试的命令,加上-D
就是包括草稿,这里要清楚。
可按ctrl+c停止。
创建文章
这时候不要关掉调试,在新开命令行在创建个文章试试。
所有的文章都在content下的posts文件夹,所以输入
hugo new posts/hello world.md
同样,写一些内容保存,这时候浏览器刷新就会发现刚写的文章就出来了,hugo的调试是支持实时刷新的。
注:文章所有需要的图片、音乐、视频等,如果是随博客一起上传的请放到网站根目录的static
文件夹,添加图片的时候,如果有图片的位置是static/img/image.jpg
,写图片的时候就也可以用相对路径,但路径不要包含static
,及

文章魔板
hugo支持很多的front matter,但默认只有标题、日期和草稿,比如想加个分类categories
,总不能每新建个文章都要手动加,这就太麻烦了,这也是有办法的,进入archetypes,打开default.md,我们看里面的内容。
+++
date = '{{ .Date }}'
draft = true
title = '{{ replace .File.ContentBaseName "-" " " | title }}'
+++
日期和标题都不要动,比如我们想加个分类,就在标题下面新开一行,写
categories = ['我的分类']
这样你以后写的所有文章就都自动带这一行了,当然,你也可以让引号内留空,到时候归属于哪个分类自己填写。
或者你觉得每次都要关闭草稿太麻烦,那就直接在这里把草稿关掉,以后创建的文章默认就是关闭草稿的。
draft = false
使用更多的front matter
写博客的话最常用的就是分类和标签了,所以我建议你可以加上。
categories = ['']
tags = ['']
我还会用到slug
,这样的还有很多,可去MemE主题仓库查看。
生成站点
文章都写好后,该发布你的博客了,在网站根目录打开命令行输入hugo
就可以直接生成了,会放在public文件夹,你只需要把这里面的所有文件复制到服务器的网站根目录就可以了,每次有文章更新都要这么做一遍。
文件同步
如果你觉得每次都要重新上传public文件夹太麻烦,可以使用文件同步工具,这样你本地做出修改的时候,就可以自动把文件同步到服务器上,只要开起来,你配置好几乎啥都不用做了。具体教程可以去小羔羊的站点查看,有详细的教程,这里就不多说了。
下篇文章我们来讲怎么给博客开启评论系统。