diff --git a/Dockerfile b/Dockerfile
index 6d1bf78c4..a0e34353f 100755
--- a/Dockerfile
+++ b/Dockerfile
@@ -2,8 +2,8 @@
# Twitter: https://twitter.com/gohugoio
# Website: https://gohugo.io/
-ARG GO_VERSION="1.23.2"
-ARG ALPINE_VERSION="3.20"
+ARG GO_VERSION="1.24"
+ARG ALPINE_VERSION="3.22"
ARG DART_SASS_VERSION="1.79.3"
FROM --platform=$BUILDPLATFORM tonistiigi/xx:1.5.0 AS xx
@@ -19,7 +19,7 @@ RUN apk add clang lld
COPY --from=xx / /
ARG TARGETPLATFORM
-RUN xx-apk add musl-dev gcc g++
+RUN xx-apk add musl-dev gcc g++
# Optionally set HUGO_BUILD_TAGS to "none" or "withdeploy" when building like so:
# docker build --build-arg HUGO_BUILD_TAGS=withdeploy .
@@ -72,7 +72,7 @@ RUN mkdir -p /var/hugo/bin /cache && \
adduser -Sg hugo -u 1000 -h /var/hugo hugo && \
chown -R hugo: /var/hugo /cache && \
# For the Hugo's Git integration to work.
- runuser -u hugo -- git config --global --add safe.directory /project && \
+ runuser -u hugo -- git config --global --add safe.directory /project && \
# See https://github.com/gohugoio/hugo/issues/9810
runuser -u hugo -- git config --global core.quotepath false
diff --git a/README.md b/README.md
index e0b3f1567..9befa9c9d 100644
--- a/README.md
+++ b/README.md
@@ -65,9 +65,11 @@ See the [features] section of the documentation for a comprehensive summary of H
-
+
-
+
+
+
## Editions
diff --git a/commands/hugobuilder.go b/commands/hugobuilder.go
index 778d85ca9..3b57ac5e9 100644
--- a/commands/hugobuilder.go
+++ b/commands/hugobuilder.go
@@ -972,6 +972,9 @@ func (c *hugoBuilder) handleEvents(watcher *watcher.Batcher,
lrl.Logf("force refresh")
livereload.ForceRefresh()
}
+ } else {
+ lrl.Logf("force refresh")
+ livereload.ForceRefresh()
}
if len(cssChanges) > 0 {
diff --git a/commands/new.go b/commands/new.go
index fdc1f65f2..81e1c65a4 100644
--- a/commands/new.go
+++ b/commands/new.go
@@ -76,10 +76,8 @@ Ensure you run this within the root directory of your site.`,
&simpleCommand{
name: "site",
use: "site [path]",
- short: "Create a new site (skeleton)",
- long: `Create a new site in the provided directory.
-The new site will have the correct structure, but no content or theme yet.
-Use ` + "`hugo new [contentPath]`" + ` to create new content.`,
+ short: "Create a new site",
+ long: `Create a new site at the specified path.`,
run: func(ctx context.Context, cd *simplecobra.Commandeer, r *rootCommand, args []string) error {
if len(args) < 1 {
return newUserError("path needs to be provided")
@@ -124,11 +122,9 @@ Use ` + "`hugo new [contentPath]`" + ` to create new content.`,
&simpleCommand{
name: "theme",
use: "theme [name]",
- short: "Create a new theme (skeleton)",
- long: `Create a new theme (skeleton) called [name] in ./themes.
-New theme is a skeleton. Please add content to the touched files. Add your
-name to the copyright line in the license and adjust the theme.toml file
-according to your needs.`,
+ short: "Create a new theme",
+ long: `Create a new theme with the specified name in the ./themes directory.
+This generates a functional theme including template examples and sample content.`,
run: func(ctx context.Context, cd *simplecobra.Commandeer, r *rootCommand, args []string) error {
if len(args) < 1 {
return newUserError("theme name needs to be provided")
diff --git a/commands/server.go b/commands/server.go
index 11b43a80f..c8895b9a1 100644
--- a/commands/server.go
+++ b/commands/server.go
@@ -627,7 +627,7 @@ func (c *serverCommand) setServerInfoInConfig() error {
panic("no server ports set")
}
return c.withConfE(func(conf *commonConfig) error {
- for i, language := range conf.configs.Languages {
+ for i, language := range conf.configs.LanguagesDefaultFirst {
isMultihost := conf.configs.IsMultihost
var serverPort int
if isMultihost {
diff --git a/common/collections/append_test.go b/common/collections/append_test.go
index f791b731a..62d9015ce 100644
--- a/common/collections/append_test.go
+++ b/common/collections/append_test.go
@@ -15,6 +15,7 @@ package collections
import (
"html/template"
+ "reflect"
"testing"
qt "github.com/frankban/quicktest"
@@ -77,6 +78,7 @@ func TestAppend(t *testing.T) {
{[]string{"a", "b"}, []any{nil}, []any{"a", "b", nil}},
{[]string{"a", "b"}, []any{nil, "d", nil}, []any{"a", "b", nil, "d", nil}},
{[]any{"a", nil, "c"}, []any{"d", nil, "f"}, []any{"a", nil, "c", "d", nil, "f"}},
+ {[]string{"a", "b"}, []any{}, []string{"a", "b"}},
} {
result, err := Append(test.start, test.addend...)
@@ -146,3 +148,66 @@ func TestAppendShouldMakeACopyOfTheInputSlice(t *testing.T) {
c.Assert(result, qt.DeepEquals, []string{"a", "b", "c"})
c.Assert(slice, qt.DeepEquals, []string{"d", "b"})
}
+
+func TestIndirect(t *testing.T) {
+ t.Parallel()
+ c := qt.New(t)
+
+ type testStruct struct {
+ Field string
+ }
+
+ var (
+ nilPtr *testStruct
+ nilIface interface{} = nil
+ nonNilIface interface{} = &testStruct{Field: "hello"}
+ )
+
+ tests := []struct {
+ name string
+ input any
+ wantKind reflect.Kind
+ wantNil bool
+ }{
+ {
+ name: "nil pointer",
+ input: nilPtr,
+ wantKind: reflect.Ptr,
+ wantNil: true,
+ },
+ {
+ name: "nil interface",
+ input: nilIface,
+ wantKind: reflect.Invalid,
+ wantNil: false,
+ },
+ {
+ name: "non-nil pointer to struct",
+ input: &testStruct{Field: "abc"},
+ wantKind: reflect.Struct,
+ wantNil: false,
+ },
+ {
+ name: "non-nil interface holding pointer",
+ input: nonNilIface,
+ wantKind: reflect.Struct,
+ wantNil: false,
+ },
+ {
+ name: "plain value",
+ input: testStruct{Field: "xyz"},
+ wantKind: reflect.Struct,
+ wantNil: false,
+ },
+ }
+
+ for _, tt := range tests {
+ t.Run(tt.name, func(t *testing.T) {
+ v := reflect.ValueOf(tt.input)
+ got, isNil := indirect(v)
+
+ c.Assert(got.Kind(), qt.Equals, tt.wantKind)
+ c.Assert(isNil, qt.Equals, tt.wantNil)
+ })
+ }
+}
diff --git a/common/collections/slice_test.go b/common/collections/slice_test.go
index 20961aac0..4008a5e6c 100644
--- a/common/collections/slice_test.go
+++ b/common/collections/slice_test.go
@@ -136,3 +136,37 @@ func TestSortedStringSlice(t *testing.T) {
c.Assert(s.Count("z"), qt.Equals, 0)
c.Assert(s.Count("a"), qt.Equals, 1)
}
+
+func TestStringSliceToInterfaceSlice(t *testing.T) {
+ t.Parallel()
+ c := qt.New(t)
+
+ tests := []struct {
+ name string
+ in []string
+ want []any
+ }{
+ {
+ name: "empty slice",
+ in: []string{},
+ want: []any{},
+ },
+ {
+ name: "single element",
+ in: []string{"hello"},
+ want: []any{"hello"},
+ },
+ {
+ name: "multiple elements",
+ in: []string{"a", "b", "c"},
+ want: []any{"a", "b", "c"},
+ },
+ }
+
+ for _, tt := range tests {
+ t.Run(tt.name, func(t *testing.T) {
+ got := StringSliceToInterfaceSlice(tt.in)
+ c.Assert(got, qt.DeepEquals, tt.want)
+ })
+ }
+}
diff --git a/common/collections/stack_test.go b/common/collections/stack_test.go
new file mode 100644
index 000000000..965d4dbc8
--- /dev/null
+++ b/common/collections/stack_test.go
@@ -0,0 +1,77 @@
+package collections
+
+import (
+ "testing"
+
+ qt "github.com/frankban/quicktest"
+)
+
+func TestNewStack(t *testing.T) {
+ t.Parallel()
+ c := qt.New(t)
+
+ s := NewStack[int]()
+
+ c.Assert(s, qt.IsNotNil)
+}
+
+func TestStackBasic(t *testing.T) {
+ t.Parallel()
+ c := qt.New(t)
+
+ s := NewStack[int]()
+
+ c.Assert(s.Len(), qt.Equals, 0)
+
+ s.Push(1)
+ s.Push(2)
+ s.Push(3)
+
+ c.Assert(s.Len(), qt.Equals, 3)
+
+ top, ok := s.Peek()
+ c.Assert(ok, qt.Equals, true)
+ c.Assert(top, qt.Equals, 3)
+
+ popped, ok := s.Pop()
+ c.Assert(ok, qt.Equals, true)
+ c.Assert(popped, qt.Equals, 3)
+
+ c.Assert(s.Len(), qt.Equals, 2)
+
+ _, _ = s.Pop()
+ _, _ = s.Pop()
+ _, ok = s.Pop()
+
+ c.Assert(ok, qt.Equals, false)
+}
+
+func TestStackDrain(t *testing.T) {
+ t.Parallel()
+ c := qt.New(t)
+
+ s := NewStack[string]()
+ s.Push("a")
+ s.Push("b")
+
+ got := s.Drain()
+
+ c.Assert(got, qt.DeepEquals, []string{"a", "b"})
+ c.Assert(s.Len(), qt.Equals, 0)
+}
+
+func TestStackDrainMatching(t *testing.T) {
+ t.Parallel()
+ c := qt.New(t)
+
+ s := NewStack[int]()
+ s.Push(1)
+ s.Push(2)
+ s.Push(3)
+ s.Push(4)
+
+ got := s.DrainMatching(func(v int) bool { return v%2 == 0 })
+
+ c.Assert(got, qt.DeepEquals, []int{4, 2})
+ c.Assert(s.Drain(), qt.DeepEquals, []int{1, 3})
+}
diff --git a/common/constants/constants.go b/common/constants/constants.go
index 3f48f3e4a..c7bbaa541 100644
--- a/common/constants/constants.go
+++ b/common/constants/constants.go
@@ -24,6 +24,7 @@ const (
WarnRenderShortcodesInHTML = "warning-rendershortcodes-in-html"
WarnGoldmarkRawHTML = "warning-goldmark-raw-html"
WarnPartialSuperfluousPrefix = "warning-partial-superfluous-prefix"
+ WarnHomePageIsLeafBundle = "warning-home-page-is-leaf-bundle"
)
// Field/method names with special meaning.
diff --git a/common/hugo/version_current.go b/common/hugo/version_current.go
index d3f68bd85..ba367ceb5 100644
--- a/common/hugo/version_current.go
+++ b/common/hugo/version_current.go
@@ -17,7 +17,7 @@ package hugo
// This should be the only one.
var CurrentVersion = Version{
Major: 0,
- Minor: 146,
- PatchLevel: 4,
- Suffix: "",
+ Minor: 148,
+ PatchLevel: 0,
+ Suffix: "-DEV",
}
diff --git a/common/paths/pathparser.go b/common/paths/pathparser.go
index 4b3feaa14..1cae710e8 100644
--- a/common/paths/pathparser.go
+++ b/common/paths/pathparser.go
@@ -120,18 +120,24 @@ func (pp *PathParser) parse(component, s string) (*Path, error) {
return p, nil
}
-func (pp *PathParser) parseIdentifier(component, s string, p *Path, i, lastDot int) {
+func (pp *PathParser) parseIdentifier(component, s string, p *Path, i, lastDot, numDots int, isLast bool) {
if p.posContainerHigh != -1 {
return
}
- mayHaveLang := pp.LanguageIndex != nil
+ mayHaveLang := numDots > 1 && p.posIdentifierLanguage == -1 && pp.LanguageIndex != nil
mayHaveLang = mayHaveLang && (component == files.ComponentFolderContent || component == files.ComponentFolderLayouts)
mayHaveOutputFormat := component == files.ComponentFolderLayouts
- mayHaveKind := mayHaveOutputFormat
+ mayHaveKind := p.posIdentifierKind == -1 && mayHaveOutputFormat
+ var mayHaveLayout bool
+ if p.pathType == TypeShortcode {
+ mayHaveLayout = !isLast && component == files.ComponentFolderLayouts
+ } else {
+ mayHaveLayout = component == files.ComponentFolderLayouts
+ }
var found bool
var high int
- if len(p.identifiers) > 0 {
+ if len(p.identifiersKnown) > 0 {
high = lastDot
} else {
high = len(p.s)
@@ -139,9 +145,9 @@ func (pp *PathParser) parseIdentifier(component, s string, p *Path, i, lastDot i
id := types.LowHigh[string]{Low: i + 1, High: high}
sid := p.s[id.Low:id.High]
- if len(p.identifiers) == 0 {
+ if len(p.identifiersKnown) == 0 {
// The first is always the extension.
- p.identifiers = append(p.identifiers, id)
+ p.identifiersKnown = append(p.identifiersKnown, id)
found = true
// May also be the output format.
@@ -164,9 +170,8 @@ func (pp *PathParser) parseIdentifier(component, s string, p *Path, i, lastDot i
}
found = langFound
if langFound {
- p.identifiers = append(p.identifiers, id)
- p.posIdentifierLanguage = len(p.identifiers) - 1
-
+ p.identifiersKnown = append(p.identifiersKnown, id)
+ p.posIdentifierLanguage = len(p.identifiersKnown) - 1
}
}
@@ -177,28 +182,33 @@ func (pp *PathParser) parseIdentifier(component, s string, p *Path, i, lastDot i
// false positives on the form css.html.
if pp.IsOutputFormat(sid, p.Ext()) {
found = true
- p.identifiers = append(p.identifiers, id)
- p.posIdentifierOutputFormat = len(p.identifiers) - 1
+ p.identifiersKnown = append(p.identifiersKnown, id)
+ p.posIdentifierOutputFormat = len(p.identifiersKnown) - 1
}
}
if !found && mayHaveKind {
if kinds.GetKindMain(sid) != "" {
found = true
- p.identifiers = append(p.identifiers, id)
- p.posIdentifierKind = len(p.identifiers) - 1
+ p.identifiersKnown = append(p.identifiersKnown, id)
+ p.posIdentifierKind = len(p.identifiersKnown) - 1
}
}
if !found && sid == identifierBaseof {
found = true
- p.identifiers = append(p.identifiers, id)
- p.posIdentifierBaseof = len(p.identifiers) - 1
+ p.identifiersKnown = append(p.identifiersKnown, id)
+ p.posIdentifierBaseof = len(p.identifiersKnown) - 1
+ }
+
+ if !found && mayHaveLayout {
+ p.identifiersKnown = append(p.identifiersKnown, id)
+ p.posIdentifierLayout = len(p.identifiersKnown) - 1
+ found = true
}
if !found {
- p.identifiers = append(p.identifiers, id)
- p.identifiersUnknown = append(p.identifiersUnknown, len(p.identifiers)-1)
+ p.identifiersUnknown = append(p.identifiersUnknown, id)
}
}
@@ -228,19 +238,24 @@ func (pp *PathParser) doParse(component, s string, p *Path) (*Path, error) {
p.s = s
slashCount := 0
lastDot := 0
+ lastSlashIdx := strings.LastIndex(s, "/")
+ numDots := strings.Count(s[lastSlashIdx+1:], ".")
+ if strings.Contains(s, "/_shortcodes/") {
+ p.pathType = TypeShortcode
+ }
for i := len(s) - 1; i >= 0; i-- {
c := s[i]
switch c {
case '.':
- pp.parseIdentifier(component, s, p, i, lastDot)
+ pp.parseIdentifier(component, s, p, i, lastDot, numDots, false)
lastDot = i
case '/':
slashCount++
if p.posContainerHigh == -1 {
if lastDot > 0 {
- pp.parseIdentifier(component, s, p, i, lastDot)
+ pp.parseIdentifier(component, s, p, i, lastDot, numDots, true)
}
p.posContainerHigh = i + 1
} else if p.posContainerLow == -1 {
@@ -252,13 +267,13 @@ func (pp *PathParser) doParse(component, s string, p *Path) (*Path, error) {
}
}
- if len(p.identifiers) > 0 {
+ if len(p.identifiersKnown) > 0 {
isContentComponent := p.component == files.ComponentFolderContent || p.component == files.ComponentFolderArchetypes
isContent := isContentComponent && pp.IsContentExt(p.Ext())
- id := p.identifiers[len(p.identifiers)-1]
+ id := p.identifiersKnown[len(p.identifiersKnown)-1]
- if id.High > p.posContainerHigh {
- b := p.s[p.posContainerHigh:id.High]
+ if id.Low > p.posContainerHigh {
+ b := p.s[p.posContainerHigh : id.Low-1]
if isContent {
switch b {
case "index":
@@ -276,10 +291,9 @@ func (pp *PathParser) doParse(component, s string, p *Path) (*Path, error) {
p.pathType = TypeContentData
}
}
-
}
- if component == files.ComponentFolderLayouts {
+ if p.pathType < TypeMarkup && component == files.ComponentFolderLayouts {
if p.posIdentifierBaseof != -1 {
p.pathType = TypeBaseof
} else {
@@ -294,6 +308,14 @@ func (pp *PathParser) doParse(component, s string, p *Path) (*Path, error) {
}
}
+ if p.pathType == TypeShortcode && p.posIdentifierLayout != -1 {
+ id := p.identifiersKnown[p.posIdentifierLayout]
+ if id.Low == p.posContainerHigh {
+ // First identifier is shortcode name.
+ p.posIdentifierLayout = -1
+ }
+ }
+
return p, nil
}
@@ -350,13 +372,14 @@ type Path struct {
component string
pathType Type
- identifiers []types.LowHigh[string]
+ identifiersKnown []types.LowHigh[string]
+ identifiersUnknown []types.LowHigh[string]
posIdentifierLanguage int
posIdentifierOutputFormat int
posIdentifierKind int
+ posIdentifierLayout int
posIdentifierBaseof int
- identifiersUnknown []int
disabled bool
trimLeadingSlash bool
@@ -388,10 +411,11 @@ func (p *Path) reset() {
p.posSectionHigh = -1
p.component = ""
p.pathType = 0
- p.identifiers = p.identifiers[:0]
+ p.identifiersKnown = p.identifiersKnown[:0]
p.posIdentifierLanguage = -1
p.posIdentifierOutputFormat = -1
p.posIdentifierKind = -1
+ p.posIdentifierLayout = -1
p.posIdentifierBaseof = -1
p.disabled = false
p.trimLeadingSlash = false
@@ -479,7 +503,7 @@ func (p *Path) Name() string {
// Name returns the last element of path without any extension.
func (p *Path) NameNoExt() string {
if i := p.identifierIndex(0); i != -1 {
- return p.s[p.posContainerHigh : p.identifiers[i].Low-1]
+ return p.s[p.posContainerHigh : p.identifiersKnown[i].Low-1]
}
return p.s[p.posContainerHigh:]
}
@@ -491,7 +515,7 @@ func (p *Path) NameNoLang() string {
return p.Name()
}
- return p.s[p.posContainerHigh:p.identifiers[i].Low-1] + p.s[p.identifiers[i].High:]
+ return p.s[p.posContainerHigh:p.identifiersKnown[i].Low-1] + p.s[p.identifiersKnown[i].High:]
}
// BaseNameNoIdentifier returns the logical base name for a resource without any identifier (e.g. no extension).
@@ -510,15 +534,15 @@ func (p *Path) NameNoIdentifier() string {
}
func (p *Path) nameLowHigh() types.LowHigh[string] {
- if len(p.identifiers) > 0 {
- lastID := p.identifiers[len(p.identifiers)-1]
+ if len(p.identifiersKnown) > 0 {
+ lastID := p.identifiersKnown[len(p.identifiersKnown)-1]
if p.posContainerHigh == lastID.Low {
// The last identifier is the name.
return lastID
}
return types.LowHigh[string]{
Low: p.posContainerHigh,
- High: p.identifiers[len(p.identifiers)-1].Low - 1,
+ High: p.identifiersKnown[len(p.identifiersKnown)-1].Low - 1,
}
}
return types.LowHigh[string]{
@@ -566,7 +590,7 @@ func (p *Path) PathNoIdentifier() string {
// PathBeforeLangAndOutputFormatAndExt returns the path up to the first identifier that is not a language or output format.
func (p *Path) PathBeforeLangAndOutputFormatAndExt() string {
- if len(p.identifiers) == 0 {
+ if len(p.identifiersKnown) == 0 {
return p.norm(p.s)
}
i := p.identifierIndex(0)
@@ -582,7 +606,7 @@ func (p *Path) PathBeforeLangAndOutputFormatAndExt() string {
return p.norm(p.s)
}
- id := p.identifiers[i]
+ id := p.identifiersKnown[i]
return p.norm(p.s[:id.Low-1])
}
@@ -633,11 +657,11 @@ func (p *Path) BaseNoLeadingSlash() string {
}
func (p *Path) base(preserveExt, isBundle bool) string {
- if len(p.identifiers) == 0 {
+ if len(p.identifiersKnown) == 0 {
return p.norm(p.s)
}
- if preserveExt && len(p.identifiers) == 1 {
+ if preserveExt && len(p.identifiersKnown) == 1 {
// Preserve extension.
return p.norm(p.s)
}
@@ -659,7 +683,7 @@ func (p *Path) base(preserveExt, isBundle bool) string {
}
// For txt files etc. we want to preserve the extension.
- id := p.identifiers[0]
+ id := p.identifiersKnown[0]
return p.norm(p.s[:high] + p.s[id.Low-1:id.High])
}
@@ -676,6 +700,10 @@ func (p *Path) Kind() string {
return p.identifierAsString(p.posIdentifierKind)
}
+func (p *Path) Layout() string {
+ return p.identifierAsString(p.posIdentifierLayout)
+}
+
func (p *Path) Lang() string {
return p.identifierAsString(p.posIdentifierLanguage)
}
@@ -689,8 +717,8 @@ func (p *Path) Disabled() bool {
}
func (p *Path) Identifiers() []string {
- ids := make([]string, len(p.identifiers))
- for i, id := range p.identifiers {
+ ids := make([]string, len(p.identifiersKnown))
+ for i, id := range p.identifiersKnown {
ids[i] = p.s[id.Low:id.High]
}
return ids
@@ -699,7 +727,7 @@ func (p *Path) Identifiers() []string {
func (p *Path) IdentifiersUnknown() []string {
ids := make([]string, len(p.identifiersUnknown))
for i, id := range p.identifiersUnknown {
- ids[i] = p.s[p.identifiers[id].Low:p.identifiers[id].High]
+ ids[i] = p.s[id.Low:id.High]
}
return ids
}
@@ -724,7 +752,7 @@ func (p *Path) IsContentData() bool {
return p.pathType == TypeContentData
}
-func (p Path) ForBundleType(t Type) *Path {
+func (p Path) ForType(t Type) *Path {
p.pathType = t
return &p
}
@@ -735,12 +763,12 @@ func (p *Path) identifierAsString(i int) string {
return ""
}
- id := p.identifiers[i]
+ id := p.identifiersKnown[i]
return p.s[id.Low:id.High]
}
func (p *Path) identifierIndex(i int) int {
- if i < 0 || i >= len(p.identifiers) {
+ if i < 0 || i >= len(p.identifiersKnown) {
return -1
}
return i
diff --git a/common/paths/pathparser_test.go b/common/paths/pathparser_test.go
index fd1590c73..b1734aef2 100644
--- a/common/paths/pathparser_test.go
+++ b/common/paths/pathparser_test.go
@@ -171,22 +171,25 @@ func TestParse(t *testing.T) {
"/a/b.a.b.no.txt",
func(c *qt.C, p *Path) {
c.Assert(p.Name(), qt.Equals, "b.a.b.no.txt")
- c.Assert(p.NameNoIdentifier(), qt.Equals, "b")
+ c.Assert(p.NameNoIdentifier(), qt.Equals, "b.a.b")
c.Assert(p.NameNoLang(), qt.Equals, "b.a.b.txt")
- c.Assert(p.Identifiers(), qt.DeepEquals, []string{"txt", "no", "b", "a", "b"})
+ c.Assert(p.Identifiers(), qt.DeepEquals, []string{"txt", "no"})
c.Assert(p.IdentifiersUnknown(), qt.DeepEquals, []string{"b", "a", "b"})
- c.Assert(p.Base(), qt.Equals, "/a/b.txt")
- c.Assert(p.BaseNoLeadingSlash(), qt.Equals, "a/b.txt")
+ c.Assert(p.Base(), qt.Equals, "/a/b.a.b.txt")
+ c.Assert(p.BaseNoLeadingSlash(), qt.Equals, "a/b.a.b.txt")
c.Assert(p.Path(), qt.Equals, "/a/b.a.b.no.txt")
- c.Assert(p.PathNoLang(), qt.Equals, "/a/b.txt")
+ c.Assert(p.PathNoLang(), qt.Equals, "/a/b.a.b.txt")
c.Assert(p.Ext(), qt.Equals, "txt")
- c.Assert(p.PathNoIdentifier(), qt.Equals, "/a/b")
+ c.Assert(p.PathNoIdentifier(), qt.Equals, "/a/b.a.b")
},
},
{
"Home branch cundle",
"/_index.md",
func(c *qt.C, p *Path) {
+ c.Assert(p.Identifiers(), qt.DeepEquals, []string{"md"})
+ c.Assert(p.IsBranchBundle(), qt.IsTrue)
+ c.Assert(p.IsBundle(), qt.IsTrue)
c.Assert(p.Base(), qt.Equals, "/")
c.Assert(p.BaseReTyped("foo"), qt.Equals, "/foo")
c.Assert(p.Path(), qt.Equals, "/_index.md")
@@ -206,7 +209,8 @@ func TestParse(t *testing.T) {
c.Assert(p.ContainerDir(), qt.Equals, "")
c.Assert(p.Dir(), qt.Equals, "/a")
c.Assert(p.Ext(), qt.Equals, "md")
- c.Assert(p.Identifiers(), qt.DeepEquals, []string{"md", "index"})
+ c.Assert(p.IdentifiersUnknown(), qt.DeepEquals, []string{"index"})
+ c.Assert(p.Identifiers(), qt.DeepEquals, []string{"md"})
c.Assert(p.IsBranchBundle(), qt.IsFalse)
c.Assert(p.IsBundle(), qt.IsTrue)
c.Assert(p.IsLeafBundle(), qt.IsTrue)
@@ -228,7 +232,7 @@ func TestParse(t *testing.T) {
c.Assert(p.ContainerDir(), qt.Equals, "/a")
c.Assert(p.Dir(), qt.Equals, "/a/b")
c.Assert(p.Ext(), qt.Equals, "md")
- c.Assert(p.Identifiers(), qt.DeepEquals, []string{"md", "no", "index"})
+ c.Assert(p.Identifiers(), qt.DeepEquals, []string{"md", "no"})
c.Assert(p.IsBranchBundle(), qt.IsFalse)
c.Assert(p.IsBundle(), qt.IsTrue)
c.Assert(p.IsLeafBundle(), qt.IsTrue)
@@ -250,7 +254,7 @@ func TestParse(t *testing.T) {
c.Assert(p.Container(), qt.Equals, "b")
c.Assert(p.ContainerDir(), qt.Equals, "/a")
c.Assert(p.Ext(), qt.Equals, "md")
- c.Assert(p.Identifiers(), qt.DeepEquals, []string{"md", "no", "_index"})
+ c.Assert(p.Identifiers(), qt.DeepEquals, []string{"md", "no"})
c.Assert(p.IsBranchBundle(), qt.IsTrue)
c.Assert(p.IsBundle(), qt.IsTrue)
c.Assert(p.IsLeafBundle(), qt.IsFalse)
@@ -289,7 +293,7 @@ func TestParse(t *testing.T) {
func(c *qt.C, p *Path) {
c.Assert(p.Base(), qt.Equals, "/a/b/index.txt")
c.Assert(p.Ext(), qt.Equals, "txt")
- c.Assert(p.Identifiers(), qt.DeepEquals, []string{"txt", "no", "index"})
+ c.Assert(p.Identifiers(), qt.DeepEquals, []string{"txt", "no"})
c.Assert(p.IsLeafBundle(), qt.IsFalse)
c.Assert(p.PathNoIdentifier(), qt.Equals, "/a/b/index")
},
@@ -372,7 +376,7 @@ func TestParse(t *testing.T) {
}
for _, test := range tests {
c.Run(test.name, func(c *qt.C) {
- if test.name != "Basic Markdown file" {
+ if test.name != "Home branch cundle" {
// return
}
test.assert(c, testParser.Parse(files.ComponentFolderContent, test.path))
@@ -401,10 +405,58 @@ func TestParseLayouts(t *testing.T) {
"/list.no.html",
func(c *qt.C, p *Path) {
c.Assert(p.Identifiers(), qt.DeepEquals, []string{"html", "no", "list"})
+ c.Assert(p.IdentifiersUnknown(), qt.DeepEquals, []string{})
c.Assert(p.Base(), qt.Equals, "/list.html")
c.Assert(p.Lang(), qt.Equals, "no")
},
},
+ {
+ "Kind",
+ "/section.no.html",
+ func(c *qt.C, p *Path) {
+ c.Assert(p.Kind(), qt.Equals, kinds.KindSection)
+ c.Assert(p.Identifiers(), qt.DeepEquals, []string{"html", "no", "section"})
+ c.Assert(p.IdentifiersUnknown(), qt.DeepEquals, []string{})
+ c.Assert(p.Base(), qt.Equals, "/section.html")
+ c.Assert(p.Lang(), qt.Equals, "no")
+ },
+ },
+ {
+ "Layout",
+ "/list.section.no.html",
+ func(c *qt.C, p *Path) {
+ c.Assert(p.Layout(), qt.Equals, "list")
+ c.Assert(p.Identifiers(), qt.DeepEquals, []string{"html", "no", "section", "list"})
+ c.Assert(p.IdentifiersUnknown(), qt.DeepEquals, []string{})
+ c.Assert(p.Base(), qt.Equals, "/list.html")
+ c.Assert(p.Lang(), qt.Equals, "no")
+ },
+ },
+ {
+ "Layout multiple",
+ "/mylayout.list.section.no.html",
+ func(c *qt.C, p *Path) {
+ c.Assert(p.Layout(), qt.Equals, "mylayout")
+ c.Assert(p.Identifiers(), qt.DeepEquals, []string{"html", "no", "section", "list", "mylayout"})
+ c.Assert(p.IdentifiersUnknown(), qt.DeepEquals, []string{})
+ c.Assert(p.Base(), qt.Equals, "/mylayout.html")
+ c.Assert(p.Lang(), qt.Equals, "no")
+ },
+ },
+ {
+ "Layout shortcode",
+ "/_shortcodes/myshort.list.no.html",
+ func(c *qt.C, p *Path) {
+ c.Assert(p.Layout(), qt.Equals, "list")
+ },
+ },
+ {
+ "Layout baseof",
+ "/baseof.list.no.html",
+ func(c *qt.C, p *Path) {
+ c.Assert(p.Layout(), qt.Equals, "list")
+ },
+ },
{
"Lang and output format",
"/list.no.amp.not.html",
@@ -429,6 +481,21 @@ func TestParseLayouts(t *testing.T) {
c.Assert(p.OutputFormat(), qt.Equals, "html")
},
},
+ {
+ "Shortcode with layout",
+ "/_shortcodes/myshortcode.list.html",
+ func(c *qt.C, p *Path) {
+ c.Assert(p.Base(), qt.Equals, "/_shortcodes/myshortcode.html")
+ c.Assert(p.Type(), qt.Equals, TypeShortcode)
+ c.Assert(p.Identifiers(), qt.DeepEquals, []string{"html", "list"})
+ c.Assert(p.Layout(), qt.Equals, "list")
+ c.Assert(p.PathNoIdentifier(), qt.Equals, "/_shortcodes/myshortcode")
+ c.Assert(p.PathBeforeLangAndOutputFormatAndExt(), qt.Equals, "/_shortcodes/myshortcode.list")
+ c.Assert(p.Lang(), qt.Equals, "")
+ c.Assert(p.Kind(), qt.Equals, "")
+ c.Assert(p.OutputFormat(), qt.Equals, "html")
+ },
+ },
{
"Sub dir",
"/pages/home.html",
@@ -445,7 +512,7 @@ func TestParseLayouts(t *testing.T) {
"/pages/baseof.list.section.fr.amp.html",
func(c *qt.C, p *Path) {
c.Assert(p.Identifiers(), qt.DeepEquals, []string{"html", "amp", "fr", "section", "list", "baseof"})
- c.Assert(p.IdentifiersUnknown(), qt.DeepEquals, []string{"list"})
+ c.Assert(p.IdentifiersUnknown(), qt.DeepEquals, []string{})
c.Assert(p.Kind(), qt.Equals, kinds.KindSection)
c.Assert(p.Lang(), qt.Equals, "fr")
c.Assert(p.OutputFormat(), qt.Equals, "amp")
@@ -497,10 +564,32 @@ func TestParseLayouts(t *testing.T) {
c.Assert(p.Type(), qt.Equals, TypePartial)
},
},
+ {
+ "Shortcode lang in root",
+ "/_shortcodes/no.html",
+ func(c *qt.C, p *Path) {
+ c.Assert(p.Type(), qt.Equals, TypeShortcode)
+ c.Assert(p.Lang(), qt.Equals, "")
+ c.Assert(p.NameNoIdentifier(), qt.Equals, "no")
+ },
+ },
+ {
+ "Shortcode lang layout",
+ "/_shortcodes/myshortcode.no.html",
+ func(c *qt.C, p *Path) {
+ c.Assert(p.Type(), qt.Equals, TypeShortcode)
+ c.Assert(p.Lang(), qt.Equals, "no")
+ c.Assert(p.Layout(), qt.Equals, "")
+ c.Assert(p.NameNoIdentifier(), qt.Equals, "myshortcode")
+ },
+ },
}
for _, test := range tests {
c.Run(test.name, func(c *qt.C) {
+ if test.name != "Shortcode lang layout" {
+ // return
+ }
test.assert(c, testParser.Parse(files.ComponentFolderLayouts, test.path))
})
}
diff --git a/common/paths/paths_integration_test.go b/common/paths/paths_integration_test.go
index 62d40f527..f5ea3066a 100644
--- a/common/paths/paths_integration_test.go
+++ b/common/paths/paths_integration_test.go
@@ -78,3 +78,26 @@ disablePathToLower = true
b.AssertFileContent("public/en/mysection/mybundle/index.html", "en|Single")
b.AssertFileContent("public/fr/MySection/MyBundle/index.html", "fr|Single")
}
+
+func TestIssue13596(t *testing.T) {
+ t.Parallel()
+
+ files := `
+-- hugo.toml --
+disableKinds = ['home','rss','section','sitemap','taxonomy','term']
+-- content/p1/index.md --
+---
+title: p1
+---
+-- content/p1/a.1.txt --
+-- content/p1/a.2.txt --
+-- layouts/all.html --
+{{ range .Resources.Match "*" }}{{ .Name }}|{{ end }}
+`
+
+ b := hugolib.Test(t, files)
+
+ b.AssertFileContent("public/p1/index.html", "a.1.txt|a.2.txt|")
+ b.AssertFileExists("public/p1/a.1.txt", true)
+ b.AssertFileExists("public/p1/a.2.txt", true) // fails
+}
diff --git a/common/terminal/colors.go b/common/terminal/colors.go
index 8aa0e1af2..fef6efce8 100644
--- a/common/terminal/colors.go
+++ b/common/terminal/colors.go
@@ -17,7 +17,6 @@ package terminal
import (
"fmt"
"os"
- "runtime"
"strings"
isatty "github.com/mattn/go-isatty"
@@ -41,10 +40,6 @@ func PrintANSIColors(f *os.File) bool {
// IsTerminal return true if the file descriptor is terminal and the TERM
// environment variable isn't a dumb one.
func IsTerminal(f *os.File) bool {
- if runtime.GOOS == "windows" {
- return false
- }
-
fd := f.Fd()
return os.Getenv("TERM") != "dumb" && (isatty.IsTerminal(fd) || isatty.IsCygwinTerminal(fd))
}
diff --git a/config/allconfig/allconfig.go b/config/allconfig/allconfig.go
index e73153a94..0db0be1d8 100644
--- a/config/allconfig/allconfig.go
+++ b/config/allconfig/allconfig.go
@@ -146,7 +146,7 @@ type Config struct {
// The cascade configuration section contains the top level front matter cascade configuration options,
// a slice of page matcher and params to apply to those pages.
- Cascade *config.ConfigNamespace[[]page.PageMatcherParamsConfig, *maps.Ordered[page.PageMatcher, maps.Params]] `mapstructure:"-"`
+ Cascade *config.ConfigNamespace[[]page.PageMatcherParamsConfig, *maps.Ordered[page.PageMatcher, page.PageMatcherParamsConfig]] `mapstructure:"-"`
// The segments defines segments for the site. Used for partial/segmented builds.
Segments *config.ConfigNamespace[map[string]segments.SegmentConfig, segments.Segments] `mapstructure:"-"`
@@ -776,7 +776,7 @@ type Configs struct {
}
func (c *Configs) Validate(logger loggers.Logger) error {
- c.Base.Cascade.Config.Range(func(p page.PageMatcher, params maps.Params) bool {
+ c.Base.Cascade.Config.Range(func(p page.PageMatcher, cfg page.PageMatcherParamsConfig) bool {
page.CheckCascadePattern(logger, p)
return true
})
@@ -800,30 +800,58 @@ func (c *Configs) IsZero() bool {
func (c *Configs) Init() error {
var languages langs.Languages
- defaultContentLanguage := c.Base.DefaultContentLanguage
- for k, v := range c.LanguageConfigMap {
+
+ var langKeys []string
+ var hasEn bool
+
+ const en = "en"
+
+ for k := range c.LanguageConfigMap {
+ langKeys = append(langKeys, k)
+ if k == en {
+ hasEn = true
+ }
+ }
+
+ // Sort the LanguageConfigSlice by language weight (if set) or lang.
+ sort.Slice(langKeys, func(i, j int) bool {
+ ki := langKeys[i]
+ kj := langKeys[j]
+ lki := c.LanguageConfigMap[ki]
+ lkj := c.LanguageConfigMap[kj]
+ li := lki.Languages[ki]
+ lj := lkj.Languages[kj]
+ if li.Weight != lj.Weight {
+ return li.Weight < lj.Weight
+ }
+ return ki < kj
+ })
+
+ // See issue #13646.
+ defaultConfigLanguageFallback := en
+ if !hasEn {
+ // Pick the first one.
+ defaultConfigLanguageFallback = langKeys[0]
+ }
+
+ if c.Base.DefaultContentLanguage == "" {
+ c.Base.DefaultContentLanguage = defaultConfigLanguageFallback
+ }
+
+ for _, k := range langKeys {
+ v := c.LanguageConfigMap[k]
+ if v.DefaultContentLanguage == "" {
+ v.DefaultContentLanguage = defaultConfigLanguageFallback
+ }
+ c.LanguageConfigSlice = append(c.LanguageConfigSlice, v)
languageConf := v.Languages[k]
- language, err := langs.NewLanguage(k, defaultContentLanguage, v.TimeZone, languageConf)
+ language, err := langs.NewLanguage(k, c.Base.DefaultContentLanguage, v.TimeZone, languageConf)
if err != nil {
return err
}
languages = append(languages, language)
}
- // Sort the sites by language weight (if set) or lang.
- sort.Slice(languages, func(i, j int) bool {
- li := languages[i]
- lj := languages[j]
- if li.Weight != lj.Weight {
- return li.Weight < lj.Weight
- }
- return li.Lang < lj.Lang
- })
-
- for _, l := range languages {
- c.LanguageConfigSlice = append(c.LanguageConfigSlice, c.LanguageConfigMap[l.Lang])
- }
-
// Filter out disabled languages.
var n int
for _, l := range languages {
@@ -836,12 +864,12 @@ func (c *Configs) Init() error {
var languagesDefaultFirst langs.Languages
for _, l := range languages {
- if l.Lang == defaultContentLanguage {
+ if l.Lang == c.Base.DefaultContentLanguage {
languagesDefaultFirst = append(languagesDefaultFirst, l)
}
}
for _, l := range languages {
- if l.Lang != defaultContentLanguage {
+ if l.Lang != c.Base.DefaultContentLanguage {
languagesDefaultFirst = append(languagesDefaultFirst, l)
}
}
@@ -927,17 +955,48 @@ func (c Configs) GetByLang(lang string) config.AllProvider {
return nil
}
+func newDefaultConfig() *Config {
+ return &Config{
+ Taxonomies: map[string]string{"tag": "tags", "category": "categories"},
+ Sitemap: config.SitemapConfig{Priority: -1, Filename: "sitemap.xml"},
+ RootConfig: RootConfig{
+ Environment: hugo.EnvironmentProduction,
+ TitleCaseStyle: "AP",
+ PluralizeListTitles: true,
+ CapitalizeListTitles: true,
+ StaticDir: []string{"static"},
+ SummaryLength: 70,
+ Timeout: "60s",
+
+ CommonDirs: config.CommonDirs{
+ ArcheTypeDir: "archetypes",
+ ContentDir: "content",
+ ResourceDir: "resources",
+ PublishDir: "public",
+ ThemesDir: "themes",
+ AssetDir: "assets",
+ LayoutDir: "layouts",
+ I18nDir: "i18n",
+ DataDir: "data",
+ },
+ },
+ }
+}
+
// fromLoadConfigResult creates a new Config from res.
func fromLoadConfigResult(fs afero.Fs, logger loggers.Logger, res config.LoadConfigResult) (*Configs, error) {
if !res.Cfg.IsSet("languages") {
// We need at least one
lang := res.Cfg.GetString("defaultContentLanguage")
+ if lang == "" {
+ lang = "en"
+ }
res.Cfg.Set("languages", maps.Params{lang: maps.Params{}})
}
bcfg := res.BaseConfig
cfg := res.Cfg
- all := &Config{}
+ all := newDefaultConfig()
err := decodeConfigFromParams(fs, logger, bcfg, cfg, all, nil)
if err != nil {
@@ -947,6 +1006,7 @@ func fromLoadConfigResult(fs afero.Fs, logger loggers.Logger, res config.LoadCon
langConfigMap := make(map[string]*Config)
languagesConfig := cfg.GetStringMap("languages")
+
var isMultihost bool
if err := all.CompileConfig(logger); err != nil {
diff --git a/config/allconfig/allconfig_integration_test.go b/config/allconfig/allconfig_integration_test.go
index cae04ba85..8f6cacf84 100644
--- a/config/allconfig/allconfig_integration_test.go
+++ b/config/allconfig/allconfig_integration_test.go
@@ -5,6 +5,7 @@ import (
"testing"
qt "github.com/frankban/quicktest"
+ "github.com/gohugoio/hugo/common/hugo"
"github.com/gohugoio/hugo/config/allconfig"
"github.com/gohugoio/hugo/hugolib"
"github.com/gohugoio/hugo/media"
@@ -234,3 +235,147 @@ baseURL = "https://example.com"
b.Assert(c.IsContentFile("foo.md"), qt.Equals, true)
b.Assert(len(s), qt.Equals, 6)
}
+
+func TestMergeDeep(t *testing.T) {
+ t.Parallel()
+
+ files := `
+-- hugo.toml --
+baseURL = "https://example.com"
+theme = ["theme1", "theme2"]
+_merge = "deep"
+-- themes/theme1/hugo.toml --
+[sitemap]
+filename = 'mysitemap.xml'
+[services]
+[services.googleAnalytics]
+id = 'foo bar'
+[taxonomies]
+ foo = 'bars'
+-- themes/theme2/config/_default/hugo.toml --
+[taxonomies]
+ bar = 'baz'
+-- layouts/home.html --
+GA ID: {{ site.Config.Services.GoogleAnalytics.ID }}.
+
+`
+
+ b := hugolib.Test(t, files)
+
+ conf := b.H.Configs
+ base := conf.Base
+
+ b.Assert(base.Environment, qt.Equals, hugo.EnvironmentProduction)
+ b.Assert(base.BaseURL, qt.Equals, "https://example.com")
+ b.Assert(base.Sitemap.Filename, qt.Equals, "mysitemap.xml")
+ b.Assert(base.Taxonomies, qt.DeepEquals, map[string]string{"bar": "baz", "foo": "bars"})
+
+ b.AssertFileContent("public/index.html", "GA ID: foo bar.")
+}
+
+func TestMergeDeepBuildStats(t *testing.T) {
+ t.Parallel()
+
+ files := `
+-- hugo.toml --
+baseURL = "https://example.com"
+title = "Theme 1"
+_merge = "deep"
+[module]
+[module.hugoVersion]
+[[module.imports]]
+path = "theme1"
+-- themes/theme1/hugo.toml --
+[build]
+[build.buildStats]
+disableIDs = true
+enable = true
+-- layouts/home.html --
+Home.
+
+`
+
+ b := hugolib.Test(t, files, hugolib.TestOptOsFs())
+
+ conf := b.H.Configs
+ base := conf.Base
+
+ b.Assert(base.Title, qt.Equals, "Theme 1")
+ b.Assert(len(base.Module.Imports), qt.Equals, 1)
+ b.Assert(base.Build.BuildStats.Enable, qt.Equals, true)
+ b.AssertFileExists("/hugo_stats.json", true)
+}
+
+func TestMergeDeepBuildStatsTheme(t *testing.T) {
+ t.Parallel()
+
+ files := `
+-- hugo.toml --
+baseURL = "https://example.com"
+_merge = "deep"
+theme = ["theme1"]
+-- themes/theme1/hugo.toml --
+title = "Theme 1"
+[build]
+[build.buildStats]
+disableIDs = true
+enable = true
+-- layouts/home.html --
+Home.
+
+`
+
+ b := hugolib.Test(t, files, hugolib.TestOptOsFs())
+
+ conf := b.H.Configs
+ base := conf.Base
+
+ b.Assert(base.Title, qt.Equals, "Theme 1")
+ b.Assert(len(base.Module.Imports), qt.Equals, 1)
+ b.Assert(base.Build.BuildStats.Enable, qt.Equals, true)
+ b.AssertFileExists("/hugo_stats.json", true)
+}
+
+func TestDefaultConfigLanguageBlankWhenNoEnglishExists(t *testing.T) {
+ t.Parallel()
+
+ files := `
+-- hugo.toml --
+baseURL = "https://example.com"
+[languages]
+[languages.nn]
+weight = 20
+[languages.sv]
+weight = 10
+[languages.sv.taxonomies]
+ tag = "taggar"
+-- layouts/all.html --
+All.
+`
+
+ b := hugolib.Test(t, files)
+
+ b.Assert(b.H.Conf.DefaultContentLanguage(), qt.Equals, "sv")
+}
+
+func TestDefaultConfigEnvDisableLanguagesIssue13707(t *testing.T) {
+ t.Parallel()
+
+ files := `
+-- hugo.toml --
+disableLanguages = []
+[languages]
+[languages.en]
+weight = 1
+[languages.nn]
+weight = 2
+[languages.sv]
+weight = 3
+`
+
+ b := hugolib.Test(t, files, hugolib.TestOptWithConfig(func(conf *hugolib.IntegrationTestConfig) {
+ conf.Environ = []string{`HUGO_DISABLELANGUAGES=sv nn`}
+ }))
+
+ b.Assert(len(b.H.Sites), qt.Equals, 1)
+}
diff --git a/config/allconfig/alldecoders.go b/config/allconfig/alldecoders.go
index 0bf8508d9..035349790 100644
--- a/config/allconfig/alldecoders.go
+++ b/config/allconfig/alldecoders.go
@@ -249,14 +249,18 @@ var allDecoderSetups = map[string]decodeWeight{
key: "sitemap",
decode: func(d decodeWeight, p decodeConfig) error {
var err error
- p.c.Sitemap, err = config.DecodeSitemap(config.SitemapConfig{Priority: -1, Filename: "sitemap.xml"}, p.p.GetStringMap(d.key))
+ if p.p.IsSet(d.key) {
+ p.c.Sitemap, err = config.DecodeSitemap(p.c.Sitemap, p.p.GetStringMap(d.key))
+ }
return err
},
},
"taxonomies": {
key: "taxonomies",
decode: func(d decodeWeight, p decodeConfig) error {
- p.c.Taxonomies = maps.CleanConfigStringMapString(p.p.GetStringMapString(d.key))
+ if p.p.IsSet(d.key) {
+ p.c.Taxonomies = maps.CleanConfigStringMapString(p.p.GetStringMapString(d.key))
+ }
return nil
},
},
@@ -306,15 +310,17 @@ var allDecoderSetups = map[string]decodeWeight{
}
// Validate defaultContentLanguage.
- var found bool
- for lang := range p.c.Languages {
- if lang == p.c.DefaultContentLanguage {
- found = true
- break
+ if p.c.DefaultContentLanguage != "" {
+ var found bool
+ for lang := range p.c.Languages {
+ if lang == p.c.DefaultContentLanguage {
+ found = true
+ break
+ }
+ }
+ if !found {
+ return fmt.Errorf("config value %q for defaultContentLanguage does not match any language definition", p.c.DefaultContentLanguage)
}
- }
- if !found {
- return fmt.Errorf("config value %q for defaultContentLanguage does not match any language definition", p.c.DefaultContentLanguage)
}
return nil
@@ -324,7 +330,7 @@ var allDecoderSetups = map[string]decodeWeight{
key: "cascade",
decode: func(d decodeWeight, p decodeConfig) error {
var err error
- p.c.Cascade, err = page.DecodeCascadeConfig(nil, p.p.Get(d.key))
+ p.c.Cascade, err = page.DecodeCascadeConfig(nil, true, p.p.Get(d.key))
return err
},
},
diff --git a/config/allconfig/load.go b/config/allconfig/load.go
index f224009ac..4fb8bbaef 100644
--- a/config/allconfig/load.go
+++ b/config/allconfig/load.go
@@ -159,63 +159,9 @@ func (l configLoader) applyConfigAliases() error {
func (l configLoader) applyDefaultConfig() error {
defaultSettings := maps.Params{
- "baseURL": "",
- "cleanDestinationDir": false,
- "watch": false,
- "contentDir": "content",
- "resourceDir": "resources",
- "publishDir": "public",
- "publishDirOrig": "public",
- "themesDir": "themes",
- "assetDir": "assets",
- "layoutDir": "layouts",
- "i18nDir": "i18n",
- "dataDir": "data",
- "archetypeDir": "archetypes",
- "configDir": "config",
- "staticDir": "static",
- "buildDrafts": false,
- "buildFuture": false,
- "buildExpired": false,
- "params": maps.Params{},
- "environment": hugo.EnvironmentProduction,
- "uglyURLs": false,
- "verbose": false,
- "ignoreCache": false,
- "canonifyURLs": false,
- "relativeURLs": false,
- "removePathAccents": false,
- "titleCaseStyle": "AP",
- "taxonomies": maps.Params{"tag": "tags", "category": "categories"},
- "permalinks": maps.Params{},
- "sitemap": maps.Params{"priority": -1, "filename": "sitemap.xml"},
- "menus": maps.Params{},
- "disableLiveReload": false,
- "pluralizeListTitles": true,
- "capitalizeListTitles": true,
- "forceSyncStatic": false,
- "footnoteAnchorPrefix": "",
- "footnoteReturnLinkContents": "",
- "newContentEditor": "",
- "paginate": 0, // Moved into the paginator struct in Hugo v0.128.0.
- "paginatePath": "", // Moved into the paginator struct in Hugo v0.128.0.
- "summaryLength": 70,
- "rssLimit": -1,
- "sectionPagesMenu": "",
- "disablePathToLower": false,
- "hasCJKLanguage": false,
- "enableEmoji": false,
- "defaultContentLanguage": "en",
- "defaultContentLanguageInSubdir": false,
- "enableMissingTranslationPlaceholders": false,
- "enableGitInfo": false,
- "ignoreFiles": make([]string, 0),
- "disableAliases": false,
- "debug": false,
- "disableFastRender": false,
- "timeout": "30s",
- "timeZone": "",
- "enableInlineShortcodes": false,
+ // These dirs are used early/before we build the config struct.
+ "themesDir": "themes",
+ "configDir": "config",
}
l.cfg.SetDefaults(defaultSettings)
@@ -287,40 +233,51 @@ func (l configLoader) applyOsEnvOverrides(environ []string) error {
if existing != nil {
val, err := metadecoders.Default.UnmarshalStringTo(env.Value, existing)
- if err != nil {
+ if err == nil {
+ val = l.envValToVal(env.Key, val)
+ if owner != nil {
+ owner[nestedKey] = val
+ } else {
+ l.cfg.Set(env.Key, val)
+ }
continue
}
-
- if owner != nil {
- owner[nestedKey] = val
- } else {
- l.cfg.Set(env.Key, val)
- }
- } else {
- if nestedKey != "" {
- owner[nestedKey] = env.Value
- } else {
- var val any
- key := strings.ReplaceAll(env.Key, delim, ".")
- _, ok := allDecoderSetups[key]
- if ok {
- // A map.
- if v, err := metadecoders.Default.UnmarshalStringTo(env.Value, map[string]any{}); err == nil {
- val = v
- }
- }
- if val == nil {
- // A string.
- val = l.envStringToVal(key, env.Value)
- }
- l.cfg.Set(key, val)
- }
}
+
+ if owner != nil && nestedKey != "" {
+ owner[nestedKey] = env.Value
+ } else {
+ var val any
+ key := strings.ReplaceAll(env.Key, delim, ".")
+ _, ok := allDecoderSetups[key]
+ if ok {
+ // A map.
+ if v, err := metadecoders.Default.UnmarshalStringTo(env.Value, map[string]any{}); err == nil {
+ val = v
+ }
+ }
+
+ if val == nil {
+ // A string.
+ val = l.envStringToVal(key, env.Value)
+ }
+ l.cfg.Set(key, val)
+ }
+
}
return nil
}
+func (l *configLoader) envValToVal(k string, v any) any {
+ switch v := v.(type) {
+ case string:
+ return l.envStringToVal(k, v)
+ default:
+ return v
+ }
+}
+
func (l *configLoader) envStringToVal(k, v string) any {
switch k {
case "disablekinds", "disablelanguages":
diff --git a/config/commonConfig.go b/config/commonConfig.go
index 3dfd9b409..947078672 100644
--- a/config/commonConfig.go
+++ b/config/commonConfig.go
@@ -17,6 +17,7 @@ import (
"fmt"
"net/http"
"regexp"
+ "slices"
"sort"
"strings"
@@ -28,7 +29,6 @@ import (
"github.com/gohugoio/hugo/common/herrors"
"github.com/mitchellh/mapstructure"
"github.com/spf13/cast"
- "slices"
)
type BaseConfig struct {
diff --git a/config/configProvider.go b/config/configProvider.go
index 5bda2c55a..c21342dce 100644
--- a/config/configProvider.go
+++ b/config/configProvider.go
@@ -76,7 +76,7 @@ type AllProvider interface {
}
// We cannot import the media package as that would create a circular dependency.
-// This interface defineds a sub set of what media.ContentTypes provides.
+// This interface defines a subset of what media.ContentTypes provides.
type ContentTypesProvider interface {
IsContentSuffix(suffix string) bool
IsContentFile(filename string) bool
diff --git a/config/services/servicesConfig.go b/config/services/servicesConfig.go
index f302244d4..f9d5e1a6e 100644
--- a/config/services/servicesConfig.go
+++ b/config/services/servicesConfig.go
@@ -101,6 +101,9 @@ func DecodeConfig(cfg config.Provider) (c Config, err error) {
if c.RSS.Limit == 0 {
c.RSS.Limit = cfg.GetInt(rssLimitKey)
+ if c.RSS.Limit == 0 {
+ c.RSS.Limit = -1
+ }
}
return
diff --git a/create/skeletons/theme/layouts/single.html b/create/skeletons/theme/layouts/page.html
similarity index 100%
rename from create/skeletons/theme/layouts/single.html
rename to create/skeletons/theme/layouts/page.html
diff --git a/create/skeletons/theme/layouts/list.html b/create/skeletons/theme/layouts/section.html
similarity index 100%
rename from create/skeletons/theme/layouts/list.html
rename to create/skeletons/theme/layouts/section.html
diff --git a/deploy/deploy.go b/deploy/deploy.go
index 4b90881a6..57e1f41a2 100644
--- a/deploy/deploy.go
+++ b/deploy/deploy.go
@@ -36,6 +36,7 @@ import (
"github.com/dustin/go-humanize"
"github.com/gobwas/glob"
"github.com/gohugoio/hugo/common/loggers"
+ "github.com/gohugoio/hugo/common/para"
"github.com/gohugoio/hugo/config"
"github.com/gohugoio/hugo/deploy/deployconfig"
"github.com/gohugoio/hugo/media"
@@ -487,7 +488,12 @@ func knownHiddenDirectory(name string) bool {
// walkLocal walks the source directory and returns a flat list of files,
// using localFile.SlashPath as the map keys.
func (d *Deployer) walkLocal(fs afero.Fs, matchers []*deployconfig.Matcher, include, exclude glob.Glob, mediaTypes media.Types, mappath func(string) string) (map[string]*localFile, error) {
- retval := map[string]*localFile{}
+ retval := make(map[string]*localFile)
+ var mu sync.Mutex
+
+ workers := para.New(d.cfg.Workers)
+ g, _ := workers.Start(context.Background())
+
err := afero.Walk(fs, "", func(path string, info os.FileInfo, err error) error {
if err != nil {
return err
@@ -508,45 +514,54 @@ func (d *Deployer) walkLocal(fs afero.Fs, matchers []*deployconfig.Matcher, incl
return nil
}
- // When a file system is HFS+, its filepath is in NFD form.
- if runtime.GOOS == "darwin" {
- path = norm.NFC.String(path)
- }
-
- // Check include/exclude matchers.
- slashpath := filepath.ToSlash(path)
- if include != nil && !include.Match(slashpath) {
- d.logger.Infof(" dropping %q due to include\n", slashpath)
- return nil
- }
- if exclude != nil && exclude.Match(slashpath) {
- d.logger.Infof(" dropping %q due to exclude\n", slashpath)
- return nil
- }
-
- // Find the first matching matcher (if any).
- var m *deployconfig.Matcher
- for _, cur := range matchers {
- if cur.Matches(slashpath) {
- m = cur
- break
+ // Process each file in a worker
+ g.Run(func() error {
+ // When a file system is HFS+, its filepath is in NFD form.
+ if runtime.GOOS == "darwin" {
+ path = norm.NFC.String(path)
}
- }
- // Apply any additional modifications to the local path, to map it to
- // the remote path.
- if mappath != nil {
- slashpath = mappath(slashpath)
- }
- lf, err := newLocalFile(fs, path, slashpath, m, mediaTypes)
- if err != nil {
- return err
- }
- retval[lf.SlashPath] = lf
+
+ // Check include/exclude matchers.
+ slashpath := filepath.ToSlash(path)
+ if include != nil && !include.Match(slashpath) {
+ d.logger.Infof(" dropping %q due to include\n", slashpath)
+ return nil
+ }
+ if exclude != nil && exclude.Match(slashpath) {
+ d.logger.Infof(" dropping %q due to exclude\n", slashpath)
+ return nil
+ }
+
+ // Find the first matching matcher (if any).
+ var m *deployconfig.Matcher
+ for _, cur := range matchers {
+ if cur.Matches(slashpath) {
+ m = cur
+ break
+ }
+ }
+ // Apply any additional modifications to the local path, to map it to
+ // the remote path.
+ if mappath != nil {
+ slashpath = mappath(slashpath)
+ }
+ lf, err := newLocalFile(fs, path, slashpath, m, mediaTypes)
+ if err != nil {
+ return err
+ }
+ mu.Lock()
+ retval[lf.SlashPath] = lf
+ mu.Unlock()
+ return nil
+ })
return nil
})
if err != nil {
return nil, err
}
+ if err := g.Wait(); err != nil {
+ return nil, err
+ }
return retval, nil
}
diff --git a/deploy/deploy_test.go b/deploy/deploy_test.go
index 3bbc9ff70..bdc8299a0 100644
--- a/deploy/deploy_test.go
+++ b/deploy/deploy_test.go
@@ -623,7 +623,7 @@ func TestEndToEndSync(t *testing.T) {
localFs: test.fs,
bucket: test.bucket,
mediaTypes: media.DefaultTypes,
- cfg: deployconfig.DeployConfig{MaxDeletes: -1},
+ cfg: deployconfig.DeployConfig{Workers: 2, MaxDeletes: -1},
}
// Initial deployment should sync remote with local.
@@ -706,7 +706,7 @@ func TestMaxDeletes(t *testing.T) {
localFs: test.fs,
bucket: test.bucket,
mediaTypes: media.DefaultTypes,
- cfg: deployconfig.DeployConfig{MaxDeletes: -1},
+ cfg: deployconfig.DeployConfig{Workers: 2, MaxDeletes: -1},
}
// Sync remote with local.
@@ -836,7 +836,7 @@ func TestIncludeExclude(t *testing.T) {
}
deployer := &Deployer{
localFs: fsTest.fs,
- cfg: deployconfig.DeployConfig{MaxDeletes: -1}, bucket: fsTest.bucket,
+ cfg: deployconfig.DeployConfig{Workers: 2, MaxDeletes: -1}, bucket: fsTest.bucket,
target: tgt,
mediaTypes: media.DefaultTypes,
}
@@ -893,7 +893,7 @@ func TestIncludeExcludeRemoteDelete(t *testing.T) {
}
deployer := &Deployer{
localFs: fsTest.fs,
- cfg: deployconfig.DeployConfig{MaxDeletes: -1}, bucket: fsTest.bucket,
+ cfg: deployconfig.DeployConfig{Workers: 2, MaxDeletes: -1}, bucket: fsTest.bucket,
mediaTypes: media.DefaultTypes,
}
@@ -945,7 +945,7 @@ func TestCompression(t *testing.T) {
deployer := &Deployer{
localFs: test.fs,
bucket: test.bucket,
- cfg: deployconfig.DeployConfig{MaxDeletes: -1, Matchers: []*deployconfig.Matcher{{Pattern: ".*", Gzip: true, Re: regexp.MustCompile(".*")}}},
+ cfg: deployconfig.DeployConfig{Workers: 2, MaxDeletes: -1, Matchers: []*deployconfig.Matcher{{Pattern: ".*", Gzip: true, Re: regexp.MustCompile(".*")}}},
mediaTypes: media.DefaultTypes,
}
@@ -1000,7 +1000,7 @@ func TestMatching(t *testing.T) {
deployer := &Deployer{
localFs: test.fs,
bucket: test.bucket,
- cfg: deployconfig.DeployConfig{MaxDeletes: -1, Matchers: []*deployconfig.Matcher{{Pattern: "^subdir/aaa$", Force: true, Re: regexp.MustCompile("^subdir/aaa$")}}},
+ cfg: deployconfig.DeployConfig{Workers: 2, MaxDeletes: -1, Matchers: []*deployconfig.Matcher{{Pattern: "^subdir/aaa$", Force: true, Re: regexp.MustCompile("^subdir/aaa$")}}},
mediaTypes: media.DefaultTypes,
}
@@ -1097,5 +1097,6 @@ func verifyRemote(ctx context.Context, bucket *blob.Bucket, local []*fileData) (
func newDeployer() *Deployer {
return &Deployer{
logger: loggers.NewDefault(),
+ cfg: deployconfig.DeployConfig{Workers: 2},
}
}
diff --git a/docs/content/en/configuration/introduction.md b/docs/content/en/configuration/introduction.md
index 121a483c4..8f8ad4c1e 100644
--- a/docs/content/en/configuration/introduction.md
+++ b/docs/content/en/configuration/introduction.md
@@ -249,7 +249,7 @@ HUGO_FILE_LOG_FORMAT
HUGO_MEMORYLIMIT
: {{< new-in 0.123.0 />}}
-: (`int`) The maximum amount of system memory, in gigabytes, that Hugo can use while rendering your site. Default is 25% of total system memory. Note that The `HUGO_MEMORYLIMIT` is a “best effort” setting. Don't expect Hugo to build a million pages with only 1 GB memory. You can get more information about how this behaves during the build by building with `hugo --logLevel info` and look for the `dynacache` label.
+: (`int`) The maximum amount of system memory, in gigabytes, that Hugo can use while rendering your site. Default is 25% of total system memory. Note that `HUGO_MEMORYLIMIT` is a "best effort" setting. Don't expect Hugo to build a million pages with only 1 GB of memory. You can get more information about how this behaves during the build by building with `hugo --logLevel info` and look for the `dynacache` label.
HUGO_NUMWORKERMULTIPLIER
: (`int`) The number of workers used in parallel processing. Default is the number of logical CPUs.
diff --git a/docs/content/en/content-management/menus.md b/docs/content/en/content-management/menus.md
index ab1bcbfa1..6d01173dc 100644
--- a/docs/content/en/content-management/menus.md
+++ b/docs/content/en/content-management/menus.md
@@ -11,7 +11,7 @@ aliases: [/extras/menus/]
To create a menu for your site:
1. Define the menu entries
-1. [Localize] each entry
+1. [Localize](multilingual/#menus) each entry
1. Render the menu with a [template]
Create multiple menus, either flat or nested. For example, create a main menu for the header, and a separate menu for the footer.
diff --git a/docs/content/en/contribute/documentation.md b/docs/content/en/contribute/documentation.md
index 1d185d21d..68129912a 100644
--- a/docs/content/en/contribute/documentation.md
+++ b/docs/content/en/contribute/documentation.md
@@ -112,7 +112,7 @@ Yes → Hugo is fast.
### Function and method descriptions
-Start descriptions in the functions and methods sections with "Returns", of for booelan values, "Reports whether".
+Start descriptions in the functions and methods sections with "Returns", or for boolean values, "Reports whether".
### File paths and names
diff --git a/docs/content/en/functions/collections/Where.md b/docs/content/en/functions/collections/Where.md
index 1df84afc4..84fd1d21e 100644
--- a/docs/content/en/functions/collections/Where.md
+++ b/docs/content/en/functions/collections/Where.md
@@ -87,7 +87,6 @@ Use any of the following logical operators:
: (`bool`) Reports whether the given field value (a slice) contains one or more elements in common with `VALUE`. See [details](/functions/collections/intersect).
`like`
-: {{< new-in 0.116.0 />}}
: (`bool`) Reports whether the given field value matches the [regular expression](g) specified in `VALUE`. Use the `like` operator to compare `string` values. The `like` operator returns `false` when comparing other data types to the regular expression.
> [!note]
@@ -167,8 +166,6 @@ For example, to return a collection of pages where any of the terms in the "genr
## Regular expression comparison
-{{< new-in 0.116.0 />}}
-
To return a collection of pages where the "author" page parameter begins with either "victor" or "Victor":
```go-html-template
diff --git a/docs/content/en/functions/css/Sass.md b/docs/content/en/functions/css/Sass.md
index 1d5487130..03a4c7451 100644
--- a/docs/content/en/functions/css/Sass.md
+++ b/docs/content/en/functions/css/Sass.md
@@ -12,13 +12,66 @@ params:
{{< new-in 0.128.0 />}}
-```go-html-template
+Transpile Sass to CSS using the LibSass transpiler included in Hugo's extended and extended/deploy editions, or [install Dart Sass](#dart-sass) to use the latest features of the Sass language.
+
+Sass has two forms of syntax: [SCSS] and [indented]. Hugo supports both.
+
+[scss]: https://sass-lang.com/documentation/syntax#scss
+[indented]: https://sass-lang.com/documentation/syntax#the-indented-syntax
+
+## Options
+
+enableSourceMap
+: (`bool`) Whether to generate a source map. Default is `false`.
+
+includePaths
+: (`slice`) A slice of paths, relative to the project root, that the transpiler will use when resolving `@use` and `@import` statements.
+
+outputStyle
+: (`string`) The output style of the resulting CSS. With LibSass, one of `nested` (default), `expanded`, `compact`, or `compressed`. With Dart Sass, either `expanded` (default) or `compressed`.
+
+precision
+: (`int`) The precision of floating point math. Applicable to LibSass. Default is `8`.
+
+silenceDeprecations
+: {{< new-in 0.139.0 />}}
+: (`slice`) A slice of deprecation IDs to silence. IDs are enclosed in brackets within Dart Sass warning messages (e.g., `import` in `WARN Dart Sass: DEPRECATED [import]`). Applicable to Dart Sass. Default is `false`.
+
+silenceDependencyDeprecations
+: {{< new-in 0.146.0 />}}
+: (`bool`) Whether to silence deprecation warnings from dependencies, where a dependency is considered any file transitively imported through a load path. This does not apply to `@warn` or `@debug` rules.Default is `false`.
+
+sourceMapIncludeSources
+: (`bool`) Whether to embed sources in the generated source map. Applicable to Dart Sass. Default is `false`.
+
+targetPath
+: (`string`) The publish path for the transformed resource, relative to the[`publishDir`]. If unset, the target path defaults to the asset's original path with a `.css` extension.
+
+transpiler
+: (`string`) The transpiler to use, either `libsass` or `dartsass`. Hugo's extended and extended/deploy editions include the LibSass transpiler. To use the Dart Sass transpiler, see the [installation instructions](#dart-sass). Default is `libsass`.
+
+vars
+: (`map`) A map of key-value pairs that will be available in the `hugo:vars` namespace. Useful for [initializing Sass variables from Hugo templates](https://discourse.gohugo.io/t/42053/).
+
+ ```scss
+ // LibSass
+ @import "hugo:vars";
+
+ // Dart Sass
+ @use "hugo:vars" as v;
+ ```
+
+## Example
+
+```go-html-template {copy=true}
{{ with resources.Get "sass/main.scss" }}
{{ $opts := dict
"enableSourceMap" (not hugo.IsProduction)
"outputStyle" (cond hugo.IsProduction "compressed" "expanded")
"targetPath" "css/main.css"
- "transpiler" "libsass"
+ "transpiler" "dartsass"
+ "vars" site.Params.styles
+ "includePaths" (slice "node_modules/bootstrap/scss")
}}
{{ with . | toCSS $opts }}
{{ if hugo.IsProduction }}
@@ -32,63 +85,6 @@ params:
{{ end }}
```
-Transpile Sass to CSS using the LibSass transpiler included in Hugo's extended and extended/deploy editions, or [install Dart Sass](#dart-sass) to use the latest features of the Sass language.
-
-Sass has two forms of syntax: [SCSS] and [indented]. Hugo supports both.
-
-[scss]: https://sass-lang.com/documentation/syntax#scss
-[indented]: https://sass-lang.com/documentation/syntax#the-indented-syntax
-
-## Options
-
-transpiler
-: (`string`) The transpiler to use, either `libsass` (default) or `dartsass`. Hugo's extended and extended/deploy editions include the LibSass transpiler. To use the Dart Sass transpiler, see the [installation instructions](#dart-sass) below.
-
-targetPath
-: (`string`) If not set, the transformed resource's target path will be the original path of the asset file with its extension replaced by `.css`.
-
-vars
-: (`map`) A map of key-value pairs that will be available in the `hugo:vars` namespace. Useful for [initializing Sass variables from Hugo templates](https://discourse.gohugo.io/t/42053/).
-
-```scss
-// LibSass
-@import "hugo:vars";
-
-// Dart Sass
-@use "hugo:vars" as v;
-```
-
-outputStyle
-: (`string`) Output styles available to LibSass include `nested` (default), `expanded`, `compact`, and `compressed`. Output styles available to Dart Sass include `expanded` (default) and `compressed`.
-
-precision
-: (`int`) Precision of floating point math. Not applicable to Dart Sass.
-
-enableSourceMap
-: (`bool`) Whether to generate a source map. Default is `false`.
-
-sourceMapIncludeSources
-: (`bool`) Whether to embed sources in the generated source map. Not applicable to LibSass. Default is `false`.
-
-includePaths
-: (`slice`) A slice of paths, relative to the project root, that the transpiler will use when resolving `@use` and `@import` statements.
-
-```go-html-template
-{{ $opts := dict
- "transpiler" "dartsass"
- "targetPath" "css/style.css"
- "vars" site.Params.styles
- "enableSourceMap" (not hugo.IsProduction)
- "includePaths" (slice "node_modules/bootstrap/scss")
-}}
-{{ with resources.Get "sass/main.scss" | toCSS $opts | minify | fingerprint }}
-
-{{ end }}
-```
-
-silenceDeprecations
-: (`slice`) {{< new-in 0.139.0 />}} A slice of deprecation IDs to silence. The deprecation IDs are printed to in the warning message, e.g "import" in `WARN Dart Sass: DEPRECATED [import] ...`. This is for Dart Sass only.
-
## Dart Sass
Hugo's extended and extended/deploy editions include [LibSass] to transpile Sass to CSS. In 2020, the Sass team deprecated LibSass in favor of [Dart Sass].
@@ -121,6 +117,9 @@ You may also install [prebuilt binaries] for Linux, macOS, and Windows.
Run `hugo env` to list the active transpilers.
+> [!note]
+> If you build Hugo from source and run `mage test -v`, the test will fail if you install Dart Sass as a Snap package. This is due to the Snap package's strict confinement model.
+
### Installing in a production environment
For [CI/CD](g) deployments (e.g., GitHub Pages, GitLab Pages, Netlify, etc.) you must edit the workflow to install Dart Sass before Hugo builds the site[^2]. Some providers allow you to use one of the package managers above, or you can download and extract one of the prebuilt binaries.
@@ -136,8 +135,6 @@ To install Dart Sass for your builds on GitHub Pages, add this step to the GitHu
run: sudo snap install dart-sass
```
-If you are using GitHub Pages for the first time with your repository, GitHub provides a [starter workflow] for Hugo that includes Dart Sass. This is the simplest way to get started.
-
#### GitLab Pages
To install Dart Sass for your builds on GitLab Pages, the `.gitlab-ci.yml` file should look something like this:
@@ -194,34 +191,6 @@ command = """\
"""
```
-### Example
-
-To transpile with Dart Sass, set `transpiler` to `dartsass` in the options map passed to `css.Sass`. For example:
-
-```go-html-template
-{{ with resources.Get "sass/main.scss" }}
- {{ $opts := dict
- "enableSourceMap" (not hugo.IsProduction)
- "outputStyle" (cond hugo.IsProduction "compressed" "expanded")
- "targetPath" "css/main.css"
- "transpiler" "dartsass"
- }}
- {{ with . | toCSS $opts }}
- {{ if hugo.IsProduction }}
- {{ with . | fingerprint }}
-
- {{ end }}
- {{ else }}
-
- {{ end }}
- {{ end }}
-{{ end }}
-```
-
-### Miscellaneous
-
-If you build Hugo from source and run `mage test -v`, the test will fail if you install Dart Sass as a Snap package. This is due to the Snap package's strict confinement model.
-
[brew.sh]: https://brew.sh/
[chocolatey.org]: https://community.chocolatey.org/packages/sass
[dart sass]: https://sass-lang.com/dart-sass
@@ -232,3 +201,4 @@ If you build Hugo from source and run `mage test -v`, the test will fail if you
[snap package]: /installation/linux/#snap
[snapcraft.io]: https://snapcraft.io/dart-sass
[starter workflow]: https://github.com/actions/starter-workflows/blob/main/pages/hugo.yml
+[`publishDir`]: /configuration/all/#publishdir
diff --git a/docs/content/en/functions/go-template/template.md b/docs/content/en/functions/go-template/template.md
index dac1fa3be..053cfcc22 100644
--- a/docs/content/en/functions/go-template/template.md
+++ b/docs/content/en/functions/go-template/template.md
@@ -10,7 +10,18 @@ params:
signatures: ['template NAME [CONTEXT]']
---
-Use the `template` function to execute [embedded templates]. For example:
+Use the `template` function to execute any of these [embedded templates](g):
+
+- [`disqus.html`]
+- [`google_analytics.html`]
+- [`opengraph.html`]
+- [`pagination.html`]
+- [`schema.html`]
+- [`twitter_cards.html`]
+
+
+
+For example:
```go-html-template
{{ range (.Paginate .Pages).Pages }}
@@ -39,8 +50,21 @@ The example above can be rewritten using an [inline partial] template:
{{ end }}
```
+The key distinctions between the preceding two examples are:
+
+1. Inline partials are globally scoped. That means that an inline partial defined in _one_ template may be called from _any_ template.
+2. Leveraging the [`partialCached`] function when calling an inline partial allows for performance optimization through result caching.
+3. An inline partial can [`return`] a value of any data type instead of rendering a string.
+
{{% include "/_common/functions/go-template/text-template.md" %}}
+[`disqus.html`]: /templates/embedded/#disqus
+[`google_analytics.html`]: /templates/embedded/#google-analytics
+[`opengraph.html`]: /templates/embedded/#open-graph
+[`pagination.html`]: /templates/embedded/#pagination
+[`partialCached`]: /functions/partials/includecached/
[`partial`]: /functions/partials/include/
+[`return`]: /functions/go-template/return/
+[`schema.html`]: /templates/embedded/#schema
+[`twitter_cards.html`]: /templates/embedded/#x-twitter-cards
[inline partial]: /templates/partial/#inline-partials
-[embedded templates]: /templates/embedded/
diff --git a/docs/content/en/functions/images/Text.md b/docs/content/en/functions/images/Text.md
index 94cdb4e9d..8f7e730ba 100644
--- a/docs/content/en/functions/images/Text.md
+++ b/docs/content/en/functions/images/Text.md
@@ -18,6 +18,9 @@ alignx
: {{< new-in 0.141.0 />}}
: (`string`) The horizontal alignment of the text relative to the horizontal offset, one of `left`, `center`, or `right`. Default is `left`.
+aligny
+: (`string`) The vertical alignment of the text relative to the vertical offset, one of `top`, `center`, or `bottom`. Default is `top`.
+
color
: (`string`) The font color, either a 3-digit or 6-digit hexadecimal color code. Default is `#ffffff` (white).
diff --git a/docs/content/en/functions/templates/Current.md b/docs/content/en/functions/templates/Current.md
new file mode 100644
index 000000000..805aeec05
--- /dev/null
+++ b/docs/content/en/functions/templates/Current.md
@@ -0,0 +1,155 @@
+---
+title: templates.Current
+description: Returns information about the currently executing template.
+categories: []
+keywords: []
+params:
+ functions_and_methods:
+ aliases: []
+ returnType: tpl.CurrentTemplateInfo
+ signatures: [templates.Current]
+---
+
+> [!note]
+> This function is experimental and subject to change.
+
+{{< new-in 0.146.0 />}}
+
+The `templates.Current` function provides introspection capabilities, allowing you to access details about the currently executing templates. This is useful for debugging complex template hierarchies and understanding the flow of execution during rendering.
+
+## Methods
+
+Ancestors
+: (`tpl.CurrentTemplateInfos`) Returns a slice containing information about each template in the current execution chain, starting from the parent of the current template and going up towards the initial template called. It excludes any base template applied via `define` and `block`. You can chain the `Reverse` method to this result to get the slice in chronological execution order.
+
+Base
+: (`tpl.CurrentTemplateInfoCommonOps`) Returns an object representing the base template that was applied to the current template, if any. This may be `nil`.
+
+Filename
+: (`string`) Returns the absolute path of the current template. This will be empty for embedded templates.
+
+Name
+: (`string`) Returns the name of the current template. This is usually the path relative to the layouts directory.
+
+Parent
+: (`tpl.CurrentTemplateInfo`) Returns an object representing the parent of the current template, if any. This may be `nil`.
+
+## Examples
+
+The examples below help visualize template execution and require a `debug` parameter set to `true` in your site configuration:
+
+{{< code-toggle file=hugo >}}
+[params]
+debug = true
+{{< /code-toggle >}}
+
+### Boundaries
+
+To visually mark where a template begins and ends execution:
+
+```go-html-template {file="layouts/_default/single.html"}
+{{ define "main" }}
+ {{ if site.Params.debug }}
+
[entering {{ templates.Current.Filename }}]
+ {{ end }}
+
+
{{ .Title }}
+ {{ .Content }}
+
+ {{ if site.Params.debug }}
+
[leaving {{ templates.Current.Filename }}]
+ {{ end }}
+{{ end }}
+```
+
+### Call stack
+
+To display the chain of templates that led to the current one, create a partial template that iterates through its ancestors:
+
+```go-html-template {file="layouts/partials/template-call-stack.html" copy=true}
+{{ with templates.Current }}
+
+ {{ range .Ancestors }}
+ {{ .Filename }}
+ {{ with .Base }}
+ {{ .Filename }}
+ {{ end }}
+ {{ end }}
+
+{{ end }}
+```
+
+Then call the partial from any template:
+
+```go-html-template {file="layouts/partials/footer/copyright.html" copy=true}
+{{ if site.Params.debug }}
+ {{ partial "template-call-stack.html" . }}
+{{ end }}
+```
+
+The rendered template stack would look something like this:
+
+```text
+/home/user/project/layouts/partials/footer/copyright.html
+/home/user/project/themes/foo/layouts/partials/footer.html
+/home/user/project/layouts/_default/single.html
+/home/user/project/themes/foo/layouts/_default/baseof.html
+```
+
+To reverse the order of the entries, chain the `Reverse` method to the `Ancestors` method:
+
+```go-html-template {file="layouts/partials/template-call-stack.html" copy=true}
+{{ with templates.Current }}
+
+ {{ range .Ancestors.Reverse }}
+ {{ with .Base }}
+ {{ .Filename }}
+ {{ end }}
+ {{ .Filename }}
+ {{ end }}
+
+{{ end }}
+```
+
+### VS Code
+
+To render links that, when clicked, will open the template in Microsoft Visual Studio Code, create a partial template with anchor elements that use the `vscode` URI scheme:
+
+```go-html-template {file="layouts/partials/template-open-in-vs-code.html" copy=true}
+{{ with templates.Current.Parent }}
+
+{{ end }}
+```
diff --git a/docs/content/en/functions/time/In.md b/docs/content/en/functions/time/In.md
new file mode 100644
index 000000000..821eb99b7
--- /dev/null
+++ b/docs/content/en/functions/time/In.md
@@ -0,0 +1,30 @@
+---
+title: time.In
+description: Returns the given date/time as represented in the specified IANA time zone.
+categories: []
+keywords: []
+params:
+ functions_and_methods:
+ aliases: []
+ returnType: time.Time
+ signatures: [time.In TIMEZONE INPUT]
+---
+
+{{< new-in 0.146.0 />}}
+
+The `time.In` function returns the given date/time as represented in the specified [IANA](g) time zone.
+
+- If the time zone is an empty string or `UTC`, the time is returned in [UTC](g).
+- If the time zone is `Local`, the time is returned in the system's local time zone.
+- Otherwise, the time zone must be a valid IANA [time zone name].
+
+[time zone name]: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List
+
+```go-html-template
+{{ $layout := "2006-01-02T15:04:05-07:00" }}
+{{ $t := time.AsTime "2025-03-31T14:45:00-00:00" }}
+
+{{ $t | time.In "America/Denver" | time.Format $layout }} → 2025-03-31T08:45:00-06:00
+{{ $t | time.In "Australia/Adelaide" | time.Format $layout }} → 2025-04-01T01:15:00+10:30
+{{ $t | time.In "Europe/Oslo" | time.Format $layout }} → 2025-03-31T16:45:00+02:00
+```
diff --git a/docs/content/en/functions/transform/Unmarshal.md b/docs/content/en/functions/transform/Unmarshal.md
index d159122f5..93168294c 100644
--- a/docs/content/en/functions/transform/Unmarshal.md
+++ b/docs/content/en/functions/transform/Unmarshal.md
@@ -114,12 +114,14 @@ A remote resource is a file on a remote server, accessible via HTTP or HTTPS.
>
> `{{ $data = .Content | transform.Unmarshal }}`
-## Options
+## Working with CSV
+
+### Options
When unmarshaling a CSV file, provide an optional map of options.
delimiter
-: (`string`) The delimiter used, default is `,`.
+: (`string`) The delimiter used. Default is `,`.
comment
: (`string`) The comment character used in the CSV. If set, lines beginning with the comment character without preceding whitespace are ignored.
@@ -128,8 +130,85 @@ lazyQuotes
: {{< new-in 0.122.0 />}}
: (`bool`) Whether to allow a quote in an unquoted field, or to allow a non-doubled quote in a quoted field. Default is `false`.
+targetType
+: {{< new-in 0.146.7 />}}
+: (`string`) The target data type, either `slice` or `map`. Default is `slice`.
+
+### Examples
+
+The examples below use this CSV file:
+
+```csv
+"name","type","breed","age"
+"Spot","dog","Collie",3
+"Rover","dog","Boxer",5
+"Felix","cat","Calico",7
+```
+
+To render an HTML table from a CSV file:
+
```go-html-template
-{{ $csv := "a;b;c" | transform.Unmarshal (dict "delimiter" ";") }}
+{{ $data := slice }}
+{{ $file := "pets.csv" }}
+{{ with or (.Resources.Get $file) (resources.Get $file) }}
+ {{ $opts := dict "targetType" "slice" }}
+ {{ $data = transform.Unmarshal $opts . }}
+{{ end }}
+
+{{ with $data }}
+
+
+
+ {{ range index . 0 }}
+
{{ . }}
+ {{ end }}
+
+
+
+ {{ range . | after 1 }}
+
+ {{ range . }}
+
{{ . }}
+ {{ end }}
+
+ {{ end }}
+
+
+{{ end }}
+```
+
+To extract a subset of the data, or to sort the data, unmarshal to a map instead of a slice:
+
+```go-html-template
+{{ $data := slice }}
+{{ $file := "pets.csv" }}
+{{ with or (.Resources.Get $file) (resources.Get $file) }}
+ {{ $opts := dict "targetType" "map" }}
+ {{ $data = transform.Unmarshal $opts . }}
+{{ end }}
+
+{{ with sort (where $data "type" "dog") "name" "asc" }}
+
+
+
+
name
+
type
+
breed
+
age
+
+
+
+ {{ range . }}
+
+
{{ .name }}
+
{{ .type }}
+
{{ .breed }}
+
{{ .age }}
+
+ {{ end }}
+
+
+{{ end }}
```
## Working with XML
diff --git a/docs/content/en/host-and-deploy/host-on-github-pages/index.md b/docs/content/en/host-and-deploy/host-on-github-pages/index.md
index 4c00fbc8e..7c3201099 100644
--- a/docs/content/en/host-and-deploy/host-on-github-pages/index.md
+++ b/docs/content/en/host-and-deploy/host-on-github-pages/index.md
@@ -136,6 +136,8 @@ jobs:
key: hugo-${{ github.run_id }}
restore-keys:
hugo-
+ - name: Configure Git
+ run: git config core.quotepath false
- name: Build with Hugo
run: |
hugo \
diff --git a/docs/content/en/host-and-deploy/host-on-gitlab-pages.md b/docs/content/en/host-and-deploy/host-on-gitlab-pages.md
index 4b308cc19..4750b0ff3 100644
--- a/docs/content/en/host-and-deploy/host-on-gitlab-pages.md
+++ b/docs/content/en/host-and-deploy/host-on-gitlab-pages.md
@@ -23,15 +23,15 @@ Define your [CI/CD](g) jobs by creating a `.gitlab-ci.yml` file in the root of y
```yaml {file=".gitlab-ci.yml" copy=true}
variables:
- DART_SASS_VERSION: 1.85.0
+ DART_SASS_VERSION: 1.87.0
GIT_DEPTH: 0
GIT_STRATEGY: clone
GIT_SUBMODULE_STRATEGY: recursive
- HUGO_VERSION: 0.144.2
- NODE_VERSION: 23.x
+ HUGO_VERSION: 0.146.7
+ NODE_VERSION: 22.x
TZ: America/Los_Angeles
image:
- name: golang:1.23.4-bookworm
+ name: golang:1.24.2-bookworm
pages:
script:
@@ -53,6 +53,8 @@ pages:
- apt-get install -y nodejs
# Install Node.js dependencies
- "[[ -f package-lock.json || -f npm-shrinkwrap.json ]] && npm ci || true"
+ # Configure Git
+ - git config core.quotepath false
# Build
- hugo --gc --minify --baseURL ${CI_PAGES_URL}
# Compress
diff --git a/docs/content/en/host-and-deploy/host-on-netlify/index.md b/docs/content/en/host-and-deploy/host-on-netlify/index.md
index f3601331a..4c89a6c1e 100644
--- a/docs/content/en/host-and-deploy/host-on-netlify/index.md
+++ b/docs/content/en/host-and-deploy/host-on-netlify/index.md
@@ -113,21 +113,23 @@ Create a new file named netlify.toml in the root of your project directory. In i
```toml {file="netlify.toml"}
[build.environment]
-HUGO_VERSION = "0.144.2"
+GO_VERSION = "1.24"
+HUGO_VERSION = "0.146.7"
NODE_VERSION = "22"
TZ = "America/Los_Angeles"
[build]
publish = "public"
-command = "hugo --gc --minify"
+command = "git config core.quotepath false && hugo --gc --minify"
```
If your site requires Dart Sass to transpile Sass to CSS, the configuration file should look something like this:
```toml {file="netlify.toml"}
[build.environment]
-HUGO_VERSION = "0.144.2"
-DART_SASS_VERSION = "1.85.0"
+DART_SASS_VERSION = "1.87.0"
+GO_VERSION = "1.24"
+HUGO_VERSION = "0.146.7"
NODE_VERSION = "22"
TZ = "America/Los_Angeles"
@@ -138,6 +140,7 @@ command = """\
tar -xf dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz && \
rm dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz && \
export PATH=/opt/build/repo/dart-sass:$PATH && \
+ git config core.quotepath false && \
hugo --gc --minify \
"""
```
diff --git a/docs/content/en/installation/linux.md b/docs/content/en/installation/linux.md
index 731cfce4c..591bf0818 100644
--- a/docs/content/en/installation/linux.md
+++ b/docs/content/en/installation/linux.md
@@ -30,17 +30,33 @@ To install the extended edition of Hugo:
sudo snap install hugo
```
-To enable or revoke access to removable media:
+To control automatic updates:
```sh
+# disable automatic updates
+sudo snap refresh --hold hugo
+
+# enable automatic updates
+sudo snap refresh --unhold hugo
+```
+
+To control access to removable media:
+
+```sh
+# allow access
sudo snap connect hugo:removable-media
+
+# revoke access
sudo snap disconnect hugo:removable-media
```
-To enable or revoke access to SSH keys:
+To control access to SSH keys:
```sh
+# allow access
sudo snap connect hugo:ssh-keys
+
+# revoke access
sudo snap disconnect hugo:ssh-keys
```
diff --git a/docs/content/en/news/_content.gotmpl b/docs/content/en/news/_content.gotmpl
index f979c9adc..af3cf47ed 100644
--- a/docs/content/en/news/_content.gotmpl
+++ b/docs/content/en/news/_content.gotmpl
@@ -23,7 +23,8 @@
"dates" $dates
"kind" "page"
"params" $params
- "path" .name
+ "path" (strings.Replace .name "." "-")
+ "slug" .name
"title" (printf "Release %s" .name)
}}
{{ $.AddPage $page }}
diff --git a/docs/content/en/quick-reference/glossary/iana.md b/docs/content/en/quick-reference/glossary/iana.md
new file mode 100644
index 000000000..89497f76a
--- /dev/null
+++ b/docs/content/en/quick-reference/glossary/iana.md
@@ -0,0 +1,6 @@
+---
+title: IANA
+reference: https://www.iana.org/about
+---
+
+_IANA_ is an abbreviation for the Internet Assigned Numbers Authority, a non-profit organization that manages the allocation of global IP addresses, autonomous system numbers, DNS root zone, media types, and other Internet Protocol-related resources.
diff --git a/docs/content/en/quick-reference/glossary/utc.md b/docs/content/en/quick-reference/glossary/utc.md
new file mode 100644
index 000000000..a4627be5a
--- /dev/null
+++ b/docs/content/en/quick-reference/glossary/utc.md
@@ -0,0 +1,6 @@
+---
+title: UTC
+reference: https://en.wikipedia.org/wiki/Coordinated_Universal_Time
+---
+
+_UTC_ is an abbreviation for Coordinated Universal Time, the primary time standard used worldwide to regulate clocks and time. It is the basis for civil time and time zones across the globe.
diff --git a/docs/content/en/shortcodes/ref.md b/docs/content/en/shortcodes/ref.md
index 2f821254c..a52c2bf6e 100755
--- a/docs/content/en/shortcodes/ref.md
+++ b/docs/content/en/shortcodes/ref.md
@@ -10,7 +10,7 @@ keywords: []
> To override Hugo's embedded `ref` shortcode, copy the [source code] to a file with the same name in the `layouts/shortcodes` directory.
> [!note]
-> When working with the Markdown [content format], this shortcode has become largely redundant. Its functionality is now primarily handled by [link render hooks], specifically the embedded one provided by Hugo. This hook effectively addresses all the use cases previously covered by this shortcode.
+> When working with Markdown, this shortcode is obsolete. Instead, use a [link render hook] that resolves the link destination using the `GetPage` method on the `Page` object. You can either create your own, or simply enable the [embedded link render hook]. The embedded link render hook is automatically enabled for multilingual single-host projects.
## Usage
@@ -56,6 +56,7 @@ Rendered:
{{% include "_common/ref-and-relref-error-handling.md" %}}
[content format]: /content-management/formats/
-[link render hooks]: /render-hooks/images/#default
+[embedded link render hook]: /render-hooks/links/#default
+[link render hook]: /render-hooks/links/
[Markdown notation]: /content-management/shortcodes/#notation
-[source code]: {{% eturl ref %}}
+[source code]: {{% eturl relref %}}
diff --git a/docs/content/en/shortcodes/relref.md b/docs/content/en/shortcodes/relref.md
index 5b413b87e..219eae81a 100755
--- a/docs/content/en/shortcodes/relref.md
+++ b/docs/content/en/shortcodes/relref.md
@@ -10,7 +10,7 @@ keywords: []
> To override Hugo's embedded `relref` shortcode, copy the [source code] to a file with the same name in the `layouts/shortcodes` directory.
> [!note]
-> When working with the Markdown [content format], this shortcode has become largely redundant. Its functionality is now primarily handled by [link render hooks], specifically the embedded one provided by Hugo. This hook effectively addresses all the use cases previously covered by this shortcode.
+> When working with Markdown, this shortcode is obsolete. Instead, use a [link render hook] that resolves the link destination using the `GetPage` method on the `Page` object. You can either create your own, or simply enable the [embedded link render hook]. The embedded link render hook is automatically enabled for multilingual single-host projects.
## Usage
@@ -56,6 +56,7 @@ Rendered:
{{% include "_common/ref-and-relref-error-handling.md" %}}
[content format]: /content-management/formats/
-[link render hooks]: /render-hooks/links/
+[embedded link render hook]: /render-hooks/links/#default
+[link render hook]: /render-hooks/links/
[Markdown notation]: /content-management/shortcodes/#notation
[source code]: {{% eturl relref %}}
diff --git a/docs/content/en/shortcodes/vimeo.md b/docs/content/en/shortcodes/vimeo.md
index c354eefe0..1164ce997 100755
--- a/docs/content/en/shortcodes/vimeo.md
+++ b/docs/content/en/shortcodes/vimeo.md
@@ -29,19 +29,27 @@ Hugo renders this to:
## Arguments
+id
+: (string) The video `id`. Optional if the `id` is provided as a positional argument as shown in the example above.
+
+allowFullScreen
+: {{< new-in 0.146.0 />}}
+: (`bool`) Whether the `iframe` element can activate full screen mode. Default is `true`.
+
class
: (`string`) The `class` attribute of the wrapping `div` element. Adding one or more CSS classes disables inline styling.
-id
-: (`string`) The `id` of the Vimeo video
+loading
+: {{< new-in 0.146.0 />}}
+: (`string`) The loading attribute of the `iframe` element, either `eager` or `lazy`. Default is `eager`.
title
: (`string`) The `title` attribute of the `iframe` element.
-If you provide a `class` or `title` you must use a named parameter for the `id`.
+Here's an example using some of the available arguments:
```text
-{{* vimeo id=55073825 class="foo bar" title="My Video" */>}}
+{{* vimeo id=55073825 allowFullScreen=false loading=lazy */>}}
```
## Privacy
diff --git a/docs/content/en/shortcodes/youtube.md b/docs/content/en/shortcodes/youtube.md
index 18c5ae6c2..ed3cf0632 100755
--- a/docs/content/en/shortcodes/youtube.md
+++ b/docs/content/en/shortcodes/youtube.md
@@ -70,7 +70,7 @@ start
title
: (`string`) The `title` attribute of the `iframe` element. Defaults to "YouTube video".
-Example using some of the above:
+Here's an example using some of the available arguments:
```text
{{* youtube id=0RKpf3rK57I start=30 end=60 loading=lazy */>}}
diff --git a/docs/content/en/templates/embedded.md b/docs/content/en/templates/embedded.md
index 198136393..ecfd90514 100644
--- a/docs/content/en/templates/embedded.md
+++ b/docs/content/en/templates/embedded.md
@@ -1,6 +1,6 @@
---
-title: Embedded templates
-description: Hugo provides embedded templates for common use cases.
+title: Embedded partial templates
+description: Hugo provides embedded partial templates for common use cases.
categories: []
keywords: []
weight: 170
@@ -145,6 +145,10 @@ Various optional metadata can also be set:
If using YouTube this will produce a og:video tag like ``. Use the `https://youtu.be/` format with YouTube videos (example: `https://youtu.be/qtIqKaDlqXo`).
+## Pagination
+
+See [details](/templates/pagination/).
+
## Schema
> [!note]
diff --git a/docs/content/en/templates/partial.md b/docs/content/en/templates/partial.md
index 8493a4674..7ff2d9594 100644
--- a/docs/content/en/templates/partial.md
+++ b/docs/content/en/templates/partial.md
@@ -49,7 +49,7 @@ As shown in the above example directory structure, you can nest your directories
### Variable scoping
-The second argument in a partial call is the variable being passed down. The above examples are passing the `.`, which tells the template receiving the partial to apply the current [context][context].
+The second argument in a partial call is the variable being passed down. The above examples are passing the dot (`.`), which tells the template receiving the partial to apply the current [context][context].
This means the partial will *only* be able to access those variables. The partial is isolated and cannot access the outer scope. From within the partial, `$.Var` is equivalent to `.Var`.
diff --git a/docs/content/en/templates/shortcode.md b/docs/content/en/templates/shortcode.md
index 711d342cb..3ed573651 100644
--- a/docs/content/en/templates/shortcode.md
+++ b/docs/content/en/templates/shortcode.md
@@ -329,7 +329,7 @@ You can use the `HasShortcode` method in your base template to conditionally loa
[`with`]: /functions/go-template/with/
[content management]: /content-management/shortcodes/
[embedded shortcodes]: /shortcodes/
-[GitHub]: https://github.com/gohugoio/hugo/tree/master/tpl/tplimpl/embedded/templates/shortcodes
+[GitHub]: https://github.com/gohugoio/hugo/tree/master/tpl/tplimpl/embedded/templates/_shortcodes
[introduction to templating]: /templates/introduction/
[Markdown notation]: /content-management/shortcodes/#markdown-notation
[named or positional]: /content-management/shortcodes/#arguments
diff --git a/docs/content/en/troubleshooting/inspection.md b/docs/content/en/troubleshooting/inspection.md
index dc662243a..ea3c097f9 100644
--- a/docs/content/en/troubleshooting/inspection.md
+++ b/docs/content/en/troubleshooting/inspection.md
@@ -34,6 +34,11 @@ Use the [`printf`] function (render) or [`warnf`] function (log to console) to i
{{ printf "%[1]v (%[1]T)" $value }} → 42 (int)
```
+{{< new-in 0.146.0 />}}
+
+Use the [`templates.Current`] function to visually mark template execution boundaries or to display the template call stack.
+
[`debug.Dump`]: /functions/debug/dump/
[`printf`]: /functions/fmt/printf/
[`warnf`]: /functions/fmt/warnf/
+[`templates.Current`]: /functions/templates/current/
diff --git a/docs/data/embedded_template_urls.toml b/docs/data/embedded_template_urls.toml
index f75b14f12..b2a796cd1 100644
--- a/docs/data/embedded_template_urls.toml
+++ b/docs/data/embedded_template_urls.toml
@@ -4,39 +4,39 @@
# BaseURL
'base_url' = 'https://github.com/gohugoio/hugo/blob/master/tpl/tplimpl/embedded/templates'
-# Templates
-'alias' = 'alias.html'
-'disqus' = 'disqus.html'
-'google_analytics' = 'google_analytics.html'
-'opengraph' = 'opengraph.html'
-'pagination' = 'pagination.html'
-'robots' = '_default/robots.txt'
-'rss' = '_default/rss.xml'
-'schema' = 'schema.html'
-'sitemap' = '_default/sitemap.xml'
-'sitemapindex' = '_default/sitemapindex.xml'
-'twitter_cards' = 'twitter_cards.html'
+# Partials
+'disqus' = '_partials/disqus.html'
+'google_analytics' = '_partials/google_analytics.html'
+'opengraph' = '_partials/opengraph.html'
+'pagination' = '_partials/pagination.html'
+'schema' = '_partials/schema.html'
+'twitter_cards' = '_partials/twitter_cards.html'
# Render hooks
-'render-codeblock-goat' = '_default/_markup/render-codeblock-goat.html'
-'render-image' = '_default/_markup/render-image.html'
-'render-link' = '_default/_markup/render-link.html'
-'render-table' = '_default/_markup/render-table.html'
+'render-codeblock-goat' = '_markup/render-codeblock-goat.html'
+'render-image' = '_markup/render-image.html'
+'render-link' = '_markup/render-link.html'
+'render-table' = '_markup/render-table.html'
# Shortcodes
-'details' = 'shortcodes/details.html'
-'figure' = 'shortcodes/figure.html'
-'gist' = 'shortcodes/gist.html'
-'highlight' = 'shortcodes/highlight.html'
-'instagram' = 'shortcodes/instagram.html'
-'param' = 'shortcodes/param.html'
-'qr' = 'shortcodes/qr.html'
-'ref' = 'shortcodes/ref.html'
-'relref' = 'shortcodes/relref.html'
-'twitter' = 'shortcodes/twitter.html'
-'twitter_simple' = 'shortcodes/twitter_simple.html'
-'vimeo' = 'shortcodes/vimeo.html'
-'vimeo_simple' = 'shortcodes/vimeo_simple.html'
-'x' = 'shortcodes/x.html'
-'x_simple' = 'shortcodes/x_simple.html'
-'youtube' = 'shortcodes/youtube.html'
+'details' = '_shortcodes/details.html'
+'figure' = '_shortcodes/figure.html'
+'gist' = '_shortcodes/gist.html'
+'highlight' = '_shortcodes/highlight.html'
+'instagram' = '_shortcodes/instagram.html'
+'param' = '_shortcodes/param.html'
+'qr' = '_shortcodes/qr.html'
+'ref' = '_shortcodes/ref.html'
+'relref' = '_shortcodes/relref.html'
+'vimeo' = '_shortcodes/vimeo.html'
+'vimeo_simple' = '_shortcodes/vimeo_simple.html'
+'x' = '_shortcodes/x.html'
+'x_simple' = '_shortcodes/x_simple.html'
+'youtube' = '_shortcodes/youtube.html'
+
+# Other
+'alias' = 'alias.html'
+'robots' = 'robots.txt'
+'rss' = 'rss.xml'
+'sitemap' = 'sitemap.xml'
+'sitemapindex' = 'sitemapindex.xml'
diff --git a/docs/layouts/_default/_markup/render-blockquote.html b/docs/layouts/_markup/render-blockquote.html
similarity index 100%
rename from docs/layouts/_default/_markup/render-blockquote.html
rename to docs/layouts/_markup/render-blockquote.html
diff --git a/docs/layouts/_default/_markup/render-codeblock.html b/docs/layouts/_markup/render-codeblock.html
similarity index 100%
rename from docs/layouts/_default/_markup/render-codeblock.html
rename to docs/layouts/_markup/render-codeblock.html
diff --git a/docs/layouts/_default/_markup/render-link.html b/docs/layouts/_markup/render-link.html
similarity index 98%
rename from docs/layouts/_default/_markup/render-link.html
rename to docs/layouts/_markup/render-link.html
index 88e3cbee5..70011220e 100644
--- a/docs/layouts/_default/_markup/render-link.html
+++ b/docs/layouts/_markup/render-link.html
@@ -196,7 +196,7 @@ either of these shortcodes in conjunction with this render hook.
>{{ .Text }}
-{{- define "partials/inline/h-rh-l/validate-fragment.html" }}
+{{- define "_partials/inline/h-rh-l/validate-fragment.html" }}
{{- /*
Validates the fragment portion of a link destination.
@@ -248,7 +248,7 @@ either of these shortcodes in conjunction with this render hook.
{{- end }}
{{- end }}
-{{- define "partials/inline/h-rh-l/get-glossary-link-attributes.html" }}
+{{- define "_partials/inline/h-rh-l/get-glossary-link-attributes.html" }}
{{- /*
Returns the anchor element attributes for a link to the given glossary term.
diff --git a/docs/layouts/_default/_markup/render-passthrough.html b/docs/layouts/_markup/render-passthrough.html
similarity index 100%
rename from docs/layouts/_default/_markup/render-passthrough.html
rename to docs/layouts/_markup/render-passthrough.html
diff --git a/docs/layouts/_default/_markup/render-table.html b/docs/layouts/_markup/render-table.html
similarity index 100%
rename from docs/layouts/_default/_markup/render-table.html
rename to docs/layouts/_markup/render-table.html
diff --git a/docs/layouts/partials/docs/functions-aliases.html b/docs/layouts/_partials/docs/functions-aliases.html
similarity index 100%
rename from docs/layouts/partials/docs/functions-aliases.html
rename to docs/layouts/_partials/docs/functions-aliases.html
diff --git a/docs/layouts/partials/docs/functions-return-type.html b/docs/layouts/_partials/docs/functions-return-type.html
similarity index 100%
rename from docs/layouts/partials/docs/functions-return-type.html
rename to docs/layouts/_partials/docs/functions-return-type.html
diff --git a/docs/layouts/partials/docs/functions-signatures.html b/docs/layouts/_partials/docs/functions-signatures.html
similarity index 100%
rename from docs/layouts/partials/docs/functions-signatures.html
rename to docs/layouts/_partials/docs/functions-signatures.html
diff --git a/docs/layouts/partials/helpers/debug/list-item-metadata.html b/docs/layouts/_partials/helpers/debug/list-item-metadata.html
similarity index 100%
rename from docs/layouts/partials/helpers/debug/list-item-metadata.html
rename to docs/layouts/_partials/helpers/debug/list-item-metadata.html
diff --git a/docs/layouts/partials/helpers/funcs/color-from-string.html b/docs/layouts/_partials/helpers/funcs/color-from-string.html
similarity index 100%
rename from docs/layouts/partials/helpers/funcs/color-from-string.html
rename to docs/layouts/_partials/helpers/funcs/color-from-string.html
diff --git a/docs/layouts/partials/helpers/funcs/get-github-info.html b/docs/layouts/_partials/helpers/funcs/get-github-info.html
similarity index 100%
rename from docs/layouts/partials/helpers/funcs/get-github-info.html
rename to docs/layouts/_partials/helpers/funcs/get-github-info.html
diff --git a/docs/layouts/partials/helpers/funcs/get-remote-data.html b/docs/layouts/_partials/helpers/funcs/get-remote-data.html
similarity index 100%
rename from docs/layouts/partials/helpers/funcs/get-remote-data.html
rename to docs/layouts/_partials/helpers/funcs/get-remote-data.html
diff --git a/docs/layouts/partials/helpers/gtag.html b/docs/layouts/_partials/helpers/gtag.html
similarity index 100%
rename from docs/layouts/partials/helpers/gtag.html
rename to docs/layouts/_partials/helpers/gtag.html
diff --git a/docs/layouts/partials/helpers/linkcss.html b/docs/layouts/_partials/helpers/linkcss.html
similarity index 100%
rename from docs/layouts/partials/helpers/linkcss.html
rename to docs/layouts/_partials/helpers/linkcss.html
diff --git a/docs/layouts/partials/helpers/linkjs.html b/docs/layouts/_partials/helpers/linkjs.html
similarity index 100%
rename from docs/layouts/partials/helpers/linkjs.html
rename to docs/layouts/_partials/helpers/linkjs.html
diff --git a/docs/layouts/partials/helpers/picture.html b/docs/layouts/_partials/helpers/picture.html
similarity index 92%
rename from docs/layouts/partials/helpers/picture.html
rename to docs/layouts/_partials/helpers/picture.html
index 454dd705e..4dc16c002 100644
--- a/docs/layouts/partials/helpers/picture.html
+++ b/docs/layouts/_partials/helpers/picture.html
@@ -5,6 +5,7 @@
{{ $image1x := $image.Resize (printf "%dx" $width1x) }}
{{ $image1xWebp := $image.Resize (printf "%dx webp" $width1x) }}
{{ $class := .class | default "h-64 tablet:h-96 lg:h-full w-full object-cover lg:absolute" }}
+{{ $loading := .loading | default "eager" }}
diff --git a/docs/layouts/partials/helpers/validation/validate-keywords.html b/docs/layouts/_partials/helpers/validation/validate-keywords.html
similarity index 100%
rename from docs/layouts/partials/helpers/validation/validate-keywords.html
rename to docs/layouts/_partials/helpers/validation/validate-keywords.html
diff --git a/docs/layouts/partials/layouts/blocks/alert.html b/docs/layouts/_partials/layouts/blocks/alert.html
similarity index 100%
rename from docs/layouts/partials/layouts/blocks/alert.html
rename to docs/layouts/_partials/layouts/blocks/alert.html
diff --git a/docs/layouts/partials/layouts/blocks/modal.html b/docs/layouts/_partials/layouts/blocks/modal.html
similarity index 100%
rename from docs/layouts/partials/layouts/blocks/modal.html
rename to docs/layouts/_partials/layouts/blocks/modal.html
diff --git a/docs/layouts/partials/layouts/breadcrumbs.html b/docs/layouts/_partials/layouts/breadcrumbs.html
similarity index 100%
rename from docs/layouts/partials/layouts/breadcrumbs.html
rename to docs/layouts/_partials/layouts/breadcrumbs.html
diff --git a/docs/layouts/partials/layouts/date.html b/docs/layouts/_partials/layouts/date.html
similarity index 100%
rename from docs/layouts/partials/layouts/date.html
rename to docs/layouts/_partials/layouts/date.html
diff --git a/docs/layouts/partials/layouts/docsheader.html b/docs/layouts/_partials/layouts/docsheader.html
similarity index 100%
rename from docs/layouts/partials/layouts/docsheader.html
rename to docs/layouts/_partials/layouts/docsheader.html
diff --git a/docs/layouts/partials/layouts/explorer.html b/docs/layouts/_partials/layouts/explorer.html
similarity index 100%
rename from docs/layouts/partials/layouts/explorer.html
rename to docs/layouts/_partials/layouts/explorer.html
diff --git a/docs/layouts/partials/layouts/footer.html b/docs/layouts/_partials/layouts/footer.html
similarity index 100%
rename from docs/layouts/partials/layouts/footer.html
rename to docs/layouts/_partials/layouts/footer.html
diff --git a/docs/layouts/partials/layouts/head/head-js.html b/docs/layouts/_partials/layouts/head/head-js.html
similarity index 100%
rename from docs/layouts/partials/layouts/head/head-js.html
rename to docs/layouts/_partials/layouts/head/head-js.html
diff --git a/docs/layouts/partials/layouts/head/head.html b/docs/layouts/_partials/layouts/head/head.html
similarity index 100%
rename from docs/layouts/partials/layouts/head/head.html
rename to docs/layouts/_partials/layouts/head/head.html
diff --git a/docs/layouts/partials/layouts/header/githubstars.html b/docs/layouts/_partials/layouts/header/githubstars.html
similarity index 100%
rename from docs/layouts/partials/layouts/header/githubstars.html
rename to docs/layouts/_partials/layouts/header/githubstars.html
diff --git a/docs/layouts/partials/layouts/header/header.html b/docs/layouts/_partials/layouts/header/header.html
similarity index 100%
rename from docs/layouts/partials/layouts/header/header.html
rename to docs/layouts/_partials/layouts/header/header.html
diff --git a/docs/layouts/partials/layouts/header/qr.html b/docs/layouts/_partials/layouts/header/qr.html
similarity index 96%
rename from docs/layouts/partials/layouts/header/qr.html
rename to docs/layouts/_partials/layouts/header/qr.html
index ccc0ee959..fea64f625 100644
--- a/docs/layouts/partials/layouts/header/qr.html
+++ b/docs/layouts/_partials/layouts/header/qr.html
@@ -10,7 +10,7 @@
{{ partial "layouts/blocks/modal.html" (dict "modal_button" $qr "modal_content" $qrBig "modal_title" (printf "QR code linking to %s" $.Permalink )) }}
-{{ define "partials/_inline/qr" }}
+{{ define "_partials/_inline/qr" }}
{{ $img_class := .img_class | default "w-10" }}
{{ with images.QR $.page.Permalink (dict "targetDir" "images/qr") }}
diff --git a/docs/layouts/partials/layouts/header/theme.html b/docs/layouts/_partials/layouts/header/theme.html
similarity index 100%
rename from docs/layouts/partials/layouts/header/theme.html
rename to docs/layouts/_partials/layouts/header/theme.html
diff --git a/docs/layouts/partials/layouts/home/features.html b/docs/layouts/_partials/layouts/home/features.html
similarity index 100%
rename from docs/layouts/partials/layouts/home/features.html
rename to docs/layouts/_partials/layouts/home/features.html
diff --git a/docs/layouts/partials/layouts/home/opensource.html b/docs/layouts/_partials/layouts/home/opensource.html
similarity index 100%
rename from docs/layouts/partials/layouts/home/opensource.html
rename to docs/layouts/_partials/layouts/home/opensource.html
diff --git a/docs/layouts/partials/layouts/home/sponsors.html b/docs/layouts/_partials/layouts/home/sponsors.html
similarity index 100%
rename from docs/layouts/partials/layouts/home/sponsors.html
rename to docs/layouts/_partials/layouts/home/sponsors.html
diff --git a/docs/layouts/partials/layouts/hooks/body-end.html b/docs/layouts/_partials/layouts/hooks/body-end.html
similarity index 100%
rename from docs/layouts/partials/layouts/hooks/body-end.html
rename to docs/layouts/_partials/layouts/hooks/body-end.html
diff --git a/docs/layouts/partials/layouts/hooks/body-main-start.html b/docs/layouts/_partials/layouts/hooks/body-main-start.html
similarity index 100%
rename from docs/layouts/partials/layouts/hooks/body-main-start.html
rename to docs/layouts/_partials/layouts/hooks/body-main-start.html
diff --git a/docs/layouts/partials/layouts/hooks/body-start.html b/docs/layouts/_partials/layouts/hooks/body-start.html
similarity index 100%
rename from docs/layouts/partials/layouts/hooks/body-start.html
rename to docs/layouts/_partials/layouts/hooks/body-start.html
diff --git a/docs/layouts/partials/layouts/icons.html b/docs/layouts/_partials/layouts/icons.html
similarity index 100%
rename from docs/layouts/partials/layouts/icons.html
rename to docs/layouts/_partials/layouts/icons.html
diff --git a/docs/layouts/partials/layouts/in-this-section.html b/docs/layouts/_partials/layouts/in-this-section.html
similarity index 100%
rename from docs/layouts/partials/layouts/in-this-section.html
rename to docs/layouts/_partials/layouts/in-this-section.html
diff --git a/docs/layouts/partials/layouts/page-edit.html b/docs/layouts/_partials/layouts/page-edit.html
similarity index 100%
rename from docs/layouts/partials/layouts/page-edit.html
rename to docs/layouts/_partials/layouts/page-edit.html
diff --git a/docs/layouts/partials/layouts/related.html b/docs/layouts/_partials/layouts/related.html
similarity index 100%
rename from docs/layouts/partials/layouts/related.html
rename to docs/layouts/_partials/layouts/related.html
diff --git a/docs/layouts/partials/layouts/search/algolialogo.html b/docs/layouts/_partials/layouts/search/algolialogo.html
similarity index 100%
rename from docs/layouts/partials/layouts/search/algolialogo.html
rename to docs/layouts/_partials/layouts/search/algolialogo.html
diff --git a/docs/layouts/partials/layouts/search/button.html b/docs/layouts/_partials/layouts/search/button.html
similarity index 100%
rename from docs/layouts/partials/layouts/search/button.html
rename to docs/layouts/_partials/layouts/search/button.html
diff --git a/docs/layouts/partials/layouts/search/input.html b/docs/layouts/_partials/layouts/search/input.html
similarity index 100%
rename from docs/layouts/partials/layouts/search/input.html
rename to docs/layouts/_partials/layouts/search/input.html
diff --git a/docs/layouts/partials/layouts/search/results.html b/docs/layouts/_partials/layouts/search/results.html
similarity index 100%
rename from docs/layouts/partials/layouts/search/results.html
rename to docs/layouts/_partials/layouts/search/results.html
diff --git a/docs/layouts/partials/layouts/templates.html b/docs/layouts/_partials/layouts/templates.html
similarity index 100%
rename from docs/layouts/partials/layouts/templates.html
rename to docs/layouts/_partials/layouts/templates.html
diff --git a/docs/layouts/partials/layouts/toc.html b/docs/layouts/_partials/layouts/toc.html
similarity index 100%
rename from docs/layouts/partials/layouts/toc.html
rename to docs/layouts/_partials/layouts/toc.html
diff --git a/docs/layouts/partials/opengraph/get-featured-image.html b/docs/layouts/_partials/opengraph/get-featured-image.html
similarity index 100%
rename from docs/layouts/partials/opengraph/get-featured-image.html
rename to docs/layouts/_partials/opengraph/get-featured-image.html
diff --git a/docs/layouts/partials/opengraph/opengraph.html b/docs/layouts/_partials/opengraph/opengraph.html
similarity index 100%
rename from docs/layouts/partials/opengraph/opengraph.html
rename to docs/layouts/_partials/opengraph/opengraph.html
diff --git a/docs/layouts/shortcodes/chroma-lexers.html b/docs/layouts/_shortcodes/chroma-lexers.html
similarity index 100%
rename from docs/layouts/shortcodes/chroma-lexers.html
rename to docs/layouts/_shortcodes/chroma-lexers.html
diff --git a/docs/layouts/shortcodes/code-toggle.html b/docs/layouts/_shortcodes/code-toggle.html
similarity index 100%
rename from docs/layouts/shortcodes/code-toggle.html
rename to docs/layouts/_shortcodes/code-toggle.html
diff --git a/docs/layouts/shortcodes/datatable-filtered.html b/docs/layouts/_shortcodes/datatable-filtered.html
similarity index 100%
rename from docs/layouts/shortcodes/datatable-filtered.html
rename to docs/layouts/_shortcodes/datatable-filtered.html
diff --git a/docs/layouts/shortcodes/datatable.html b/docs/layouts/_shortcodes/datatable.html
similarity index 100%
rename from docs/layouts/shortcodes/datatable.html
rename to docs/layouts/_shortcodes/datatable.html
diff --git a/docs/layouts/shortcodes/deprecated-in.html b/docs/layouts/_shortcodes/deprecated-in.html
similarity index 100%
rename from docs/layouts/shortcodes/deprecated-in.html
rename to docs/layouts/_shortcodes/deprecated-in.html
diff --git a/docs/layouts/shortcodes/eturl.html b/docs/layouts/_shortcodes/eturl.html
similarity index 100%
rename from docs/layouts/shortcodes/eturl.html
rename to docs/layouts/_shortcodes/eturl.html
diff --git a/docs/layouts/shortcodes/glossary-term.html b/docs/layouts/_shortcodes/glossary-term.html
similarity index 100%
rename from docs/layouts/shortcodes/glossary-term.html
rename to docs/layouts/_shortcodes/glossary-term.html
diff --git a/docs/layouts/shortcodes/glossary.html b/docs/layouts/_shortcodes/glossary.html
similarity index 100%
rename from docs/layouts/shortcodes/glossary.html
rename to docs/layouts/_shortcodes/glossary.html
diff --git a/docs/layouts/shortcodes/hl.html b/docs/layouts/_shortcodes/hl.html
similarity index 100%
rename from docs/layouts/shortcodes/hl.html
rename to docs/layouts/_shortcodes/hl.html
diff --git a/docs/layouts/shortcodes/img.html b/docs/layouts/_shortcodes/img.html
similarity index 99%
rename from docs/layouts/shortcodes/img.html
rename to docs/layouts/_shortcodes/img.html
index 60187802e..e49afc57f 100644
--- a/docs/layouts/shortcodes/img.html
+++ b/docs/layouts/_shortcodes/img.html
@@ -359,7 +359,7 @@ When using the padding filter, provide all arguments in this order:
{{- end }}
{{- end }}
-{{- define "partials/inline/get-resource.html" }}
+{{- define "_partials/inline/get-resource.html" }}
{{- $r := "" }}
{{- $u := urls.Parse .src }}
{{- $msg := "The %q shortcode was unable to resolve %s. See %s" }}
diff --git a/docs/layouts/shortcodes/imgproc.html b/docs/layouts/_shortcodes/imgproc.html
similarity index 100%
rename from docs/layouts/shortcodes/imgproc.html
rename to docs/layouts/_shortcodes/imgproc.html
diff --git a/docs/layouts/shortcodes/include.html b/docs/layouts/_shortcodes/include.html
similarity index 100%
rename from docs/layouts/shortcodes/include.html
rename to docs/layouts/_shortcodes/include.html
diff --git a/docs/layouts/shortcodes/list-pages-in-section.html b/docs/layouts/_shortcodes/list-pages-in-section.html
similarity index 100%
rename from docs/layouts/shortcodes/list-pages-in-section.html
rename to docs/layouts/_shortcodes/list-pages-in-section.html
diff --git a/docs/layouts/shortcodes/module-mounts-note.html b/docs/layouts/_shortcodes/module-mounts-note.html
similarity index 100%
rename from docs/layouts/shortcodes/module-mounts-note.html
rename to docs/layouts/_shortcodes/module-mounts-note.html
diff --git a/docs/layouts/shortcodes/new-in.html b/docs/layouts/_shortcodes/new-in.html
similarity index 100%
rename from docs/layouts/shortcodes/new-in.html
rename to docs/layouts/_shortcodes/new-in.html
diff --git a/docs/layouts/shortcodes/per-lang-config-keys.html b/docs/layouts/_shortcodes/per-lang-config-keys.html
similarity index 97%
rename from docs/layouts/shortcodes/per-lang-config-keys.html
rename to docs/layouts/_shortcodes/per-lang-config-keys.html
index f6090d555..31d7daf6a 100644
--- a/docs/layouts/shortcodes/per-lang-config-keys.html
+++ b/docs/layouts/_shortcodes/per-lang-config-keys.html
@@ -14,8 +14,8 @@ separately for each language.
(dict "contentDir" "/configuration/all/#contentdir")
(dict "copyright" "/configuration/all/#copyright")
(dict "disableAliases" "/configuration/all/#disablealiases")
- (dict "disableHugoGeneratorInject" "/configuration/all/#disableHugogeneratorinject")
- (dict "disableKinds" "/configuration/all/#disableKinds")
+ (dict "disableHugoGeneratorInject" "/configuration/all/#disablehugogeneratorinject")
+ (dict "disableKinds" "/configuration/all/#disablekinds")
(dict "disableLiveReload" "/configuration/all/#disablelivereload")
(dict "disablePathToLower" "/configuration/all/#disablepathtolower")
(dict "enableEmoji " "/configuration/all/#enableemoji")
diff --git a/docs/layouts/shortcodes/quick-reference.html b/docs/layouts/_shortcodes/quick-reference.html
similarity index 100%
rename from docs/layouts/shortcodes/quick-reference.html
rename to docs/layouts/_shortcodes/quick-reference.html
diff --git a/docs/layouts/shortcodes/root-configuration-keys.html b/docs/layouts/_shortcodes/root-configuration-keys.html
similarity index 100%
rename from docs/layouts/shortcodes/root-configuration-keys.html
rename to docs/layouts/_shortcodes/root-configuration-keys.html
diff --git a/docs/layouts/shortcodes/syntax-highlighting-styles.html b/docs/layouts/_shortcodes/syntax-highlighting-styles.html
similarity index 100%
rename from docs/layouts/shortcodes/syntax-highlighting-styles.html
rename to docs/layouts/_shortcodes/syntax-highlighting-styles.html
diff --git a/docs/layouts/_default/baseof.html b/docs/layouts/baseof.html
similarity index 98%
rename from docs/layouts/_default/baseof.html
rename to docs/layouts/baseof.html
index 1f4952146..4c14a6b6d 100644
--- a/docs/layouts/_default/baseof.html
+++ b/docs/layouts/baseof.html
@@ -44,6 +44,8 @@
{{ block "header" . }}
{{ partial "layouts/header/header.html" . }}
{{ end }}
+ {{ block "subheader" . }}
+ {{ end }}
{{ block "hero" . }}
{{ end }}