首页也是一个页面, 因此所有的page variables 和 site variables都可以访问.

首页模板查询顺序

参考 Template Lookup.

为首页添加内容和前言设定

首页, 同其他Hugo 列表页类似，可以接受 _index.md 文件里的内容和前言设定. 这个文件应该位于content的根目录(也就是content/_index.md). 然后可以给首页添加主题内容和元数据，和其他内容文件一样。

参考下面的首页模板或者内容组织, 获得更多关于在列表页中添加内容和前言设定时_index.md文件的作用的信息。

首页模板例子

下面是首页模板的例子, 使用了partial, base 模板和位于content/_index.md的内容文件来填充{{.Title}} 和 {{.Content}} 页面变量.

layouts/index.html
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


{{ define "main" }}
    <main aria-role="main">
      <header class="homepage-header">
        <h1>{{.Title}}</h1>
        {{ with .Params.subtitle }}
        <span class="subtitle">{{.}}</span>
        {{ end }}
      </header>
      <div class="homepage-content">
        <!-- Note that the content for index.html, as a sort of list page, will pull from content/_index.md -->
        {{.Content}}
      </div>
      <div>
        {{ range first 10 .Site.RegularPages }}
            {{ .Render "summary"}}
        {{ end }}
      </div>
    </main>
{{ end }}