内容视图模板

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

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

创建内容视图

要创建新的视图，请在每个不同的内容类型目录中创建具有视图名称的模板。以下示例包含 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 函数。.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>