Hugo 按需求添加文章列表

全站文章列表

在分类页或者内容页里需要显示全部分类文章时使用，在页面模板 single.html 中的适当位置添加如下代码。

<ul>
  {{ $pages := .Pages }}
  {{ $pages = .Site.RegularPages }}
  {{ range (where $pages "Section" "!=" "") }}

  <li>
    <a href="{{ .RelPermalink }}">{{ .Title | markdownify }}</a>
  </li>

  {{ end }}
</ul>

具体某个分类的文章列表

要在内容页添加具体某个分类的文章列表，可在变量.Site.RegularPages后添加限定条件"Section" "XXX"，参考如下。

<ul>
  {{ range where .Site.RegularPages "Section" "XXX" }}
  
  <li>
    <a href="{{ .RelPermalink }}">{{ .Title | markdownify }}</a>    
  </li>

  {{ end }}
</ul>

其中Section是自定义的分类变量，XXX为具体所需指定的分类名称。

文章列表的排列顺序

文章列表的排序默认遵循的优先级为: Weight > Date > LinkTitle > FilePath 。

可通过在 range .Pages.后按需求添加下列的属性来改变列表的排序方式。

变量	描述
`.ByWeight`	根据文章头部设置的`weight: 1`优先级排序, 「weight」值越小排序越靠前。
`.ByDate`	根据文章头部设置的`date: 2019-09-03`创建日期排序, 时间越靠后排序越靠前。
`.Reverse`	可叠加前两个属性使用，也可单独使用，使其倒序排列。