Hugo主题Stack和评论Giscus

昨晚心血来潮，决定给尘封已久的博客换个主题。之前装的是PaperMod，现在换成了Stack。上次装完PaperMod之后，只是生成了个示例站，对hugo很多内容和操作都不太熟悉。这次趁着刚弄完，写点操作流程以作记录。

本体安装

通过git submodule的方式安装在themes目录下。Hugo module的方式也可以，官方教程(https://stack.jimmycai.com/guide/getting-started)，区别不大。

1

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

自定义设置

将themes/hugo-theme-stack/exampleSite目录下content文件夹拷贝到根目录（post文件夹不需要，因为post文件夹是我们另创建的博文）。
将config.yaml复制并替换根目录下的同名文件。这个文件是总配置项，按官方主题stack的要求来修改。
修改比如头像、图标等图片类，js、ts文件等代码类，按照themes/hugo-theme-stack下对应的目录结构，在根目录创建相同层级的同名文件，在新创建的同名文件中进行修改。这种修改方式便于后期维护和升级，较为推荐。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


.
├── LICENSE
├── README.md
├── assets
│   ├── icons
│   ├── img
│   └── ts
├── config.yaml
├── content
│   ├── categories
│   ├── page
│   │   ├── about
│   │   ├── archives
│   │   ├── links
│   │   └── search
│   └── post
├── i18n
├── layouts
└── themes
    └── hugo-theme-stack

有些文件和文件夹是生成网页时自动产生的内容，所以不需要创建，在.gitignore文件里直接忽略即可。

1
2
3
4
5
6
7


# Generated files by hugo
public/*
resources/*
assets/jsconfig.json

# Temporary lock file while building
.hugo_build.lock

评论系统Giscus

比较流行的开源、免费的知名项目有utterances和giscus，我选的是giscus。按照官方教程(https://giscus.app/zh-CN)安装，然后将配置导入到config.yaml里。该评论系统全程托管在GitHub Discussions里，非常省心省力。

结语

写了些基础的东西，美化那些更耗费时间的东西还没弄，网上有很多很好的美化文章，有时间慢慢弄起来。本文参考如下：