之前一直使用hugo的0.54版本，近期一不小心本地版本升级到了0.74，运行之后发现疯狂报错。

以下是填坑的记录：

Page.Hugo 方法将被移除

Page.Hugo is deprecated and will be removed in a future release. Use the global hugo function

出现的版本：v0.55

受影响的位置：

<!-- html head 部分 -->
<meta name="generator" content="Hugo {{ .Hugo.Version }}">

替换为：

<!-- html head 部分 -->
<meta name="generator" content="Hugo {{ hugo.Version }}">

Page.Url 方法将被移除

Page.URL is deprecated and will be removed in a future release. Use .Permalink or .RelPermalink. If what you want is the front matter URL value, use .Params.url

出现的版本：v0.55

受影响的位置：

相当多地方，只要包含了这个语法，就需要替换。

<a class="pagination-prev" href="{{ $paginator.Prev.URL }}">← Prev Page</a>

解决方法：

全部替换为 .Permalink （绝对地址），或者 .RelPermalink （相对地址）。

.Page 发生变化

更大的问题是，0.74版本后，首页展示的文章列表全变了。经过查找，发现是0.57版本发生的变化。

新版的 .Page 只返回最高级别的文件目录，我之前的文件组织是 content/post/，现在竟然post变成了一个默认的入口，需要点进去才能看到文章。

请注意这个问题同样会影响到RSS的输出，记得把RSS也改了。

解决方法：

将 .Page 替换为 .Site.RegularPages 。这两者具体的区别见文档。

强制使用Goldmark

之前一直使用最老的mmark，在最新版本中已经要求升级为Goldmark了，切换方法很简单：

在config.toml中添加：

[markup]
  defaultMarkdownHandler = "goldmark"

据说切换了之后会存在一些问题，目前还没有发现。