一个内容块Section由基于content/目录下的组织结构而定义的页面集合.

默认情况下, 在content/目录下的第一级目录构成它们自己的内容块(根块)

If a user needs to define a section foo at a deeper level, they need to create a directory named foo with an _index.md file (see Branch Bundles for more information). 如果用户需要在更深层定义n内容块,比如foo, 那么需要创建一个名为foo的目录并创建一个_index.md文件(参考 Branch Bundles获得更多信息)

嵌套块

内容块可以在任意深度嵌套

1
2
3
4
5
6
7
8

content
└── blog        <-- 内容块，因为是content/下第一级目录
    ├── funny-cats
    │   ├── mypost.md
    │   └── kittens         <-- 内容块 包含 _index.md
    │       └── _index.md
    └── tech                <-- 内容块 包含 _index.md
        └── _index.md

The important part to understand is, that to make the section tree fully navigational, at least the lower-most section needs a content file. (e.g. _index.md). 需要记住的最重要的是, 为了使内容块可以完全导航, 至少最底层的块需要一个内容文件(比如,_index.md).

例子: 面包屑导航

With the available section variables and methods you can build powerful navigation. One common example would be a partial to show Breadcrumb navigation:

内容块提供了块页面变量和方法，使用这些变量和方法您可以构建强大的页面导航. 一个常见例子是显示面包屑导航的部分模板:

layouts/partials/breadcrumb.html
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


<ol  class="nav navbar-nav">
  {{ template "breadcrumbnav" (dict "p1" . "p2" .) }}
</ol>
{{ define "breadcrumbnav" }}
{{ if .p1.Parent }}
{{ template "breadcrumbnav" (dict "p1" .p1.Parent "p2" .p2 )  }}
{{ else if not .p1.IsHome }}
{{ template "breadcrumbnav" (dict "p1" .p1.Site.Home "p2" .p2 )  }}
{{ end }}
<li{{ if eq .p1 .p2 }} class="active"{{ end }}>
  <a href="{{ .p1.Permalink }}">{{ .p1.Title }}</a>
</li>
{{ end }}

块页面变量和方法

也请参考页变量.

.CurrentSection
The page’s current section. The value can be the page itself if it is a section or the homepage.
.FirstSection
The page’s first section below root, e.g. /docs, /blog etc.
.InSection $anotherPage
Whether the given page is in the current section.
.IsAncestor $anotherPage
Whether the current page is an ancestor of the given page.
.IsDescendant $anotherPage
Whether the current page is a descendant of the given page.
.Parent
A section’s parent section or a page’s section.
.Section
The section this content belongs to. Note: For nested sections, this is the first path element in the directory, for example, /blog/funny/mypost/ => blog.
.Sections
The sections below this content.

内容块列表 Content Section Lists

Hugo自动为每一个根块创建页面，页面上列出了本块包含的内容. 参考块模板获得定制呈现这些页面的细节.

Content Section vs Content Type

缺省情况下, 在内容块内创建的任何内容都使用和 root section 根块 名称匹配的 内容 类型. 比如hugo会假设posts/post-1.md具有posts 内容 type. 如果对于posts块使用了archetype，Hugo会从archetypes/posts.md原型中创建内容的前言设定.