blackfriday/html.go

867 lines
21 KiB
Go
Raw Normal View History

2011-05-29 11:17:53 +08:00
//
2011-06-28 10:11:32 +08:00
// Blackfriday Markdown Processor
// Available at http://github.com/russross/blackfriday
//
// Copyright © 2011 Russ Ross <russ@russross.com>.
// Distributed under the Simplified BSD License.
2011-06-28 10:11:32 +08:00
// See README.md for details.
2011-05-29 11:17:53 +08:00
//
//
//
// HTML rendering backend
//
//
package blackfriday
import (
"bytes"
"fmt"
"regexp"
2011-05-29 11:17:53 +08:00
"strconv"
"strings"
2011-05-29 11:17:53 +08:00
)
2011-07-08 02:05:29 +08:00
// Html renderer configuration options.
2011-05-29 11:17:53 +08:00
const (
2011-07-08 02:05:29 +08:00
HTML_SKIP_HTML = 1 << iota // skip preformatted HTML blocks
HTML_SKIP_STYLE // skip embedded <style> elements
HTML_SKIP_IMAGES // skip embedded images
HTML_SKIP_LINKS // skip all links
HTML_SANITIZE_OUTPUT // strip output of everything that's not known to be safe
2011-07-08 02:05:29 +08:00
HTML_SAFELINK // only link to trusted protocols
2014-02-25 22:21:57 +08:00
HTML_NOFOLLOW_LINKS // only link with rel="nofollow"
2011-07-08 02:05:29 +08:00
HTML_TOC // generate a table of contents
HTML_OMIT_CONTENTS // skip the main contents (for a standalone table of contents)
HTML_COMPLETE_PAGE // generate a complete HTML page
HTML_GITHUB_BLOCKCODE // use github fenced code rendering rules
HTML_USE_XHTML // generate XHTML output instead of HTML
HTML_USE_SMARTYPANTS // enable smart punctuation substitutions
HTML_SMARTYPANTS_FRACTIONS // enable smart fractions (with HTML_USE_SMARTYPANTS)
HTML_SMARTYPANTS_LATEX_DASHES // enable LaTeX-style dashes (with HTML_USE_SMARTYPANTS)
2011-05-29 11:17:53 +08:00
)
var (
2014-01-27 03:21:25 +08:00
tags = []string{
"b",
"blockquote",
"code",
"del",
"dd",
"dl",
"dt",
"em",
"h1",
"h2",
"h3",
"h4",
"h5",
"h6",
"i",
"kbd",
"li",
"ol",
"p",
"pre",
"s",
"sup",
"sub",
"strong",
"strike",
"ul",
"table",
"tr",
"td",
"th",
"thead",
"tbody",
}
2014-01-27 03:21:25 +08:00
urlRe = `((https?|ftp):\/\/|\/)[-A-Za-z0-9+&@#\/%?=~_|!:,.;\(\)]+`
tagWhitelist = regexp.MustCompile(`^(<\/?(` + strings.Join(tags, "|") + `)>|<(br|hr)\s?\/?>)$`)
2014-01-27 03:21:25 +08:00
anchorClean = regexp.MustCompile(`^(<a\shref="` + urlRe + `"(\stitle="[^"<>]+")?\s?>|<\/a>)$`)
imgClean = regexp.MustCompile(`^(<img\ssrc="` + urlRe + `"(\swidth="\d{1,3}")?(\sheight="\d{1,3}")?(\salt="[^"<>]*")?(\stitle="[^"<>]*")?\s?\/?>)$`)
// TODO: improve this regexp to catch all possible entities:
htmlEntity = regexp.MustCompile(`&[a-z]{2,5};`)
)
2011-07-08 01:56:45 +08:00
// Html is a type that implements the Renderer interface for HTML output.
//
// Do not create this directly, instead use the HtmlRenderer function.
2011-06-30 01:13:17 +08:00
type Html struct {
flags int // HTML_* options
closeTag string // how to end singleton tags: either " />\n" or ">\n"
title string // document title
css string // optional css file url (used with HTML_COMPLETE_PAGE)
// table of contents data
2011-06-30 00:36:56 +08:00
tocMarker int
headerCount int
currentLevel int
toc *bytes.Buffer
2011-07-08 01:56:45 +08:00
smartypants *smartypantsRenderer
2011-05-29 11:17:53 +08:00
}
2011-06-30 01:13:17 +08:00
const (
xhtmlClose = " />\n"
htmlClose = ">\n"
)
2011-05-29 11:17:53 +08:00
2011-07-08 01:56:45 +08:00
// HtmlRenderer creates and configures an Html object, which
// satisfies the Renderer interface.
//
// flags is a set of HTML_* options ORed together.
// title is the title of the document, and css is a URL for the document's
// stylesheet.
// title and css are only used when HTML_COMPLETE_PAGE is selected.
2011-06-30 01:13:17 +08:00
func HtmlRenderer(flags int, title string, css string) Renderer {
2011-05-29 11:17:53 +08:00
// configure the rendering engine
closeTag := htmlClose
2011-05-29 11:17:53 +08:00
if flags&HTML_USE_XHTML != 0 {
closeTag = xhtmlClose
2011-05-29 11:17:53 +08:00
}
2011-06-30 01:13:17 +08:00
return &Html{
flags: flags,
closeTag: closeTag,
title: title,
css: css,
2011-05-29 11:17:53 +08:00
headerCount: 0,
currentLevel: 0,
2011-06-30 00:36:56 +08:00
toc: new(bytes.Buffer),
2011-05-29 11:17:53 +08:00
2011-07-08 01:56:45 +08:00
smartypants: smartypants(flags),
2011-05-29 11:17:53 +08:00
}
}
// Using if statements is a bit faster than a switch statement. As the compiler
// improves, this should be unnecessary this is only worthwhile because
// attrEscape is the single largest CPU user in normal use.
// Also tried using map, but that gave a ~3x slowdown.
func escapeSingleChar(char byte) (string, bool) {
if char == '"' {
return "&quot;", true
}
if char == '&' {
return "&amp;", true
}
if char == '<' {
return "&lt;", true
}
if char == '>' {
return "&gt;", true
}
return "", false
}
func attrEscape(out *bytes.Buffer, src []byte) {
org := 0
for i, ch := range src {
if entity, ok := escapeSingleChar(ch); ok {
if i > org {
// copy all the normal characters since the last escape
out.Write(src[org:i])
}
org = i + 1
out.WriteString(entity)
2011-05-29 11:17:53 +08:00
}
}
if org < len(src) {
out.Write(src[org:])
}
2011-05-29 11:17:53 +08:00
}
func entityEscapeWithSkip(out *bytes.Buffer, src []byte, skipRanges [][]int) {
end := 0
for _, rang := range skipRanges {
attrEscape(out, src[end:rang[0]])
out.Write(src[rang[0]:rang[1]])
end = rang[1]
}
attrEscape(out, src[end:])
}
func (options *Html) GetFlags() int {
return options.flags
}
func (options *Html) Header(out *bytes.Buffer, text func() bool, level int, id string) {
marker := out.Len()
doubleSpace(out)
2011-05-29 11:17:53 +08:00
if id != "" {
out.WriteString(fmt.Sprintf("<h%d id=\"%s\">", level, id))
} else if options.flags&HTML_TOC != 0 {
2011-06-30 00:36:56 +08:00
// headerCount is incremented in htmlTocHeader
out.WriteString(fmt.Sprintf("<h%d id=\"toc_%d\">", level, options.headerCount))
2011-05-29 11:17:53 +08:00
} else {
out.WriteString(fmt.Sprintf("<h%d>", level))
2011-05-29 11:17:53 +08:00
}
2011-06-30 00:36:56 +08:00
tocMarker := out.Len()
if !text() {
out.Truncate(marker)
return
}
// are we building a table of contents?
if options.flags&HTML_TOC != 0 {
2011-06-30 01:13:17 +08:00
options.TocHeader(out.Bytes()[tocMarker:], level)
}
out.WriteString(fmt.Sprintf("</h%d>\n", level))
2011-05-29 11:17:53 +08:00
}
2011-06-30 01:13:17 +08:00
func (options *Html) BlockHtml(out *bytes.Buffer, text []byte) {
if options.flags&HTML_SKIP_HTML != 0 {
return
}
doubleSpace(out)
out.Write(text)
out.WriteByte('\n')
2011-05-29 11:17:53 +08:00
}
2011-06-30 01:13:17 +08:00
func (options *Html) HRule(out *bytes.Buffer) {
doubleSpace(out)
out.WriteString("<hr")
out.WriteString(options.closeTag)
2011-05-29 11:17:53 +08:00
}
2011-06-30 01:13:17 +08:00
func (options *Html) BlockCode(out *bytes.Buffer, text []byte, lang string) {
if options.flags&HTML_GITHUB_BLOCKCODE != 0 {
2011-06-30 01:13:17 +08:00
options.BlockCodeGithub(out, text, lang)
} else {
2011-06-30 01:13:17 +08:00
options.BlockCodeNormal(out, text, lang)
}
}
2011-06-30 01:13:17 +08:00
func (options *Html) BlockCodeNormal(out *bytes.Buffer, text []byte, lang string) {
doubleSpace(out)
2011-05-29 11:17:53 +08:00
// parse out the language names/classes
count := 0
for _, elt := range strings.Fields(lang) {
if elt[0] == '.' {
elt = elt[1:]
2011-05-29 11:17:53 +08:00
}
if len(elt) == 0 {
continue
}
if count == 0 {
out.WriteString("<pre><code class=\"")
} else {
out.WriteByte(' ')
}
attrEscape(out, []byte(elt))
count++
2011-05-29 11:17:53 +08:00
}
if count == 0 {
out.WriteString("<pre><code>")
} else {
out.WriteString("\">")
2011-05-29 11:17:53 +08:00
}
attrEscape(out, text)
out.WriteString("</code></pre>\n")
2011-05-29 11:17:53 +08:00
}
// GitHub style code block:
//
// <pre lang="LANG"><code>
// ...
2012-11-23 04:52:52 +08:00
// </code></pre>
//
// Unlike other parsers, we store the language identifier in the <pre>,
// and don't let the user generate custom classes.
//
// The language identifier in the <pre> block gets postprocessed and all
// the code inside gets syntax highlighted with Pygments. This is much safer
// than letting the user specify a CSS class for highlighting.
//
// Note that we only generate HTML for the first specifier.
// E.g.
// ~~~~ {.python .numbered} => <pre lang="python"><code>
2011-06-30 01:13:17 +08:00
func (options *Html) BlockCodeGithub(out *bytes.Buffer, text []byte, lang string) {
doubleSpace(out)
2011-05-29 11:17:53 +08:00
// parse out the language name
count := 0
for _, elt := range strings.Fields(lang) {
if elt[0] == '.' {
elt = elt[1:]
2011-05-29 11:17:53 +08:00
}
if len(elt) == 0 {
continue
2011-05-29 11:17:53 +08:00
}
out.WriteString("<pre lang=\"")
attrEscape(out, []byte(elt))
out.WriteString("\"><code>")
count++
break
2011-05-29 11:17:53 +08:00
}
if count == 0 {
out.WriteString("<pre><code>")
2011-05-29 11:17:53 +08:00
}
attrEscape(out, text)
out.WriteString("</code></pre>\n")
2011-05-29 11:17:53 +08:00
}
2011-06-30 01:13:17 +08:00
func (options *Html) BlockQuote(out *bytes.Buffer, text []byte) {
doubleSpace(out)
out.WriteString("<blockquote>\n")
out.Write(text)
out.WriteString("</blockquote>\n")
2011-05-29 11:17:53 +08:00
}
2011-06-30 01:13:17 +08:00
func (options *Html) Table(out *bytes.Buffer, header []byte, body []byte, columnData []int) {
doubleSpace(out)
out.WriteString("<table>\n<thead>\n")
out.Write(header)
out.WriteString("</thead>\n\n<tbody>\n")
out.Write(body)
out.WriteString("</tbody>\n</table>\n")
2011-05-29 11:17:53 +08:00
}
2011-06-30 01:13:17 +08:00
func (options *Html) TableRow(out *bytes.Buffer, text []byte) {
doubleSpace(out)
out.WriteString("<tr>\n")
out.Write(text)
out.WriteString("\n</tr>\n")
2011-05-29 11:17:53 +08:00
}
func (options *Html) TableHeaderCell(out *bytes.Buffer, text []byte, align int) {
doubleSpace(out)
switch align {
case TABLE_ALIGNMENT_LEFT:
out.WriteString("<th align=\"left\">")
case TABLE_ALIGNMENT_RIGHT:
out.WriteString("<th align=\"right\">")
case TABLE_ALIGNMENT_CENTER:
out.WriteString("<th align=\"center\">")
default:
out.WriteString("<th>")
}
out.Write(text)
out.WriteString("</th>")
}
2011-06-30 01:13:17 +08:00
func (options *Html) TableCell(out *bytes.Buffer, text []byte, align int) {
doubleSpace(out)
2011-05-29 11:17:53 +08:00
switch align {
case TABLE_ALIGNMENT_LEFT:
out.WriteString("<td align=\"left\">")
2011-05-29 11:17:53 +08:00
case TABLE_ALIGNMENT_RIGHT:
out.WriteString("<td align=\"right\">")
2011-05-29 11:17:53 +08:00
case TABLE_ALIGNMENT_CENTER:
out.WriteString("<td align=\"center\">")
2011-05-29 11:17:53 +08:00
default:
out.WriteString("<td>")
2011-05-29 11:17:53 +08:00
}
out.Write(text)
out.WriteString("</td>")
2011-05-29 11:17:53 +08:00
}
func (options *Html) Footnotes(out *bytes.Buffer, text func() bool) {
out.WriteString("<div class=\"footnotes\">\n")
options.HRule(out)
options.List(out, text, LIST_TYPE_ORDERED)
out.WriteString("</div>\n")
}
func (options *Html) FootnoteItem(out *bytes.Buffer, name, text []byte, flags int) {
if flags&LIST_ITEM_CONTAINS_BLOCK != 0 || flags&LIST_ITEM_BEGINNING_OF_LIST != 0 {
doubleSpace(out)
}
out.WriteString(`<li id="fn:`)
out.Write(slugify(name))
out.WriteString(`">`)
out.Write(text)
out.WriteString("</li>\n")
}
2011-06-30 01:13:17 +08:00
func (options *Html) List(out *bytes.Buffer, text func() bool, flags int) {
2011-06-26 05:02:46 +08:00
marker := out.Len()
doubleSpace(out)
2011-06-26 05:02:46 +08:00
2011-05-29 11:17:53 +08:00
if flags&LIST_TYPE_ORDERED != 0 {
out.WriteString("<ol>")
2011-05-29 11:17:53 +08:00
} else {
out.WriteString("<ul>")
2011-05-29 11:17:53 +08:00
}
2011-06-26 05:02:46 +08:00
if !text() {
out.Truncate(marker)
return
}
2011-05-29 11:17:53 +08:00
if flags&LIST_TYPE_ORDERED != 0 {
out.WriteString("</ol>\n")
2011-05-29 11:17:53 +08:00
} else {
out.WriteString("</ul>\n")
2011-05-29 11:17:53 +08:00
}
}
2011-06-30 01:13:17 +08:00
func (options *Html) ListItem(out *bytes.Buffer, text []byte, flags int) {
if flags&LIST_ITEM_CONTAINS_BLOCK != 0 || flags&LIST_ITEM_BEGINNING_OF_LIST != 0 {
doubleSpace(out)
}
out.WriteString("<li>")
out.Write(text)
out.WriteString("</li>\n")
2011-05-29 11:17:53 +08:00
}
2011-06-30 01:13:17 +08:00
func (options *Html) Paragraph(out *bytes.Buffer, text func() bool) {
marker := out.Len()
doubleSpace(out)
2011-05-29 11:17:53 +08:00
out.WriteString("<p>")
if !text() {
out.Truncate(marker)
return
}
out.WriteString("</p>\n")
2011-05-29 11:17:53 +08:00
}
2011-06-30 03:00:54 +08:00
func (options *Html) AutoLink(out *bytes.Buffer, link []byte, kind int) {
skipRanges := htmlEntity.FindAllIndex(link, -1)
if options.flags&HTML_SAFELINK != 0 && !isSafeLink(link) && kind != LINK_TYPE_EMAIL {
// mark it but don't link it if it is not a safe link: no smartypants
out.WriteString("<tt>")
entityEscapeWithSkip(out, link, skipRanges)
out.WriteString("</tt>")
2011-06-30 03:00:54 +08:00
return
2011-05-29 11:17:53 +08:00
}
out.WriteString("<a href=\"")
2011-05-29 11:17:53 +08:00
if kind == LINK_TYPE_EMAIL {
out.WriteString("mailto:")
2011-05-29 11:17:53 +08:00
}
entityEscapeWithSkip(out, link, skipRanges)
out.WriteString("\">")
2011-05-29 11:17:53 +08:00
// Pretty print: if we get an email address as
// an actual URI, e.g. `mailto:foo@bar.com`, we don't
// want to print the `mailto:` prefix
2011-06-01 01:49:49 +08:00
switch {
case bytes.HasPrefix(link, []byte("mailto://")):
attrEscape(out, link[len("mailto://"):])
2011-06-01 01:49:49 +08:00
case bytes.HasPrefix(link, []byte("mailto:")):
attrEscape(out, link[len("mailto:"):])
default:
entityEscapeWithSkip(out, link, skipRanges)
2011-05-29 11:17:53 +08:00
}
out.WriteString("</a>")
2011-05-29 11:17:53 +08:00
}
2011-06-30 03:00:54 +08:00
func (options *Html) CodeSpan(out *bytes.Buffer, text []byte) {
out.WriteString("<code>")
attrEscape(out, text)
out.WriteString("</code>")
2011-05-29 11:17:53 +08:00
}
2011-06-30 03:00:54 +08:00
func (options *Html) DoubleEmphasis(out *bytes.Buffer, text []byte) {
out.WriteString("<strong>")
out.Write(text)
out.WriteString("</strong>")
2011-05-29 11:17:53 +08:00
}
2011-06-30 03:00:54 +08:00
func (options *Html) Emphasis(out *bytes.Buffer, text []byte) {
2011-05-29 11:17:53 +08:00
if len(text) == 0 {
2011-06-30 03:00:54 +08:00
return
2011-05-29 11:17:53 +08:00
}
out.WriteString("<em>")
out.Write(text)
out.WriteString("</em>")
2011-05-29 11:17:53 +08:00
}
2011-06-30 03:00:54 +08:00
func (options *Html) Image(out *bytes.Buffer, link []byte, title []byte, alt []byte) {
if options.flags&HTML_SKIP_IMAGES != 0 {
2011-06-30 03:00:54 +08:00
return
}
out.WriteString("<img src=\"")
attrEscape(out, link)
out.WriteString("\" alt=\"")
2011-05-29 11:17:53 +08:00
if len(alt) > 0 {
attrEscape(out, alt)
2011-05-29 11:17:53 +08:00
}
if len(title) > 0 {
out.WriteString("\" title=\"")
attrEscape(out, title)
2011-05-29 11:17:53 +08:00
}
out.WriteByte('"')
out.WriteString(options.closeTag)
2011-06-30 03:00:54 +08:00
return
2011-05-29 11:17:53 +08:00
}
2011-06-30 03:00:54 +08:00
func (options *Html) LineBreak(out *bytes.Buffer) {
out.WriteString("<br")
out.WriteString(options.closeTag)
2011-05-29 11:17:53 +08:00
}
2011-06-30 03:00:54 +08:00
func (options *Html) Link(out *bytes.Buffer, link []byte, title []byte, content []byte) {
if options.flags&HTML_SKIP_LINKS != 0 {
// write the link text out but don't link it, just mark it with typewriter font
out.WriteString("<tt>")
attrEscape(out, content)
out.WriteString("</tt>")
2011-06-30 03:00:54 +08:00
return
}
2011-05-29 11:17:53 +08:00
if options.flags&HTML_SAFELINK != 0 && !isSafeLink(link) {
// write the link text out but don't link it, just mark it with typewriter font
out.WriteString("<tt>")
attrEscape(out, content)
out.WriteString("</tt>")
2011-06-30 03:00:54 +08:00
return
2011-05-29 11:17:53 +08:00
}
out.WriteString("<a href=\"")
attrEscape(out, link)
2011-05-29 11:17:53 +08:00
if len(title) > 0 {
out.WriteString("\" title=\"")
attrEscape(out, title)
2011-05-29 11:17:53 +08:00
}
2014-02-25 22:21:57 +08:00
if options.flags&HTML_NOFOLLOW_LINKS != 0 {
out.WriteString("\" rel=\"nofollow")
}
out.WriteString("\">")
out.Write(content)
out.WriteString("</a>")
2011-06-30 03:00:54 +08:00
return
2011-05-29 11:17:53 +08:00
}
2011-06-30 03:00:54 +08:00
func (options *Html) RawHtmlTag(out *bytes.Buffer, text []byte) {
if options.flags&HTML_SKIP_HTML != 0 {
2011-06-30 03:00:54 +08:00
return
2011-05-29 11:17:53 +08:00
}
if options.flags&HTML_SKIP_STYLE != 0 && isHtmlTag(text, "style") {
2011-06-30 03:00:54 +08:00
return
2011-05-29 11:17:53 +08:00
}
if options.flags&HTML_SKIP_LINKS != 0 && isHtmlTag(text, "a") {
2011-06-30 03:00:54 +08:00
return
2011-05-29 11:17:53 +08:00
}
if options.flags&HTML_SKIP_IMAGES != 0 && isHtmlTag(text, "img") {
2011-06-30 03:00:54 +08:00
return
2011-05-29 11:17:53 +08:00
}
out.Write(text)
2011-05-29 11:17:53 +08:00
}
2011-06-30 03:00:54 +08:00
func (options *Html) TripleEmphasis(out *bytes.Buffer, text []byte) {
out.WriteString("<strong><em>")
out.Write(text)
out.WriteString("</em></strong>")
2011-05-29 11:17:53 +08:00
}
2011-06-30 03:00:54 +08:00
func (options *Html) StrikeThrough(out *bytes.Buffer, text []byte) {
out.WriteString("<del>")
out.Write(text)
out.WriteString("</del>")
2011-05-29 11:17:53 +08:00
}
func (options *Html) FootnoteRef(out *bytes.Buffer, ref []byte, id int) {
slug := slugify(ref)
out.WriteString(`<sup class="footnote-ref" id="fnref:`)
out.Write(slug)
out.WriteString(`"><a rel="footnote" href="#fn:`)
out.Write(slug)
out.WriteString(`">`)
out.WriteString(strconv.Itoa(id))
out.WriteString(`</a></sup>`)
}
2011-06-30 01:13:17 +08:00
func (options *Html) Entity(out *bytes.Buffer, entity []byte) {
out.Write(entity)
}
2011-06-30 01:13:17 +08:00
func (options *Html) NormalText(out *bytes.Buffer, text []byte) {
if options.flags&HTML_USE_SMARTYPANTS != 0 {
2011-06-30 01:13:17 +08:00
options.Smartypants(out, text)
} else {
attrEscape(out, text)
}
2011-05-29 11:17:53 +08:00
}
2011-06-30 01:13:17 +08:00
func (options *Html) Smartypants(out *bytes.Buffer, text []byte) {
smrt := smartypantsData{false, false}
// first do normal entity escaping
var escaped bytes.Buffer
attrEscape(&escaped, text)
text = escaped.Bytes()
mark := 0
for i := 0; i < len(text); i++ {
if action := options.smartypants[text[i]]; action != nil {
if i > mark {
out.Write(text[mark:i])
}
previousChar := byte(0)
if i > 0 {
previousChar = text[i-1]
}
i += action(out, &smrt, previousChar, text[i:])
mark = i + 1
}
}
if mark < len(text) {
out.Write(text[mark:])
}
}
func (options *Html) DocumentHeader(out *bytes.Buffer) {
if options.flags&HTML_COMPLETE_PAGE == 0 {
return
}
ending := ""
if options.flags&HTML_USE_XHTML != 0 {
out.WriteString("<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML 1.0 Transitional//EN\" ")
out.WriteString("\"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd\">\n")
out.WriteString("<html xmlns=\"http://www.w3.org/1999/xhtml\">\n")
ending = " /"
} else {
out.WriteString("<!DOCTYPE html>\n")
out.WriteString("<html>\n")
}
out.WriteString("<head>\n")
out.WriteString(" <title>")
2011-06-30 01:13:17 +08:00
options.NormalText(out, []byte(options.title))
out.WriteString("</title>\n")
out.WriteString(" <meta name=\"GENERATOR\" content=\"Blackfriday Markdown Processor v")
out.WriteString(VERSION)
out.WriteString("\"")
out.WriteString(ending)
out.WriteString(">\n")
out.WriteString(" <meta charset=\"utf-8\"")
out.WriteString(ending)
out.WriteString(">\n")
if options.css != "" {
out.WriteString(" <link rel=\"stylesheet\" type=\"text/css\" href=\"")
attrEscape(out, []byte(options.css))
out.WriteString("\"")
out.WriteString(ending)
out.WriteString(">\n")
}
out.WriteString("</head>\n")
out.WriteString("<body>\n")
2011-06-30 00:36:56 +08:00
options.tocMarker = out.Len()
}
2011-06-30 01:13:17 +08:00
func (options *Html) DocumentFooter(out *bytes.Buffer) {
2011-06-30 00:36:56 +08:00
// finalize and insert the table of contents
if options.flags&HTML_TOC != 0 {
2011-06-30 01:13:17 +08:00
options.TocFinalize()
2011-06-30 00:36:56 +08:00
// now we have to insert the table of contents into the document
var temp bytes.Buffer
// start by making a copy of everything after the document header
temp.Write(out.Bytes()[options.tocMarker:])
// now clear the copied material from the main output buffer
out.Truncate(options.tocMarker)
// corner case spacing issue
if options.flags&HTML_COMPLETE_PAGE != 0 {
out.WriteByte('\n')
}
2011-06-30 00:36:56 +08:00
// insert the table of contents
out.WriteString("<nav>\n")
2011-06-30 00:36:56 +08:00
out.Write(options.toc.Bytes())
out.WriteString("</nav>\n")
2011-06-30 00:36:56 +08:00
// corner case spacing issue
if options.flags&HTML_COMPLETE_PAGE == 0 && options.flags&HTML_OMIT_CONTENTS == 0 {
out.WriteByte('\n')
}
2011-06-30 00:36:56 +08:00
// write out everything that came after it
if options.flags&HTML_OMIT_CONTENTS == 0 {
out.Write(temp.Bytes())
}
}
if options.flags&HTML_COMPLETE_PAGE != 0 {
out.WriteString("\n</body>\n")
out.WriteString("</html>\n")
2011-05-29 11:17:53 +08:00
}
2011-05-29 11:17:53 +08:00
}
2011-06-30 01:13:17 +08:00
func (options *Html) TocHeader(text []byte, level int) {
2011-06-30 00:36:56 +08:00
for level > options.currentLevel {
switch {
case bytes.HasSuffix(options.toc.Bytes(), []byte("</li>\n")):
// this sublist can nest underneath a header
2011-06-30 00:36:56 +08:00
size := options.toc.Len()
options.toc.Truncate(size - len("</li>\n"))
case options.currentLevel > 0:
options.toc.WriteString("<li>")
}
if options.toc.Len() > 0 {
options.toc.WriteByte('\n')
}
options.toc.WriteString("<ul>\n")
2011-06-30 00:36:56 +08:00
options.currentLevel++
}
for level < options.currentLevel {
options.toc.WriteString("</ul>")
if options.currentLevel > 1 {
options.toc.WriteString("</li>\n")
}
options.currentLevel--
}
options.toc.WriteString("<li><a href=\"#toc_")
options.toc.WriteString(strconv.Itoa(options.headerCount))
options.toc.WriteString("\">")
options.headerCount++
options.toc.Write(text)
options.toc.WriteString("</a></li>\n")
}
2011-06-30 01:13:17 +08:00
func (options *Html) TocFinalize() {
for options.currentLevel > 1 {
2011-06-30 00:36:56 +08:00
options.toc.WriteString("</ul></li>\n")
options.currentLevel--
2011-05-29 11:17:53 +08:00
}
if options.currentLevel > 0 {
2011-06-30 00:36:56 +08:00
options.toc.WriteString("</ul>\n")
2011-05-29 11:17:53 +08:00
}
}
func isHtmlTag(tag []byte, tagname string) bool {
2013-04-18 08:15:47 +08:00
found, _ := findHtmlTagPos(tag, tagname)
return found
}
2014-01-22 06:45:43 +08:00
// Look for a character, but ignore it when it's in any kind of quotes, it
// might be JavaScript
func skipUntilCharIgnoreQuotes(html []byte, start int, char byte) int {
inSingleQuote := false
inDoubleQuote := false
inGraveQuote := false
i := start
for i < len(html) {
switch {
case html[i] == char && !inSingleQuote && !inDoubleQuote && !inGraveQuote:
return i
case html[i] == '\'':
inSingleQuote = !inSingleQuote
case html[i] == '"':
inDoubleQuote = !inDoubleQuote
case html[i] == '`':
inGraveQuote = !inGraveQuote
}
i++
}
return start
}
2013-04-18 08:15:47 +08:00
func findHtmlTagPos(tag []byte, tagname string) (bool, int) {
2011-05-29 11:17:53 +08:00
i := 0
if i < len(tag) && tag[0] != '<' {
2013-04-18 08:15:47 +08:00
return false, -1
2011-05-29 11:17:53 +08:00
}
i++
2013-04-14 03:26:29 +08:00
i = skipSpace(tag, i)
2011-05-29 11:17:53 +08:00
if i < len(tag) && tag[i] == '/' {
i++
}
2013-04-14 03:26:29 +08:00
i = skipSpace(tag, i)
j := 0
2011-06-29 06:02:12 +08:00
for ; i < len(tag); i, j = i+1, j+1 {
if j >= len(tagname) {
2011-05-29 11:17:53 +08:00
break
}
2013-04-14 03:34:37 +08:00
if strings.ToLower(string(tag[i]))[0] != tagname[j] {
2013-04-18 08:15:47 +08:00
return false, -1
2011-05-29 11:17:53 +08:00
}
}
if i == len(tag) {
2013-04-18 08:15:47 +08:00
return false, -1
}
2014-01-22 06:45:43 +08:00
rightAngle := skipUntilCharIgnoreQuotes(tag, i, '>')
if rightAngle > i {
return true, rightAngle
2011-05-29 11:17:53 +08:00
}
2013-04-18 08:15:47 +08:00
return false, -1
2011-05-29 11:17:53 +08:00
}
func sanitizeHtml(html []byte) []byte {
var result []byte
for string(html) != "" {
skip, tag, rest := findHtmlTag(html)
html = rest
result = append(result, skip...)
result = append(result, sanitizeTag(tag)...)
}
return append(result, []byte("\n")...)
}
func sanitizeTag(tag []byte) []byte {
if tagWhitelist.Match(tag) || anchorClean.Match(tag) || imgClean.Match(tag) {
return tag
}
return []byte("")
}
func skipUntilChar(text []byte, start int, char byte) int {
i := start
for i < len(text) && text[i] != char {
i++
}
return i
}
func findHtmlTag(html []byte) (skip, tag, rest []byte) {
start := skipUntilChar(html, 0, '<')
rightAngle := skipUntilCharIgnoreQuotes(html, start, '>')
if rightAngle > start {
skip = html[0:start]
tag = html[start : rightAngle+1]
rest = html[rightAngle+1:]
return
}
return []byte(""), []byte(""), []byte("")
}
2013-04-14 03:26:29 +08:00
func skipSpace(tag []byte, i int) int {
for i < len(tag) && isspace(tag[i]) {
i++
}
return i
}
func doubleSpace(out *bytes.Buffer) {
if out.Len() > 0 {
out.WriteByte('\n')
}
}