内容视图模板

以下是内容视图的常见用例：

• 您希望首页显示所有类型的内容，但只显示有限的 摘要视图 。
• 您只希望在 分类模板 中显示内容的项目符号列表。视图通过将每种不同类型内容的呈现委托给内容本身，使这变得非常简单。

创建内容视图

要创建一个新视图，请在您不同内容类型目录中的每一个目录中创建一个具有视图名称的模板。以下示例包含 posts 和 project 内容类型的“li”视图和“summary”视图。正如您所看到的，它们位于 单个模板 single.html 旁边。您甚至可以为给定类型提供特定视图，并继续使用 _default/single.html 作为主视图。

  ▾ layouts/
    ▾ posts/
        li.html
        single.html
        summary.html
    ▾ project/
        li.html
        single.html
        summary.html

将呈现哪个模板？

以下是按特异性排序的内容视图查找顺序。

1. /layouts/<TYPE>/<VIEW>.html
2. /layouts/<SECTION>/<VIEW>.html
3. /layouts/_default/<VIEW>.html
4. /themes/<THEME>/layouts/<TYPE>/<VIEW>.html
5. /themes/<THEME>/layouts/<SECTION>/<VIEW>.html
6. /themes/<THEME>/layouts/_default/<VIEW>.html

示例：列表中的内容视图

list.html

在这个示例中， .Render 传递到模板中以调用 渲染函数 。 .Render 是一个特殊函数，它指示内容使用提供的视图模板自身进行渲染，作为第一个参数。在本例中，模板将渲染如下所示的 summary.html 视图：

<main id="main">
  <div>
    <h1 id="title">{{ .Title }}</h1>
    {{ range .Pages }}
      {{ .Render "summary" }}
    {{ end }}
  </div>
</main>

summary.html

Hugo 将 Page 对象传递到以下 summary.html 视图模板。

<article class="post">
  <header>
    <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
    <div class="post-meta">{{ .Date.Format "Mon, Jan 2, 2006" }} - {{ .FuzzyWordCount }} Words </div>
  </header>
  {{ .Summary }}
  <footer>
  <a href='{{ .RelPermalink }}'>Read&nbsp;more&nbsp;&raquo;</a>
  </footer>
</article>

li.html

继续前面的示例，我们可以通过更改对 .Render 函数的调用的参数（即 {{ .Render "li" }} ）来更改我们的渲染函数以使用较小的 li.html 视图。

<li>
  <a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a>
  <div class="meta">{{ .Date.Format "Mon, Jan 2, 2006" }}</div>
</li>