mirror of https://github.com/gohugoio/hugo
1.7 KiB
1.7 KiB
title | description | categories | keywords | action | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
FirstSection | Returns the Page object of the top level section of which the given page is a descendant. |
|
{{% include "methods/page/_common/definition-of-section.md" %}}
{{% note %}}
When called on the home page, the FirstSection
method returns the Page
object of the home page itself.
{{% /note %}}
Consider this content structure:
content/
├── auctions/
│ ├── 2023-11/
│ │ ├── _index.md <-- first section: auctions
│ │ ├── auction-1.md
│ │ └── auction-2.md <-- first section: auctions
│ ├── 2023-12/
│ │ ├── _index.md
│ │ ├── auction-3.md
│ │ └── auction-4.md
│ ├── _index.md <-- first section: auctions
│ ├── bidding.md
│ └── payment.md <-- first section: auctions
├── books/
│ ├── _index.md <-- first section: books
│ ├── book-1.md
│ └── book-2.md <-- first section: books
├── films/
│ ├── _index.md <-- first section: films
│ ├── film-1.md
│ └── film-2.md <-- first section: films
└── _index.md <-- first section: home
To link to the top level section of which the current page is a descendant:
<a href="{{ .FirstSection.RelPermalink }}">{{ .FirstSection.LinkTitle }}</a>