bench-forgejo/modules/markdown/markdown.go

401 lines
12 KiB
Go
Raw Normal View History

2014-04-10 23:50:58 +05:30
// Copyright 2014 The Gogs Authors. All rights reserved.
// Use of this source code is governed by a MIT-style
// license that can be found in the LICENSE file.
2016-02-21 03:40:05 +05:30
package markdown
2014-04-10 23:50:58 +05:30
import (
"bytes"
"fmt"
"io"
2014-04-10 23:50:58 +05:30
"path"
"path/filepath"
"regexp"
"strings"
2015-11-20 16:07:51 +05:30
"github.com/Unknwon/com"
2016-02-21 03:40:05 +05:30
"github.com/microcosm-cc/bluemonday"
2014-10-05 02:45:22 +05:30
"github.com/russross/blackfriday"
"golang.org/x/net/html"
2014-10-05 02:45:22 +05:30
2016-02-21 03:40:05 +05:30
"github.com/gogits/gogs/modules/base"
"github.com/gogits/gogs/modules/setting"
2014-04-10 23:50:58 +05:30
)
const (
ISSUE_NAME_STYLE_NUMERIC = "numeric"
ISSUE_NAME_STYLE_ALPHANUMERIC = "alphanumeric"
)
2016-02-21 03:40:05 +05:30
var Sanitizer = bluemonday.UGCPolicy()
2016-02-21 03:40:05 +05:30
// BuildSanitizer initializes sanitizer with allowed attributes based on settings.
// This function should only be called once during entire application lifecycle.
func BuildSanitizer() {
// Normal markdown-stuff
Sanitizer.AllowAttrs("class").Matching(regexp.MustCompile(`[\p{L}\p{N}\s\-_',:\[\]!\./\\\(\)&]*`)).OnElements("code")
// Checkboxes
Sanitizer.AllowAttrs("type").Matching(regexp.MustCompile(`^checkbox$`)).OnElements("input")
Sanitizer.AllowAttrs("checked", "disabled").OnElements("input")
2014-04-10 23:50:58 +05:30
2016-02-21 03:40:05 +05:30
// Custom URL-Schemes
Sanitizer.AllowURLSchemes(setting.Markdown.CustomURLSchemes...)
2014-04-10 23:50:58 +05:30
}
2016-01-14 11:50:03 +05:30
var validLinksPattern = regexp.MustCompile(`^[a-z][\w-]+://`)
2014-04-10 23:50:58 +05:30
2016-02-21 03:40:05 +05:30
// isLink reports whether link fits valid format.
2014-04-10 23:50:58 +05:30
func isLink(link []byte) bool {
2016-01-14 11:50:03 +05:30
return validLinksPattern.Match(link)
2014-04-10 23:50:58 +05:30
}
2016-02-21 03:40:05 +05:30
// IsMarkdownFile reports whether name looks like a Markdown file
// based on its extension.
2014-04-10 23:50:58 +05:30
func IsMarkdownFile(name string) bool {
Squashed commit of the following: commit 0afcb843d7ffd596991c4885cab768273a6eb42c Author: Richard Mahn <richard_mahn@wycliffeassociates.org> Date: Sun Jul 31 17:13:29 2016 -0600 Removed Upload stats as the upload table is just a temporary table commit 7ecd73ff5535612d79d471409173ee7f1fcfa157 Author: Richard Mahn <richard_mahn@wycliffeassociates.org> Date: Sun Jul 31 08:42:41 2016 -0600 Fix for CodeMirror mode commit c29b9ab531e2e7af0fb5db24dc17e51027dd1174 Author: Richard Mahn <richard_mahn@wycliffeassociates.org> Date: Sun Jul 31 08:03:33 2016 -0600 Made tabbing in editor use spaces commit 23af384c53206a8a40e11e45bf49d7a149c4adcd Author: Richard Mahn <richard_mahn@wycliffeassociates.org> Date: Sun Jul 31 07:56:46 2016 -0600 Fix for data-url commit cfb8a97591cb6fc0a92e49563b7b764c524db0e9 Merge: 7fc8a89 991ce42 Author: Richard Mahn <richard_mahn@wycliffeassociates.org> Date: Sun Jul 31 07:42:53 2016 -0600 Merge remote-tracking branch 'gogits/develop' into feature-create-and-edit-repo-file Conflicts: modules/bindata/bindata.go public/js/gogs.js commit 7fc8a89cb495478225b02d613e647f99a1489634 Merge: fd3d86c c03d040 Author: Richard Mahn <richard_mahn@wycliffeassociates.org> Date: Sun Jul 31 07:40:00 2016 -0600 Merge branch 'feature-create-and-edit-repo-file' of github.com:richmahn/gogs into feature-create-and-edit-repo-file commit fd3d86ca6bbc02cfda566a504ffd6b03db4f75ef Author: Richard Mahn <richard_mahn@wycliffeassociates.org> Date: Sun Jul 31 07:39:44 2016 -0600 Code cleanup commit c03d0401c1049eeeccc32ab1f9c3303c130be5ee Author: Richard Mahn <richard_mahn@wycliffeassociates.org> Date: Fri Jul 29 15:38:23 2016 -0600 Code cleanup commit 98e1206ccf9f9a4503c020e3a7830cf9f861dfae Author: Richard Mahn <richard_mahn@wycliffeassociates.org> Date: Thu Jul 28 18:36:01 2016 -0600 Code cleanup and fixes commit c2895dc742f25f8412879c9fa15e18f27f42f194 Author: Richard Mahn <richard_mahn@wycliffeassociates.org> Date: Thu Jul 28 18:24:04 2016 -0600 Fixes per Unknwon's requests commit 6aa7e46b21ad4c96e562daa2eac26a8fb408f8ef Merge: 889e9fa ad7ea88 Author: Richard Mahn <richard_mahn@wycliffeassociates.org> Date: Thu Jul 28 17:13:43 2016 -0600 Merge remote-tracking branch 'gogits/develop' into feature-create-and-edit-repo-file Conflicts: modules/bindata/bindata.go modules/setting/setting.go commit 889e9faf1bd8559a4979c8f46005d488c1a234d4 Author: Richard Mahn <richard_mahn@wycliffeassociates.org> Date: Fri Jul 22 14:09:18 2016 -0600 Fix in gogs.js commit 47603edf223f147b114be65f3bd27bc1e88827a5 Merge: bb57912 cf85e9e Author: Richard Mahn <richard_mahn@wycliffeassociates.org> Date: Fri Jul 22 14:07:36 2016 -0600 Merge remote-tracking branch 'gogits/develop' into feature-create-and-edit-repo-file Conflicts: modules/bindata/bindata.go public/js/gogs.js commit bb5791255867a71c11a77b639db050ad09c597a4 Author: Richard Mahn <richard_mahn@wycliffeassociates.org> Date: Fri Jul 22 14:02:18 2016 -0600 Update for using CodeMirror mode addon commit d10d128c51039be19e2af9c66c63db66a9f2ec6d Author: Richard Mahn <richard_mahn@wycliffeassociates.org> Date: Tue Jul 19 16:12:57 2016 -0600 Update for Edit commit 34a34982025144e3225e389f7849eb6273c1d576 Merge: fa1b752 1c7dcdd Author: Richard Mahn <richard_mahn@wycliffeassociates.org> Date: Tue Jul 19 11:52:02 2016 -0600 Merge remote-tracking branch 'gogits/develop' into feature-create-and-edit-repo-file Conflicts: modules/bindata/bindata.go commit fa1b752be29cd455c5184ddac2ffe80b3489763e Author: Richard Mahn <richard_mahn@wycliffeassociates.org> Date: Fri Jul 15 18:35:42 2016 -0600 Feature for editing, creating, uploading and deleting files
2016-08-11 18:18:08 +05:30
extension := strings.ToLower(filepath.Ext(name))
for _, ext := range setting.Markdown.MdFileExtensions {
if strings.ToLower(ext) == extension {
return true
}
2014-04-10 23:50:58 +05:30
}
return false
}
2016-02-21 03:40:05 +05:30
// IsReadmeFile reports whether name looks like a README file
// based on its extension.
2014-04-10 23:50:58 +05:30
func IsReadmeFile(name string) bool {
name = strings.ToLower(name)
if len(name) < 6 {
return false
} else if len(name) == 6 {
2016-02-21 03:40:05 +05:30
return name == "readme"
2014-04-10 23:50:58 +05:30
}
2016-02-21 03:40:05 +05:30
return name[:7] == "readme."
2014-04-10 23:50:58 +05:30
}
2016-01-09 08:29:04 +05:30
var (
2016-02-21 03:40:05 +05:30
// MentionPattern matches string that mentions someone, e.g. @Unknwon
MentionPattern = regexp.MustCompile(`(\s|^)@[0-9a-zA-Z-_\.]+`)
2016-02-21 03:40:05 +05:30
// CommitPattern matches link to certain commit with or without trailing hash,
// e.g. https://try.gogs.io/gogs/gogs/commit/d8a994ef243349f321568f9e36d5c3f444b99cae#diff-2
CommitPattern = regexp.MustCompile(`(\s|^)https?.*commit/[0-9a-zA-Z]+(#+[0-9a-zA-Z-]*)?`)
// IssueFullPattern matches link to an issue with or without trailing hash,
// e.g. https://try.gogs.io/gogs/gogs/issues/4#issue-685
IssueFullPattern = regexp.MustCompile(`(\s|^)https?.*issues/[0-9]+(#+[0-9a-zA-Z-]*)?`)
// IssueNumericPattern matches string that references to a numeric issue, e.g. #1287
IssueNumericPattern = regexp.MustCompile(`( |^|\()#[0-9]+\b`)
// IssueAlphanumericPattern matches string that references to an alphanumeric issue, e.g. ABC-1234
IssueAlphanumericPattern = regexp.MustCompile(`( |^|\()[A-Z]{1,10}-[1-9][0-9]*\b`)
2016-02-21 03:40:05 +05:30
// Sha1CurrentPattern matches string that represents a commit SHA, e.g. d8a994ef243349f321568f9e36d5c3f444b99cae
Sha1CurrentPattern = regexp.MustCompile(`\b[0-9a-f]{7,40}\b`)
2016-01-09 08:29:04 +05:30
)
// FindAllMentions matches mention patterns in given content
// and returns a list of found user names without @ prefix.
func FindAllMentions(content string) []string {
mentions := MentionPattern.FindAllString(content, -1)
for i := range mentions {
mentions[i] = strings.TrimSpace(mentions[i])[1:] // Strip @ character
}
return mentions
}
2016-02-21 03:40:05 +05:30
// Renderer is a extended version of underlying render object.
type Renderer struct {
2014-10-05 02:45:22 +05:30
blackfriday.Renderer
2014-04-10 23:50:58 +05:30
urlPrefix string
}
2016-02-21 03:40:05 +05:30
// Link defines how formal links should be processed to produce corresponding HTML elements.
func (r *Renderer) Link(out *bytes.Buffer, link []byte, title []byte, content []byte) {
2014-04-10 23:50:58 +05:30
if len(link) > 0 && !isLink(link) {
2016-02-21 03:40:05 +05:30
if link[0] != '#' {
2016-01-09 08:29:04 +05:30
link = []byte(path.Join(r.urlPrefix, string(link)))
}
}
r.Renderer.Link(out, link, title, content)
}
2016-02-21 03:40:05 +05:30
// AutoLink defines how auto-detected links should be processed to produce corresponding HTML elements.
// Reference for kind: https://github.com/russross/blackfriday/blob/master/markdown.go#L69-L76
func (r *Renderer) AutoLink(out *bytes.Buffer, link []byte, kind int) {
if kind != blackfriday.LINK_TYPE_NORMAL {
2016-01-09 08:29:04 +05:30
r.Renderer.AutoLink(out, link, kind)
return
}
2016-02-21 03:40:05 +05:30
// Since this method could only possibly serve one link at a time,
// we do not need to find all.
if bytes.HasPrefix(link, []byte(setting.AppUrl)) {
m := CommitPattern.Find(link)
if m != nil {
m = bytes.TrimSpace(m)
i := strings.Index(string(m), "commit/")
j := strings.Index(string(m), "#")
if j == -1 {
j = len(m)
}
out.WriteString(fmt.Sprintf(` <code><a href="%s">%s</a></code>`, m, base.ShortSha(string(m[i+7:j]))))
return
2016-01-09 08:29:04 +05:30
}
m = IssueFullPattern.Find(link)
if m != nil {
m = bytes.TrimSpace(m)
i := strings.Index(string(m), "issues/")
j := strings.Index(string(m), "#")
if j == -1 {
j = len(m)
}
out.WriteString(fmt.Sprintf(`<a href="%s">#%s</a>`, m, base.ShortSha(string(m[i+7:j]))))
return
2014-04-10 23:50:58 +05:30
}
}
2016-01-09 08:29:04 +05:30
r.Renderer.AutoLink(out, link, kind)
2014-04-10 23:50:58 +05:30
}
2016-02-21 03:40:05 +05:30
// ListItem defines how list items should be processed to produce corresponding HTML elements.
func (options *Renderer) ListItem(out *bytes.Buffer, text []byte, flags int) {
// Detect procedures to draw checkboxes.
2016-01-13 17:55:52 +05:30
switch {
case bytes.HasPrefix(text, []byte("[ ] ")):
text = append([]byte(`<input type="checkbox" disabled="" />`), text[3:]...)
case bytes.HasPrefix(text, []byte("[x] ")):
text = append([]byte(`<input type="checkbox" disabled="" checked="" />`), text[3:]...)
}
options.Renderer.ListItem(out, text, flags)
}
2016-02-21 03:40:05 +05:30
// Note: this section is for purpose of increase performance and
// reduce memory allocation at runtime since they are constant literals.
2015-11-20 16:07:51 +05:30
var (
svgSuffix = []byte(".svg")
svgSuffixWithMark = []byte(".svg?")
2016-02-05 09:21:40 +05:30
spaceBytes = []byte(" ")
spaceEncodedBytes = []byte("%20")
space = " "
spaceEncoded = "%20"
2015-11-20 16:07:51 +05:30
)
2016-02-21 03:40:05 +05:30
// Image defines how images should be processed to produce corresponding HTML elements.
func (r *Renderer) Image(out *bytes.Buffer, link []byte, title []byte, alt []byte) {
2016-01-09 08:29:04 +05:30
prefix := strings.Replace(r.urlPrefix, "/src/", "/raw/", 1)
2015-11-20 16:07:51 +05:30
if len(link) > 0 {
if isLink(link) {
// External link with .svg suffix usually means CI status.
2016-02-21 03:40:05 +05:30
// TODO: define a keyword to allow non-svg images render as external link.
2015-11-20 16:07:51 +05:30
if bytes.HasSuffix(link, svgSuffix) || bytes.Contains(link, svgSuffixWithMark) {
2016-01-09 08:29:04 +05:30
r.Renderer.Image(out, link, title, alt)
2015-11-20 16:07:51 +05:30
return
}
} else {
if link[0] != '/' {
prefix += "/"
}
2016-02-05 09:21:40 +05:30
link = bytes.Replace([]byte((prefix + string(link))), spaceBytes, spaceEncodedBytes, -1)
fmt.Println(333, string(link))
}
2014-10-15 09:14:34 +05:30
}
out.WriteString(`<a href="`)
out.Write(link)
out.WriteString(`">`)
2016-01-09 08:29:04 +05:30
r.Renderer.Image(out, link, title, alt)
out.WriteString("</a>")
2014-10-15 09:14:34 +05:30
}
2016-02-21 03:40:05 +05:30
// cutoutVerbosePrefix cutouts URL prefix including sub-path to
// return a clean unified string of request URL path.
2015-11-16 04:07:26 +05:30
func cutoutVerbosePrefix(prefix string) string {
if len(prefix) == 0 || prefix[0] != '/' {
return prefix
}
2015-11-16 04:07:26 +05:30
count := 0
for i := 0; i < len(prefix); i++ {
if prefix[i] == '/' {
count++
}
if count >= 3+setting.AppSubUrlDepth {
2015-11-16 04:07:26 +05:30
return prefix[:i]
}
}
2015-11-16 04:07:26 +05:30
return prefix
}
2016-02-21 03:40:05 +05:30
// RenderIssueIndexPattern renders issue indexes to corresponding links.
2015-12-05 08:00:33 +05:30
func RenderIssueIndexPattern(rawBytes []byte, urlPrefix string, metas map[string]string) []byte {
2015-11-16 04:07:26 +05:30
urlPrefix = cutoutVerbosePrefix(urlPrefix)
pattern := IssueNumericPattern
if metas["style"] == ISSUE_NAME_STYLE_ALPHANUMERIC {
pattern = IssueAlphanumericPattern
}
ms := pattern.FindAll(rawBytes, -1)
2014-04-10 23:50:58 +05:30
for _, m := range ms {
if m[0] == ' ' || m[0] == '(' {
m = m[1:] // ignore leading space or opening parentheses
}
var link string
2015-12-05 08:00:33 +05:30
if metas == nil {
link = fmt.Sprintf(`<a href="%s/issues/%s">%s</a>`, urlPrefix, m[1:], m)
2015-12-05 08:00:33 +05:30
} else {
// Support for external issue tracker
if metas["style"] == ISSUE_NAME_STYLE_ALPHANUMERIC {
metas["index"] = string(m)
} else {
metas["index"] = string(m[1:])
}
link = fmt.Sprintf(`<a href="%s">%s</a>`, com.Expand(metas["format"], metas), m)
2015-12-05 08:00:33 +05:30
}
rawBytes = bytes.Replace(rawBytes, m, []byte(link), 1)
2015-12-05 08:00:33 +05:30
}
return rawBytes
}
2016-02-21 03:40:05 +05:30
// RenderSha1CurrentPattern renders SHA1 strings to corresponding links that assumes in the same repository.
func RenderSha1CurrentPattern(rawBytes []byte, urlPrefix string) []byte {
return []byte(Sha1CurrentPattern.ReplaceAllStringFunc(string(rawBytes[:]), func(m string) string {
return fmt.Sprintf(`<a href="%s/commit/%s"><code>%s</code></a>`, urlPrefix, m, base.ShortSha(string(m)))
}))
2016-02-21 03:40:05 +05:30
}
// RenderSpecialLink renders mentions, indexes and SHA1 strings to corresponding links.
2015-12-05 08:00:33 +05:30
func RenderSpecialLink(rawBytes []byte, urlPrefix string, metas map[string]string) []byte {
ms := MentionPattern.FindAll(rawBytes, -1)
for _, m := range ms {
m = bytes.TrimSpace(m)
rawBytes = bytes.Replace(rawBytes, m,
[]byte(fmt.Sprintf(`<a href="%s/%s">%s</a>`, setting.AppSubUrl, m[1:], m)), -1)
}
rawBytes = RenderIssueIndexPattern(rawBytes, urlPrefix, metas)
rawBytes = RenderSha1CurrentPattern(rawBytes, urlPrefix)
return rawBytes
}
2016-02-21 03:40:05 +05:30
// RenderRaw renders Markdown to HTML without handling special links.
func RenderRaw(body []byte, urlPrefix string) []byte {
2014-04-10 23:50:58 +05:30
htmlFlags := 0
2014-10-05 02:45:22 +05:30
htmlFlags |= blackfriday.HTML_SKIP_STYLE
htmlFlags |= blackfriday.HTML_OMIT_CONTENTS
2016-02-21 03:40:05 +05:30
renderer := &Renderer{
2014-10-05 02:45:22 +05:30
Renderer: blackfriday.HtmlRenderer(htmlFlags, "", ""),
2014-04-10 23:50:58 +05:30
urlPrefix: urlPrefix,
}
// set up the parser
extensions := 0
2014-10-05 02:45:22 +05:30
extensions |= blackfriday.EXTENSION_NO_INTRA_EMPHASIS
extensions |= blackfriday.EXTENSION_TABLES
extensions |= blackfriday.EXTENSION_FENCED_CODE
extensions |= blackfriday.EXTENSION_AUTOLINK
extensions |= blackfriday.EXTENSION_STRIKETHROUGH
extensions |= blackfriday.EXTENSION_SPACE_HEADERS
extensions |= blackfriday.EXTENSION_NO_EMPTY_LINE_BEFORE_BLOCK
if setting.Markdown.EnableHardLineBreak {
extensions |= blackfriday.EXTENSION_HARD_LINE_BREAK
}
2014-10-05 02:45:22 +05:30
body = blackfriday.Markdown(body, renderer, extensions)
2014-05-05 22:38:01 +05:30
return body
}
2015-11-20 12:22:11 +05:30
var (
leftAngleBracket = []byte("</")
rightAngleBracket = []byte(">")
)
2015-11-20 16:07:51 +05:30
var noEndTags = []string{"img", "input", "br", "hr"}
2016-02-21 03:40:05 +05:30
// PostProcess treats different types of HTML differently,
// and only renders special links for plain text blocks.
2016-02-21 03:40:05 +05:30
func PostProcess(rawHtml []byte, urlPrefix string, metas map[string]string) []byte {
2015-11-20 16:07:51 +05:30
startTags := make([]string, 0, 5)
var buf bytes.Buffer
tokenizer := html.NewTokenizer(bytes.NewReader(rawHtml))
2015-11-20 16:07:51 +05:30
OUTER_LOOP:
for html.ErrorToken != tokenizer.Next() {
token := tokenizer.Token()
switch token.Type {
case html.TextToken:
2015-12-05 08:00:33 +05:30
buf.Write(RenderSpecialLink([]byte(token.String()), urlPrefix, metas))
case html.StartTagToken:
buf.WriteString(token.String())
tagName := token.Data
// If this is an excluded tag, we skip processing all output until a close tag is encountered.
if strings.EqualFold("a", tagName) || strings.EqualFold("code", tagName) || strings.EqualFold("pre", tagName) {
2015-11-22 07:36:11 +05:30
stackNum := 1
for html.ErrorToken != tokenizer.Next() {
token = tokenizer.Token()
2015-11-20 16:07:51 +05:30
// Copy the token to the output verbatim
buf.WriteString(token.String())
2015-11-22 07:36:11 +05:30
if token.Type == html.StartTagToken {
stackNum++
}
// If this is the close tag to the outer-most, we are done
if token.Type == html.EndTagToken {
2015-11-22 07:36:11 +05:30
stackNum--
if stackNum <= 0 && strings.EqualFold(tagName, token.Data) {
2015-11-22 07:36:11 +05:30
break
}
}
}
2015-11-20 16:07:51 +05:30
continue OUTER_LOOP
}
if !com.IsSliceContainsStr(noEndTags, token.Data) {
startTags = append(startTags, token.Data)
}
2015-11-20 12:22:11 +05:30
case html.EndTagToken:
2015-11-25 05:58:24 +05:30
if len(startTags) == 0 {
2015-11-25 05:59:35 +05:30
buf.WriteString(token.String())
2015-11-25 05:58:24 +05:30
break
}
2015-11-20 12:22:11 +05:30
buf.Write(leftAngleBracket)
2015-11-20 16:07:51 +05:30
buf.WriteString(startTags[len(startTags)-1])
2015-11-20 12:22:11 +05:30
buf.Write(rightAngleBracket)
2015-11-20 16:07:51 +05:30
startTags = startTags[:len(startTags)-1]
default:
buf.WriteString(token.String())
}
}
if io.EOF == tokenizer.Err() {
return buf.Bytes()
}
// If we are not at the end of the input, then some other parsing error has occurred,
// so return the input verbatim.
return rawHtml
}
2016-02-21 03:40:05 +05:30
// Render renders Markdown to HTML with special links.
func Render(rawBytes []byte, urlPrefix string, metas map[string]string) []byte {
urlPrefix = strings.Replace(urlPrefix, space, spaceEncoded, -1)
2016-02-21 03:40:05 +05:30
result := RenderRaw(rawBytes, urlPrefix)
result = PostProcess(result, urlPrefix, metas)
result = Sanitizer.SanitizeBytes(result)
return result
}
2016-02-21 03:40:05 +05:30
// RenderString renders Markdown to HTML with special links and returns string type.
func RenderString(raw, urlPrefix string, metas map[string]string) string {
return string(Render([]byte(raw), urlPrefix, metas))
}