搭建你的第一个博客

安装Hugo

说实话，我也是刚刚才会搭建Hugo博客，然后就来教别人了。这个的感觉就很像这个博主失踪的博客的开头一样。

以windows操作系统为例，我们需要先下载Chocolatey软件包管理器（点击此链接前往下载地址），然后复制此行命令。

按住win+X键，选择以管理员模式运行powershell，运行此命令。

官方说不要用Windows Powershell，要用Powershell，说它们是两个不同的东西，但是我用了Windows Powershell却并没有出现任何的报错。目前还不清楚这其中的原因。

然后执行安装hugo的命令

1

choco install hugo-extended

安装完以后可以用下面的命令查看hugo版本，检测是否安装成功

1

hugo version

安装Hugo Stack主题

Hugo的主题是需要自己选的。在Hugo的众多主题里面，我特别喜欢Stack的Card-Style风格，所以我就使用了Hugo Stack主题。我们可以前往Github下载Hugo Stack的模板，然后自己修改。

修改好了后在文件夹下运行此命令

1

hugo server

他会提示你访问一个链接，默认是http://localhost:1313/。如果能看到的话就说明你成功了

部署到Github

可能是stack-starter的deploy文件有点小问题，或者是我太菜了没有调好。反正只能部署一次，然后我push上去GitHub后就不能更新。所以只能用这个折中的方法。

打开你的GitHub repo，然后找到settings，翻到Pages这一页面。选择Source为Deploy from a branch。选择你的主分支，然后选择/docs文件夹。

然后翻到你的Hugo项目的config文件config.toml，加上这一行publishDir = "docs"。如下

1
2
3
4


baseurl = "https://euuen.github.io/"
languageCode = "zh-cn"
title = "一秋落木"
publishDir = "docs"

然后就可以了。

部署Giscus评论系统

确保你的项目开了Discussions功能，然后前往giscus官网，按照他的提示输入。你可以参考Vitepress部署Giscus的方法。这里不在赘述了，网上很多教程。获取到相应的参数就行

然后找到这个文件/config/_defalut/params.toml，把comment项改为

1
2
3


[comments]
enabled = true
provider = "giscus"

然后把giscus那项的参数都填上，不要忘记在加上enabled = true，如下

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


[comments.giscus]
enabled = true
repo = "euuen/euuen.github.io"
repoID = "R_kgDONltvFw"
category = "Announcements"
categoryID = "DIC_kwDONltvF84CovmA"
mapping = "pathname"
theme = "preferred_color_scheme"
lang = "zh-CN"
loading = "lazy"
reactionsEnabled = 1
emitMetadata = 0

然后，恭喜你，你也有了自己的评论系统了！！

Photo by Keila Hötzel on Unsplash