之前一直使用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

受影响的位置：

< < ! m - e - t a h t n m a l m e h = e " a g d e n 部 e 分 r a t o r " c o n t e n t = " H u g o { { . H u g o . V e r s i o n } } " >

替换为：

< < ! m - e - t a h t n m a l m e h = e " a g d e n 部 e 分 r a t o r " c o n t e n t = " H u g o { { h u g o . V e r s i o n } } " >

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 c l a s s = " p a g i n a t i o n - p r e v " h r e f = " { { $ p a g i n a t o r . P r e v . U R L } } " > ← P r e v P a g e < / a >

解决方法：

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

.Page 发生变化

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

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

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

解决方法：

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

强制使用Goldmark

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

在config.toml中添加：

[ m a d r e k f u a p u ] l t M a r k d o w n H a n d l e r = " g o l d m a r k "

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