首页模板
首页模板是构建站点时唯一必需的模板,因此在引导新站点和模板时非常有用。如果您正在开发单页网站,它也是唯一必需的模板。
首页模板查找顺序
参见 模板查找 。
向首页添加内容和前置内容
首页接受来自 _index.md
文件的内容和前置内容。此文件应位于您的 content
文件夹的根目录(即 content/_index.md
)。然后,您可以像处理任何其他内容文件一样,向您的首页添加正文内容和元数据。
有关 _index.md
在向列表页面添加内容和前置内容中的作用的更多信息,请参见下面的首页模板或 内容组织 。
首页模板示例
layouts/_default/home.html
{{ define "main" }}
<main aria-role="main">
<header class="home-page-header">
<h1>{{ .Title }}</h1>
{{ with .Params.subtitle }}
<span class="subtitle">{{ . }}</span>
{{ end }}
</header>
<div class="home-page-content">
<!-- 请注意,index.html 的内容(作为一种列表页面)将从 content/_index.md 中提取 -->
{{ .Content }}
</div>
<div>
{{ range first 10 .Site.RegularPages }}
{{ .Render "summary" }}
{{ end }}
</div>
</main>
{{ end }}