Parent
section 是指頂層內容目錄,或是任何包含 _index.md 檔案的內容目錄。
考慮這個內容結構:
content/
├── auctions/
│ ├── 2023-11/
│ │ ├── _index.md <-- 父版塊: auctions
│ │ ├── auction-1.md
│ │ └── auction-2.md <-- 父版塊: 2023-11
│ ├── 2023-12/
│ │ ├── _index.md
│ │ ├── auction-3.md
│ │ └── auction-4.md
│ ├── _index.md <-- 父版塊: home
│ ├── bidding.md
│ └── payment.md <-- 父版塊: auctions
├── books/
│ ├── _index.md <-- 父版塊: home
│ ├── book-1.md
│ └── book-2.md <-- 父版塊: books
├── films/
│ ├── _index.md <-- 父版塊: home
│ ├── film-1.md
│ └── film-2.md <-- 父版塊: films
└── _index.md <-- 父版塊: nil
在上述示例中,請注意首頁的父版塊為 nil。在調用父版塊 Page
對象的方法之前,應進行防禦性檢查,確保該父版塊存在。如果要創建到當前頁面父版塊的鏈接,可以使用如下代碼:
{{ with .Parent }}
<a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a>
{{ end }}