diff options
author | Bjørn Erik Pedersen <bjorn.erik.pedersen@gmail.com> | 2019-08-16 15:55:03 +0200 |
---|---|---|
committer | Bjørn Erik Pedersen <bjorn.erik.pedersen@gmail.com> | 2019-11-06 19:09:08 +0100 |
commit | 5f6b6ec68936ebbbf590894c02a1a3ecad30735f (patch) | |
tree | f6c91e225a3f24f51af1bde5cfb5b88515d0665d /markup/mmark/convert.go | |
parent | 366ee4d8da1c2b0c1751e9bf6d54638439735296 (diff) |
Prepare for Goldmark
This commmit prepares for the addition of Goldmark as the new Markdown renderer in Hugo.
This introduces a new `markup` package with some common interfaces and each implementation in its own package.
See #5963
Diffstat (limited to 'markup/mmark/convert.go')
-rw-r--r-- | markup/mmark/convert.go | 143 |
1 files changed, 143 insertions, 0 deletions
diff --git a/markup/mmark/convert.go b/markup/mmark/convert.go new file mode 100644 index 000000000..a0da346c1 --- /dev/null +++ b/markup/mmark/convert.go @@ -0,0 +1,143 @@ +// 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 mmark converts Markdown to HTML using MMark v1. +package mmark + +import ( + "github.com/gohugoio/hugo/markup/internal" + + "github.com/gohugoio/hugo/markup/converter" + "github.com/miekg/mmark" +) + +// Provider is the package entry point. +var Provider converter.NewProvider = provider{} + +type provider struct { +} + +func (p provider) New(cfg converter.ProviderConfig) (converter.Provider, error) { + defaultBlackFriday, err := internal.NewBlackfriday(cfg) + if err != nil { + return nil, err + } + + defaultExtensions := getMmarkExtensions(defaultBlackFriday) + + var n converter.NewConverter = func(ctx converter.DocumentContext) (converter.Converter, error) { + b := defaultBlackFriday + extensions := defaultExtensions + + if ctx.ConfigOverrides != nil { + var err error + b, err = internal.UpdateBlackFriday(b, ctx.ConfigOverrides) + if err != nil { + return nil, err + } + extensions = getMmarkExtensions(b) + } + + return &mmarkConverter{ + ctx: ctx, + b: b, + extensions: extensions, + cfg: cfg, + }, nil + } + + return n, nil + +} + +type mmarkConverter struct { + ctx converter.DocumentContext + extensions int + b *internal.BlackFriday + cfg converter.ProviderConfig +} + +func (c *mmarkConverter) Convert(ctx converter.RenderContext) (converter.Result, error) { + r := getHTMLRenderer(c.ctx, c.b, c.cfg) + return mmark.Parse(ctx.Src, r, c.extensions), nil +} + +func getHTMLRenderer( + ctx converter.DocumentContext, + cfg *internal.BlackFriday, + pcfg converter.ProviderConfig) mmark.Renderer { + + var ( + flags int + documentID string + ) + + documentID = ctx.DocumentID + + renderParameters := mmark.HtmlRendererParameters{ + FootnoteAnchorPrefix: cfg.FootnoteAnchorPrefix, + FootnoteReturnLinkContents: cfg.FootnoteReturnLinkContents, + } + + if documentID != "" && !cfg.PlainIDAnchors { + renderParameters.FootnoteAnchorPrefix = documentID + ":" + renderParameters.FootnoteAnchorPrefix + } + + htmlFlags := flags + htmlFlags |= mmark.HTML_FOOTNOTE_RETURN_LINKS + + return &mmarkRenderer{ + Config: cfg, + Cfg: pcfg.Cfg, + highlight: pcfg.Highlight, + Renderer: mmark.HtmlRendererWithParameters(htmlFlags, "", "", renderParameters), + } + +} + +func getMmarkExtensions(cfg *internal.BlackFriday) int { + flags := 0 + flags |= mmark.EXTENSION_TABLES + flags |= mmark.EXTENSION_FENCED_CODE + flags |= mmark.EXTENSION_AUTOLINK + flags |= mmark.EXTENSION_SPACE_HEADERS + flags |= mmark.EXTENSION_CITATION + flags |= mmark.EXTENSION_TITLEBLOCK_TOML + flags |= mmark.EXTENSION_HEADER_IDS + flags |= mmark.EXTENSION_AUTO_HEADER_IDS + flags |= mmark.EXTENSION_UNIQUE_HEADER_IDS + flags |= mmark.EXTENSION_FOOTNOTES + flags |= mmark.EXTENSION_SHORT_REF + flags |= mmark.EXTENSION_NO_EMPTY_LINE_BEFORE_BLOCK + flags |= mmark.EXTENSION_INCLUDE + + for _, extension := range cfg.Extensions { + if flag, ok := mmarkExtensionMap[extension]; ok { + flags |= flag + } + } + return flags +} + +var mmarkExtensionMap = map[string]int{ + "tables": mmark.EXTENSION_TABLES, + "fencedCode": mmark.EXTENSION_FENCED_CODE, + "autolink": mmark.EXTENSION_AUTOLINK, + "laxHtmlBlocks": mmark.EXTENSION_LAX_HTML_BLOCKS, + "spaceHeaders": mmark.EXTENSION_SPACE_HEADERS, + "hardLineBreak": mmark.EXTENSION_HARD_LINE_BREAK, + "footnotes": mmark.EXTENSION_FOOTNOTES, + "noEmptyLineBeforeBlock": mmark.EXTENSION_NO_EMPTY_LINE_BEFORE_BLOCK, + "headerIds": mmark.EXTENSION_HEADER_IDS, + "autoHeaderIds": mmark.EXTENSION_AUTO_HEADER_IDS, +} |