Hugo安装和启用Stack主题

Hugo安装与建立新网站

配置环境变量

在这里下载打包好的二进制文件,单文件很方便
https://github.com/gohugoio/hugo/releases
要注意的是Hugo发行版分3种,标准版,extended扩展版,和代deploy功能的extended扩展版
而Stack需要extended扩展版

下好以后配置环境变量PATH到hugo单文件所在的目录,如果可以hugo version即说明它可以工作啦!

2025-02-24-14-43-28

建立一个新站点和Stack主题安装

https://gohugo.io/getting-started/quick-start/
我是直接新建一个目录到里面打开CMD,然后

1
hugo new site .

就会在本地生成好网站目录
初始化git(因为需要用git子模块来拉主题的库)

1
git init

然后加载子模块

1
git submodule add https://github.com/CaiJimmy/hugo-theme-stack/ themes/hugo-theme-stack

主题文档参见:
https://stack.jimmycai.com/guide/getting-started
https://themes.gohugo.io/themes/hugo-theme-stack/

好了,主题的安装文档居然到这里戛然而止了,令人十分费解,前期工作完成后,最后一步启用居然没说,Stack主题发的文档似乎十分希望用户使用这个库来直接开始用主题和hugo:
https://github.com/CaiJimmy/hugo-theme-stack-starter

但我偏不,我不喜欢预制用户用法的做法,我只是希望hugo作为一个生成器,部署要在阿里云OSS上做而不是github pages。

所以摸索了大半天,自己安装的话应当将:
themes\hugo-theme-stack\exampleSite目录下的hugo.yaml文件复制到Hugo根目录并且删除原有的hugo.toml设置文件,注意不是themes\hugo-theme-stack里的config.yaml
如果你想看自带的示例文章可以将themes\hugo-theme-stack\exampleSite下的content覆盖到根目录的同名目录里
之后就可以启动hugo预览了(不加-p参数默认端口为1313)

1
hugo server -D -p 7512

打开浏览器你将会看到:
2025-02-24-15-06-17

恭喜你,开始为博客填内容吧~