困扰的问题
hugo 博客搭建好后,陆陆续续发现一些问题。大都成功进行了处理。
其中一个最头大的问题就是:文章更新时间异常。
每次更新文章后,本地显示所有文章更新时间正常,没有修改的还是保留旧的更新日期,而通过 github action|vecel
自动部署后,所有文章更新时间都会改为最新此次更新时间,那些此次没有做修改的文章也一并全部更新。
注意,不是发表时间,发表时间没有问题。
这个 bug,花费了我很多时间精力才找到原因,终于解决了这个问题。
hugo 时间字段
解决这个问题,我们先说 hugo 博客的几个时间字段说起。
hugo 全局配置文件为 config.toml/yaml/json
在 hugo 中日期(时间)是非常重要的字段,hugo 的官方配置文档 configuration
(https://gohugo.io/getting-started/configuration/#configure-dates) 提供一个配置日期的 section [frontmatter]
publishDate
: 变量,发表日期expiryDate
:变量,有效期lastmod
:变量,最后修改日期:git
:git 文件提交修改时间
这是官方列举的字段和基本配置,不过说明不是很详细。
这里说明一下,=
左边的是变量,右边中括号的是变量值,需要在对应模板里添加后才生效。
最后更新时间
这里我们只探讨最后更新时间 lastmod
一般主题里的配置方式是这样:
:git
:git 文件提交修改时间:fileModTime
:文件修改时间lastmod
:文章里 lastmod 字段:defalut
:默认时间
这里 lastmod
变量获取,以 git 文件提交修改时间,文件修改时间这样排,文章里 "lastmod
“字段可不加,这样是没问题的。
我的博客就是以此配置为准,本地运行时,更新时间显示正常。
- 如果要加”
lastmod
“字段,在创建文章模板里添加以下一行。添加”lastmod
",有个好处就是可自由修改这个字段的时间。
hugo 默认位置为 archetypes/default.md
或者主题下目录下 xx主题/archetypes/posts.md
,主题目录下如果有增加模板,创建时会以主题目录下的模板来创建。
- 然后再去
config.toml/yaml/json
调整这里顺序即可:
问题解决
好了,按以上配置,本地运行时,更新时间显示正常,这没有任何问题。
问题来了,通过 GitHub action 部署后(我的 verccel 从 GitHub 直接同步过去),就出现问题了,每次一提交更新,会把所有文章时间都更为最新。
本地端没问题,说明问题就出在 GitHub action 部署过程了。
补充提示一下,有一个坑 : GitHub action 的 Schedule 运行不准时
GitHub action 上的默认配置时间有个坑,设定的 schedule 是 UCT 时间的 08:00,比北京时间快 8 个小时。因此运行环境要改为北京时间。
解决方法:
0. 填坑
在.github/workflows/xx.yml
yml 文件中添加 2 行设置当前环境时区
1. 开启 gitinfo
config.toml/yaml/json
2. gihutb action 里 yaml 上配置
建构前新增以下配置,主要是 quotePath,默认情况下,文件名包含中文时,git 会使用引号吧文件名括起来,这会导致 action 中无法读取:GitInfo
变量,所以要设置 Disable quotePath
[^1]
使用 checkout
的话 fetch-depth
需要设为 0,depth 默认是为 1,默认只拉取分支最近一次 commit,可能会导致一些文章的 GitInfo
变量无法获取,设为 0 代表拉去所有分支所有提交。
以下是我最终的 yml 配置文件
参考:
没有评论:
发表评论