mirror of
https://github.com/gohugoio/hugo.git
synced 2024-12-01 14:08:48 -05:00
df11327ba9
The main use case for this is to resolve links and resources (e.g. images) relative to the included `Page`.
A typical `include` would similar to this:
```handlebars
{{ with site.GetPage (.Get 0) }}
{{ .RenderShortcodes }}
{{ end }}
```
And when used in a Markdown file:
```markdown
{{% include "/posts/p1" %}}
```
Any render hook triggered while rendering `/posts/p1` will get `/posts/p1` when calling `.PageInner`.
Note that
* This is only relevant for shortcodes included with `{{%` that calls `.RenderShortcodes`.
* `.PageInner` is available in all render hooks that, before this commit, received `.Page`.
* `.PageInner` will fall back to the value of `.Page` if not relevant and will always have a value.
Fixes #12356
99 lines
2.1 KiB
Go
99 lines
2.1 KiB
Go
// Copyright 2024 The Hugo Authors. All rights reserved.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
package render
|
|
|
|
import (
|
|
"bytes"
|
|
"math/bits"
|
|
|
|
"github.com/gohugoio/hugo/markup/converter"
|
|
)
|
|
|
|
type BufWriter struct {
|
|
*bytes.Buffer
|
|
}
|
|
|
|
const maxInt = 1<<(bits.UintSize-1) - 1
|
|
|
|
func (b *BufWriter) Available() int {
|
|
return maxInt
|
|
}
|
|
|
|
func (b *BufWriter) Buffered() int {
|
|
return b.Len()
|
|
}
|
|
|
|
func (b *BufWriter) Flush() error {
|
|
return nil
|
|
}
|
|
|
|
type Context struct {
|
|
*BufWriter
|
|
positions []int
|
|
pids []uint64
|
|
ContextData
|
|
}
|
|
|
|
func (ctx *Context) PushPos(n int) {
|
|
ctx.positions = append(ctx.positions, n)
|
|
}
|
|
|
|
func (ctx *Context) PopPos() int {
|
|
i := len(ctx.positions) - 1
|
|
p := ctx.positions[i]
|
|
ctx.positions = ctx.positions[:i]
|
|
return p
|
|
}
|
|
|
|
// PushPid pushes a new page ID to the stack.
|
|
func (ctx *Context) PushPid(pid uint64) {
|
|
ctx.pids = append(ctx.pids, pid)
|
|
}
|
|
|
|
// PeekPid returns the current page ID without removing it from the stack.
|
|
func (ctx *Context) PeekPid() uint64 {
|
|
if len(ctx.pids) == 0 {
|
|
return 0
|
|
}
|
|
return ctx.pids[len(ctx.pids)-1]
|
|
}
|
|
|
|
// PopPid pops the last page ID from the stack.
|
|
func (ctx *Context) PopPid() uint64 {
|
|
if len(ctx.pids) == 0 {
|
|
return 0
|
|
}
|
|
i := len(ctx.pids) - 1
|
|
p := ctx.pids[i]
|
|
ctx.pids = ctx.pids[:i]
|
|
return p
|
|
}
|
|
|
|
type ContextData interface {
|
|
RenderContext() converter.RenderContext
|
|
DocumentContext() converter.DocumentContext
|
|
}
|
|
|
|
type RenderContextDataHolder struct {
|
|
Rctx converter.RenderContext
|
|
Dctx converter.DocumentContext
|
|
}
|
|
|
|
func (ctx *RenderContextDataHolder) RenderContext() converter.RenderContext {
|
|
return ctx.Rctx
|
|
}
|
|
|
|
func (ctx *RenderContextDataHolder) DocumentContext() converter.DocumentContext {
|
|
return ctx.Dctx
|
|
}
|