// Copyright 2019 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 goldmark import ( "bytes" "strings" "github.com/gohugoio/hugo/common/types/hstring" "github.com/gohugoio/hugo/markup/converter/hooks" "github.com/gohugoio/hugo/markup/goldmark/goldmark_config" "github.com/gohugoio/hugo/markup/goldmark/internal/render" "github.com/gohugoio/hugo/markup/internal/attributes" "github.com/yuin/goldmark" "github.com/yuin/goldmark/ast" "github.com/yuin/goldmark/renderer" "github.com/yuin/goldmark/renderer/html" "github.com/yuin/goldmark/util" ) var _ renderer.SetOptioner = (*hookedRenderer)(nil) func newLinkRenderer(cfg goldmark_config.Config) renderer.NodeRenderer { r := &hookedRenderer{ linkifyProtocol: []byte(cfg.Extensions.LinkifyProtocol), Config: html.Config{ Writer: html.DefaultWriter, }, } return r } func newLinks(cfg goldmark_config.Config) goldmark.Extender { return &links{cfg: cfg} } type linkContext struct { page interface{} destination string title string text hstring.RenderedString plainText string } func (ctx linkContext) Destination() string { return ctx.destination } func (ctx linkContext) Resolved() bool { return false } func (ctx linkContext) Page() interface{} { return ctx.page } func (ctx linkContext) Text() hstring.RenderedString { return ctx.text } func (ctx linkContext) PlainText() string { return ctx.plainText } func (ctx linkContext) Title() string { return ctx.title } type headingContext struct { page interface{} level int anchor string text hstring.RenderedString plainText string *attributes.AttributesHolder } func (ctx headingContext) Page() interface{} { return ctx.page } func (ctx headingContext) Level() int { return ctx.level } func (ctx headingContext) Anchor() string { return ctx.anchor } func (ctx headingContext) Text() hstring.RenderedString { return ctx.text } func (ctx headingContext) PlainText() string { return ctx.plainText } type hookedRenderer struct { linkifyProtocol []byte html.Config } func (r *hookedRenderer) SetOption(name renderer.OptionName, value interface{}) { r.Config.SetOption(name, value) } // RegisterFuncs implements NodeRenderer.RegisterFuncs. func (r *hookedRenderer) RegisterFuncs(reg renderer.NodeRendererFuncRegisterer) { reg.Register(ast.KindLink, r.renderLink) reg.Register(ast.KindAutoLink, r.renderAutoLink) reg.Register(ast.KindImage, r.renderImage) reg.Register(ast.KindHeading, r.renderHeading) } func (r *hookedRenderer) renderImage(w util.BufWriter, source []byte, node ast.Node, entering bool) (ast.WalkStatus, error) { n := node.(*ast.Image) var lr hooks.LinkRenderer ctx, ok := w.(*render.Context) if ok { h := ctx.RenderContext().GetRenderer(hooks.ImageRendererType, nil) ok = h != nil if ok { lr = h.(hooks.LinkRenderer) } } if !ok { return r.renderImageDefault(w, source, node, entering) } if entering { // Store the current pos so we can capture the rendered text. ctx.PushPos(ctx.Buffer.Len()) return ast.WalkContinue, nil } pos := ctx.PopPos() text := ctx.Buffer.Bytes()[pos:] ctx.Buffer.Truncate(pos) err := lr.RenderLink( w, linkContext{ page: ctx.DocumentContext().Document, destination: string(n.Destination), title: string(n.Title), text: hstring.RenderedString(text), plainText: string(n.Text(source)), }, ) ctx.AddIdentity(lr) return ast.WalkContinue, err } // Fall back to the default Goldmark render funcs. Method below borrowed from: // https://github.com/yuin/goldmark/blob/b611cd333a492416b56aa8d94b04a67bf0096ab2/renderer/html/html.go#L404 func (r *hookedRenderer) renderImageDefault(w util.BufWriter, source []byte, node ast.Node, entering bool) (ast.WalkStatus, error) { if !entering { return ast.WalkContinue, nil } n := node.(*ast.Image) _, _ = w.WriteString("`)
	_, _ = w.Write(util.EscapeHTML(n.Text(source)))
	_ = w.WriteByte('") } else { _, _ = w.WriteString(">") } return ast.WalkSkipChildren, nil } func (r *hookedRenderer) renderLink(w util.BufWriter, source []byte, node ast.Node, entering bool) (ast.WalkStatus, error) { n := node.(*ast.Link) var lr hooks.LinkRenderer ctx, ok := w.(*render.Context) if ok { h := ctx.RenderContext().GetRenderer(hooks.LinkRendererType, nil) ok = h != nil if ok { lr = h.(hooks.LinkRenderer) } } if !ok { return r.renderLinkDefault(w, source, node, entering) } if entering { // Store the current pos so we can capture the rendered text. ctx.PushPos(ctx.Buffer.Len()) return ast.WalkContinue, nil } pos := ctx.PopPos() text := ctx.Buffer.Bytes()[pos:] ctx.Buffer.Truncate(pos) err := lr.RenderLink( w, linkContext{ page: ctx.DocumentContext().Document, destination: string(n.Destination), title: string(n.Title), text: hstring.RenderedString(text), plainText: string(n.Text(source)), }, ) // TODO(bep) I have a working branch that fixes these rather confusing identity types, // but for now it's important that it's not .GetIdentity() that's added here, // to make sure we search the entire chain on changes. ctx.AddIdentity(lr) return ast.WalkContinue, err } // Fall back to the default Goldmark render funcs. Method below borrowed from: // https://github.com/yuin/goldmark/blob/b611cd333a492416b56aa8d94b04a67bf0096ab2/renderer/html/html.go#L404 func (r *hookedRenderer) renderLinkDefault(w util.BufWriter, source []byte, node ast.Node, entering bool) (ast.WalkStatus, error) { n := node.(*ast.Link) if entering { _, _ = w.WriteString("') } else { _, _ = w.WriteString("") } return ast.WalkContinue, nil } func (r *hookedRenderer) renderAutoLink(w util.BufWriter, source []byte, node ast.Node, entering bool) (ast.WalkStatus, error) { if !entering { return ast.WalkContinue, nil } n := node.(*ast.AutoLink) var lr hooks.LinkRenderer ctx, ok := w.(*render.Context) if ok { h := ctx.RenderContext().GetRenderer(hooks.LinkRendererType, nil) ok = h != nil if ok { lr = h.(hooks.LinkRenderer) } } if !ok { return r.renderAutoLinkDefault(w, source, node, entering) } url := string(r.autoLinkURL(n, source)) label := string(n.Label(source)) if n.AutoLinkType == ast.AutoLinkEmail && !strings.HasPrefix(strings.ToLower(url), "mailto:") { url = "mailto:" + url } err := lr.RenderLink( w, linkContext{ page: ctx.DocumentContext().Document, destination: url, text: hstring.RenderedString(label), plainText: label, }, ) // TODO(bep) I have a working branch that fixes these rather confusing identity types, // but for now it's important that it's not .GetIdentity() that's added here, // to make sure we search the entire chain on changes. ctx.AddIdentity(lr) return ast.WalkContinue, err } // Fall back to the default Goldmark render funcs. Method below borrowed from: // https://github.com/yuin/goldmark/blob/5588d92a56fe1642791cf4aa8e9eae8227cfeecd/renderer/html/html.go#L439 func (r *hookedRenderer) renderAutoLinkDefault(w util.BufWriter, source []byte, node ast.Node, entering bool) (ast.WalkStatus, error) { n := node.(*ast.AutoLink) if !entering { return ast.WalkContinue, nil } _, _ = w.WriteString(`') } else { _, _ = w.WriteString(`">`) } _, _ = w.Write(util.EscapeHTML(label)) _, _ = w.WriteString(``) return ast.WalkContinue, nil } func (r *hookedRenderer) autoLinkURL(n *ast.AutoLink, source []byte) []byte { url := n.URL(source) if len(n.Protocol) > 0 && !bytes.Equal(n.Protocol, r.linkifyProtocol) { // The CommonMark spec says "http" is the correct protocol for links, // but this doesn't make much sense (the fact that they should care about the rendered output). // Note that n.Protocol is not set if protocol is provided by user. url = append(r.linkifyProtocol, url[len(n.Protocol):]...) } return url } func (r *hookedRenderer) renderHeading(w util.BufWriter, source []byte, node ast.Node, entering bool) (ast.WalkStatus, error) { n := node.(*ast.Heading) var hr hooks.HeadingRenderer ctx, ok := w.(*render.Context) if ok { h := ctx.RenderContext().GetRenderer(hooks.HeadingRendererType, nil) ok = h != nil if ok { hr = h.(hooks.HeadingRenderer) } } if !ok { return r.renderHeadingDefault(w, source, node, entering) } if entering { // Store the current pos so we can capture the rendered text. ctx.PushPos(ctx.Buffer.Len()) return ast.WalkContinue, nil } pos := ctx.PopPos() text := ctx.Buffer.Bytes()[pos:] ctx.Buffer.Truncate(pos) // All ast.Heading nodes are guaranteed to have an attribute called "id" // that is an array of bytes that encode a valid string. anchori, _ := n.AttributeString("id") anchor := anchori.([]byte) err := hr.RenderHeading( w, headingContext{ page: ctx.DocumentContext().Document, level: n.Level, anchor: string(anchor), text: hstring.RenderedString(text), plainText: string(n.Text(source)), AttributesHolder: attributes.New(n.Attributes(), attributes.AttributesOwnerGeneral), }, ) ctx.AddIdentity(hr) return ast.WalkContinue, err } func (r *hookedRenderer) renderHeadingDefault(w util.BufWriter, source []byte, node ast.Node, entering bool) (ast.WalkStatus, error) { n := node.(*ast.Heading) if entering { _, _ = w.WriteString("') } else { _, _ = w.WriteString("\n") } return ast.WalkContinue, nil } type links struct { cfg goldmark_config.Config } // Extend implements goldmark.Extender. func (e *links) Extend(m goldmark.Markdown) { m.Renderer().AddOptions(renderer.WithNodeRenderers( util.Prioritized(newLinkRenderer(e.cfg), 100), )) }