mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-14 20:37:55 -05:00
9b0050e9aa
git-subtree-dir: docs git-subtree-split: 5c085a37b297bf12f59efeaae591418ec025c10d
1.3 KiB
1.3 KiB
title | description | categories | keywords | action | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Section | Returns the name of the top level section in which the given page resides. |
|
With this content structure:
content/
├── lessons/
│ ├── math/
│ │ ├── _index.md
│ │ ├── lesson-1.md
│ │ └── lesson-2.md
│ └── _index.md
└── _index.md
When rendering lesson-1.md:
{{ .Section }} → lessons
In the example above "lessons" is the top level section.
The Section
method is often used with the where
function to build a page collection.
{{ range where .Site.RegularPages "Section" "lessons" }}
<h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}
This is similar to using the Type
method with the where
function
{{ range where .Site.RegularPages "Type" "lessons" }}
<h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}
However, if the type
field in front matter has been defined on one or more pages, the page collection based on Type
will be different than the page collection based on Section
.