我永远讨厌机器语言

建站

2025.03.26 · 本文阅读量次

好吧，这不是真的，机器语言还是很简洁优美的，不够简洁的是我。

实不相瞒，接触hugo没多久我就后悔了……放弃wordpress最主要的原因是嫌弃它的免费themes太丑——如果你使用英文写作，那么你可以找到很多漂亮的theme，但它们对中文的适应都是灾难，常常我点开一个theme，马上就想把我的眼珠子抠下来——但是我忽略了一件事，像hugo这样的静态建站工具，不懂代码的我能做出来的东西只会更丑。

但，省略掉中间面目狰狞的过程，拜许多热心象友所赐，这个网站还是做出来了。

做网站的时候我想，呵，建站日志是什么东西，也配让我花时间？但是在一次又一次屁滚尿流地修改代码之后我意识到，我有必要写一下changelog，至少至少，建站后的第一篇日志要写。

我用的theme是zozo：https://github.com/varkai/hugo-theme-zozo，因为版本问题fork不过来，这一步是象友帮我解决的，鸣谢象友。

建站过程中遇到的问题包括：

1、无法push到repo
- 看的好几个教程都提到需要在push origin之后把deployment从deploy from a branch改成github actions，修改后使用以下命令行进行push：
- ```
1git add -A
2git commit -m ""
3git push
```
- 但我每次这样操作repo都没有办法更新——可以看到code已经update，但是没有Action，网页上也是什么变化也没有。苦恼了好几个小时，最后改回deploy from a branch就好了。
2、CSS文件丢失
- hugo server是好的，一旦push到repo就会失去全部css样式，这一步也是在象友的帮助下成功debug的。参考：Hugo部署与踩坑
- css丢失存在两个问题，一是baseURL错误，这个很简单修改一下hugo.toml就好了。另一个是https报错导致的css文件读取失败，按照象友博文中的解决方法，在/layouts/partials/head.html中增加一行：
```
1
2<meta http-equiv="Content-Security-Policy" content="upgrade-insecure-requests" />
3
```
- 就可以了。
- 除了象友博文中提及的两个问题，我还遇到一个新问题：修改baseURL后css文件还是读取不到，console依旧在报错，解决方法：在layouts/partials/head.html中找到：
- ```
1<link rel="stylesheet" type="text/css" media="screen" href="{{ .Site.BaseURL }}css/normalize.css" />
```
- 和
- ```
1<link rel="stylesheet" type="text/css" media="screen" href="{{ "css/zozo.css" |absURL }}" />
```
- 类似的css links，替换为：
- ```
1<link rel="stylesheet" type="text/css" media="screen" href="{{ .Site.BaseURL | default "/" }}css/zozo.css" />
```
- 这个问题是chatgpt帮我解决的，掌声送给gpt。
3、custom css
- css很简单自己瞎几把改就行了，改之前记得把文件复制到mysite/static/css里再改，不然很容易搞乱，此外——动过的代码千万要记得加comments啊！不然会变成猪的！会被吃掉的！

4、添加front matters

参考：PaperMod主题配置
在/archetypes中新建文件posts.md，把这段代码复制进去：

 1---
 2title: "{{ replace .Name "-" " " | title }}"
 3date: {{ .Date }}
 4lastmod: {{ .Date }}
 5author: ["yourname"]
 6
 7categories:
 8- category 1
 9- category 2
10
11tags:
12- tag 1
13- tag 2
14
15description: "" # 文章描述，与搜索优化相关
16summary: "" # 文章简单描述，会展示在主页
17weight: # 输入1可以顶置文章，用来给文章展示排序，不填就默认按时间排序
18slug: ""
19draft: false # 是否为草稿
20comments: true
21showToc: true # 显示目录
22TocOpen: true # 自动展开目录
23autonumbering: true # 目录自动编号
24hidemeta: false # 是否隐藏文章的元信息，如发布日期、作者等
25disableShare: true # 底部不显示分享栏
26searchHidden: false # 该页面可以被搜索到
27showbreadcrumbs: true #顶部显示当前路径
28mermaid: true
29cover:
30    image: ""
31    caption: ""
32    alt: ""
33    relative: false
34---
35
36<!-- more -->

5、添加网站访问统计
- 参考：【Hugo】Hugo添加不蒜子Busuanzi页面浏览次数与阅读数据统计、Hugo 添加访问统计功能
6、添加网站运行时间
- 参考：Hugo博客如何添加网站运行时间？
7、代码高亮
- 参考：Blog养成记(3) Hugo的语法高亮配置、Hugo 代码高亮

还想要很多其他功能但都太超过我目前的能力了，比如：评论系统。目前的样式也有点太极简了，分类和tags都要单独占据一个页面，首页样式极简，结构上却太不极简了，想把他们都放到首页来显示，另一个很受欢迎的theme stack在功能上完全符合我的需求但是stack太卡片式了，一眼望去全是框，不喜欢……主页文章cover和summary的展示方式我也不喜欢，这些都等以后再说吧，我已经累了。

希望接下来不要再写建站日志了，写点废话吧！什么废话都行……

再见！

hugo

終身監禁

我永远讨厌机器语言