mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-07 20:30:36 -05:00
parent
7874b96815
commit
3a216186b2
7 changed files with 38 additions and 12 deletions
|
@ -64,18 +64,15 @@ With the available [section variables and methods](#section-page-variables-and-m
|
|||
|
||||
{{< code file="layouts/partials/breadcrumb.html" download="breadcrumb.html" >}}
|
||||
<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" aria-current="page" {{ end }}>
|
||||
<a href="{{ .p1.Permalink }}">{{ .p1.Title }}</a>
|
||||
<ul>
|
||||
{{- range .Ancestors.Reverse }}
|
||||
<li><a href="{{ .Permalink }}">{{ .Title }}</a></li>
|
||||
{{- end }}
|
||||
<li class="active" aria-current="page">
|
||||
<a href="{{ .Permalink }}">{{ .Title }}</a>
|
||||
</li>
|
||||
{{ end }}
|
||||
</ul>
|
||||
</ol>
|
||||
{{< /code >}}
|
||||
|
||||
## Section Page Variables and Methods
|
||||
|
|
|
@ -32,6 +32,9 @@ See [`.Scratch`](/functions/scratch/) for page-scoped, writable variables.
|
|||
.Aliases
|
||||
: aliases of this page
|
||||
|
||||
.Ancestors
|
||||
: get the ancestors of each page, simplify [breadcrumb navigation]({{< relref "content-management/sections#example-breadcrumb-navigation" >}}) implementation complexity
|
||||
|
||||
.BundleType
|
||||
: the [bundle] type: `leaf`, `branch`, or an empty string if the page is not a bundle.
|
||||
|
||||
|
|
|
@ -178,6 +178,15 @@ func (pt pageTree) Parent() page.Page {
|
|||
return b.p
|
||||
}
|
||||
|
||||
func (pt pageTree) Ancestors() (parents page.Pages) {
|
||||
parent := pt.Parent()
|
||||
for parent != nil {
|
||||
parents = append(parents, parent)
|
||||
parent = parent.Parent()
|
||||
}
|
||||
return
|
||||
}
|
||||
|
||||
func (pt pageTree) Sections() page.Pages {
|
||||
if pt.p.bucket == nil {
|
||||
return nil
|
||||
|
|
|
@ -181,12 +181,14 @@ PAG|{{ .Title }}|{{ $sect.InSection . }}
|
|||
c.Assert(err, qt.IsNil)
|
||||
c.Assert(active, qt.Equals, true)
|
||||
c.Assert(p.FirstSection(), qt.Equals, p)
|
||||
c.Assert(len(p.Ancestors()), qt.Equals, 1)
|
||||
}},
|
||||
{"l1", func(c *qt.C, p page.Page) {
|
||||
c.Assert(p.Title(), qt.Equals, "L1s")
|
||||
c.Assert(len(p.Pages()), qt.Equals, 4) // 2 pages + 2 sections
|
||||
c.Assert(p.Parent().IsHome(), qt.Equals, true)
|
||||
c.Assert(len(p.Sections()), qt.Equals, 2)
|
||||
c.Assert(len(p.Ancestors()), qt.Equals, 1)
|
||||
}},
|
||||
{"l1,l2", func(c *qt.C, p page.Page) {
|
||||
c.Assert(p.Title(), qt.Equals, "T2_-1")
|
||||
|
@ -195,6 +197,7 @@ PAG|{{ .Title }}|{{ $sect.InSection . }}
|
|||
c.Assert(p.Parent().Title(), qt.Equals, "L1s")
|
||||
c.Assert(p.RelPermalink(), qt.Equals, "/l1/l2/")
|
||||
c.Assert(len(p.Sections()), qt.Equals, 1)
|
||||
c.Assert(len(p.Ancestors()), qt.Equals, 2)
|
||||
|
||||
for _, child := range p.Pages() {
|
||||
if child.IsSection() {
|
||||
|
@ -237,6 +240,7 @@ PAG|{{ .Title }}|{{ $sect.InSection . }}
|
|||
c.Assert(p.Pages()[0].File().Path(), qt.Equals, filepath.FromSlash("l1/l2_2/page_2_2_1.md"))
|
||||
c.Assert(p.Parent().Title(), qt.Equals, "L1s")
|
||||
c.Assert(len(p.Sections()), qt.Equals, 0)
|
||||
c.Assert(len(p.Ancestors()), qt.Equals, 2)
|
||||
}},
|
||||
{"l1,l2,l3", func(c *qt.C, p page.Page) {
|
||||
nilp, _ := p.GetPage("this/does/not/exist")
|
||||
|
@ -245,6 +249,7 @@ PAG|{{ .Title }}|{{ $sect.InSection . }}
|
|||
c.Assert(len(p.Pages()), qt.Equals, 2)
|
||||
c.Assert(p.Parent().Title(), qt.Equals, "T2_-1")
|
||||
c.Assert(len(p.Sections()), qt.Equals, 0)
|
||||
c.Assert(len(p.Ancestors()), qt.Equals, 3)
|
||||
|
||||
l1 := getPage(p, "/l1")
|
||||
isDescendant, err := l1.IsDescendant(p)
|
||||
|
@ -307,6 +312,7 @@ PAG|{{ .Title }}|{{ $sect.InSection . }}
|
|||
}
|
||||
|
||||
c.Assert(home, qt.Not(qt.IsNil))
|
||||
c.Assert(len(home.Ancestors()), qt.Equals, 0)
|
||||
|
||||
c.Assert(len(home.Sections()), qt.Equals, 9)
|
||||
c.Assert(s.Info.Sections(), deepEqualsPages, home.Sections())
|
||||
|
|
|
@ -407,6 +407,9 @@ type TreeProvider interface {
|
|||
// To get a section's subsections, see Page's Sections method.
|
||||
Parent() Page
|
||||
|
||||
// Ancestors returns the ancestors of each page
|
||||
Ancestors() Pages
|
||||
|
||||
// Sections returns this section's subsections, if any.
|
||||
// Note that for non-sections, this method will always return an empty list.
|
||||
Sections() Pages
|
||||
|
|
|
@ -348,6 +348,10 @@ func (p *nopPage) Parent() Page {
|
|||
return nil
|
||||
}
|
||||
|
||||
func (p *nopPage) Ancestors() Pages {
|
||||
return nil
|
||||
}
|
||||
|
||||
func (p *nopPage) Path() string {
|
||||
return ""
|
||||
}
|
||||
|
|
|
@ -416,6 +416,10 @@ func (p *testPage) Parent() Page {
|
|||
panic("not implemented")
|
||||
}
|
||||
|
||||
func (p *testPage) Ancestors() Pages {
|
||||
panic("not implemented")
|
||||
}
|
||||
|
||||
func (p *testPage) Path() string {
|
||||
return p.path
|
||||
}
|
||||
|
|
Loading…
Reference in a new issue