快速建站-4,撰写第一篇文章与修改文章魔板

经过上面一段操作猛如虎的配置之后,我们来添加个文章看看最终网站的效果吧。

创建关于页面

到网站根目录的地址栏,输入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

开始调试,访问

http://localhost:1313

就能看到网站的样子了,点关于链接,里面就是你刚才写的内容了。

hugo server是正常调试的命令,加上-D就是包括草稿,这里要清楚。

可按ctrl+c停止。

创建文章

这时候不要关掉调试,在新开命令行在创建个文章试试。

所有的文章都在content下的posts文件夹,所以输入

hugo new posts/hello world.md

同样,写一些内容保存,这时候浏览器刷新就会发现刚写的文章就出来了,hugo的调试是支持实时刷新的。

注:文章所有需要的图片、音乐、视频等,如果是随博客一起上传的请放到网站根目录的static文件夹,添加图片的时候,如果有图片的位置是static/img/image.jpg,写图片的时候就也可以用相对路径,但路径不要包含static,及

![图片](img/image.jpg)

文章魔板

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文件夹太麻烦,可以使用文件同步工具,这样你本地做出修改的时候,就可以自动把文件同步到服务器上,只要开起来,你配置好几乎啥都不用做了。具体教程可以去小羔羊的站点查看,有详细的教程,这里就不多说了。


下篇文章我们来讲怎么给博客开启评论系统。

上一篇:
下一篇: