Skip to content

Commit

Permalink
Preserve HTML Text for link render hooks
Browse files Browse the repository at this point in the history
The context now have two text methods:

* Text - rendered
* PlainText

Fixes gohugoio#6629
  • Loading branch information
bep committed Dec 18, 2019
1 parent 1b785a7 commit f0b612d
Show file tree
Hide file tree
Showing 5 changed files with 79 additions and 12 deletions.
5 changes: 4 additions & 1 deletion docs/content/en/getting-started/configuration-markup.md
Original file line number Diff line number Diff line change
Expand Up @@ -117,7 +117,10 @@ Title
: The title attribute.

Text
: The link text.
: The rendered (HTML) link text.

PlainText
: The plain variant of the above.

A Markdown example for a inline-style link with title:

Expand Down
31 changes: 31 additions & 0 deletions hugolib/content_render_hooks_test.go
Original file line number Diff line number Diff line change
Expand Up @@ -213,6 +213,37 @@ P3: <p>P3. xml-link: https://www.example.org|</p>

}

// https://github.com/gohugoio/hugo/issues/6629
func TestRenderLinkWithMarkupInText(t *testing.T) {

b := newTestSitesBuilder(t)

b.WithTemplates("index.html", `
{{ $p := site.GetPage "p1.md" }}
P1: {{ $p.Content }}
`,
"_default/_markup/render-link.html", `html-link: {{ .Destination | safeURL }}|Text: {{ .Text | safeHTML }}|Plain: {{ .PlainText | safeHTML }}`,
)

b.WithContent("p1.md", `---
title: "p1"
---
START: [**should be bold**](https://gohugo.io)END
Some regular **markup**.
`)

b.Build(BuildCfg{})

b.AssertFileContent("public/index.html", `
P1: <p>START: html-link: https://gohugo.io|Text: <strong>should be bold</strong>|Plain: should be boldEND</p>
<p>Some regular <strong>markup</strong>.</p>
`)

}

func TestRenderString(t *testing.T) {

b := newTestSitesBuilder(t)
Expand Down
1 change: 1 addition & 0 deletions markup/converter/hooks/hooks.go
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,7 @@ type LinkContext interface {
Destination() string
Title() string
Text() string
PlainText() string
}

type Render struct {
Expand Down
29 changes: 24 additions & 5 deletions markup/goldmark/convert.go
Original file line number Diff line number Diff line change
Expand Up @@ -15,9 +15,9 @@
package goldmark

import (
"bufio"
"bytes"
"fmt"
"math/bits"
"path/filepath"
"runtime/debug"

Expand Down Expand Up @@ -162,8 +162,27 @@ func (c converterResult) GetIdentities() identity.Identities {
return c.ids
}

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 renderContext struct {
util.BufWriter
*bufWriter
pos int
renderContextData
}

Expand Down Expand Up @@ -205,7 +224,7 @@ func (c *goldmarkConverter) Convert(ctx converter.RenderContext) (result convert
}
}()

buf := &bytes.Buffer{}
buf := &bufWriter{Buffer: &bytes.Buffer{}}
result = buf
pctx := newParserContext(ctx)
reader := text.NewReader(ctx.Src)
Expand All @@ -221,8 +240,8 @@ func (c *goldmarkConverter) Convert(ctx converter.RenderContext) (result convert
ids: identity.NewManager(converterIdentity),
}

w := renderContext{
BufWriter: bufio.NewWriter(buf),
w := &renderContext{
bufWriter: buf,
renderContextData: rcx,
}

Expand Down
25 changes: 19 additions & 6 deletions markup/goldmark/render_link.go
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,7 @@ type linkContext struct {
destination string
title string
text string
plainText string
}

func (ctx linkContext) Destination() string {
Expand All @@ -61,6 +62,10 @@ func (ctx linkContext) Text() string {
return ctx.text
}

func (ctx linkContext) PlainText() string {
return ctx.plainText
}

func (ctx linkContext) Title() string {
return ctx.title
}
Expand Down Expand Up @@ -146,13 +151,16 @@ func (r *linkRenderer) renderImage(w util.BufWriter, source []byte, node ast.Nod
return ast.WalkContinue, nil
}

text := string(n.Text(source))

err := h.ImageRenderer.Render(
w,
linkContext{
page: ctx.DocumentContext().Document,
destination: string(n.Destination),
title: string(n.Title),
text: string(n.Text(source)),
text: text,
plainText: text,
},
)

Expand All @@ -166,7 +174,7 @@ func (r *linkRenderer) renderLink(w util.BufWriter, source []byte, node ast.Node
n := node.(*ast.Link)
var h *hooks.Render

ctx, ok := w.(renderContextData)
ctx, ok := w.(*renderContext)
if ok {
h = ctx.RenderContext().RenderHooks
ok = h != nil && h.LinkRenderer != nil
Expand All @@ -176,24 +184,29 @@ func (r *linkRenderer) renderLink(w util.BufWriter, source []byte, node ast.Node
return r.renderDefaultLink(w, source, node, entering)
}

if !entering {
if entering {
// Store the current pos so we can capture the rendered text.
ctx.pos = ctx.Buffer.Len()
return ast.WalkContinue, nil
}

text := ctx.Buffer.Bytes()[ctx.pos:]
ctx.Buffer.Truncate(ctx.pos)

err := h.LinkRenderer.Render(
w,
linkContext{
page: ctx.DocumentContext().Document,
destination: string(n.Destination),
title: string(n.Title),
text: string(n.Text(source)),
text: string(text),
plainText: string(n.Text(source)),
},
)

ctx.AddIdentity(h.LinkRenderer.GetIdentity())

// Do not render the inner text.
return ast.WalkSkipChildren, err
return ast.WalkContinue, err

}

Expand Down

0 comments on commit f0b612d

Please sign in to comment.