2019-01-12 04:58:27 +00:00
|
|
|
/*
|
|
|
|
Copyright 2016 The Kubernetes Authors.
|
|
|
|
|
|
|
|
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 templates
|
|
|
|
|
|
|
|
import (
|
|
|
|
"bytes"
|
|
|
|
"fmt"
|
|
|
|
"strings"
|
|
|
|
|
|
|
|
"github.com/russross/blackfriday"
|
|
|
|
)
|
|
|
|
|
|
|
|
const linebreak = "\n"
|
|
|
|
|
|
|
|
// ASCIIRenderer implements blackfriday.Renderer
|
|
|
|
var _ blackfriday.Renderer = &ASCIIRenderer{}
|
|
|
|
|
|
|
|
// ASCIIRenderer is a blackfriday.Renderer intended for rendering markdown
|
|
|
|
// documents as plain text, well suited for human reading on terminals.
|
|
|
|
type ASCIIRenderer struct {
|
|
|
|
Indentation string
|
|
|
|
|
|
|
|
listItemCount uint
|
|
|
|
listLevel uint
|
|
|
|
}
|
|
|
|
|
|
|
|
// NormalText gets a text chunk *after* the markdown syntax was already
|
|
|
|
// processed and does a final cleanup on things we don't expect here, like
|
|
|
|
// removing linebreaks on things that are not a paragraph break (auto unwrap).
|
|
|
|
func (r *ASCIIRenderer) NormalText(out *bytes.Buffer, text []byte) {
|
|
|
|
raw := string(text)
|
|
|
|
lines := strings.Split(raw, linebreak)
|
|
|
|
for _, line := range lines {
|
|
|
|
trimmed := strings.Trim(line, " \n\t")
|
2019-04-07 17:07:55 +00:00
|
|
|
if len(trimmed) > 0 && trimmed[0] != '_' {
|
|
|
|
out.WriteString(" ")
|
|
|
|
}
|
2019-01-12 04:58:27 +00:00
|
|
|
out.WriteString(trimmed)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// List renders the start and end of a list.
|
|
|
|
func (r *ASCIIRenderer) List(out *bytes.Buffer, text func() bool, flags int) {
|
|
|
|
r.listLevel++
|
|
|
|
out.WriteString(linebreak)
|
|
|
|
text()
|
|
|
|
r.listLevel--
|
|
|
|
}
|
|
|
|
|
|
|
|
// ListItem renders list items and supports both ordered and unordered lists.
|
|
|
|
func (r *ASCIIRenderer) ListItem(out *bytes.Buffer, text []byte, flags int) {
|
|
|
|
if flags&blackfriday.LIST_ITEM_BEGINNING_OF_LIST != 0 {
|
|
|
|
r.listItemCount = 1
|
|
|
|
} else {
|
|
|
|
r.listItemCount++
|
|
|
|
}
|
|
|
|
indent := strings.Repeat(r.Indentation, int(r.listLevel))
|
|
|
|
var bullet string
|
|
|
|
if flags&blackfriday.LIST_TYPE_ORDERED != 0 {
|
|
|
|
bullet += fmt.Sprintf("%d.", r.listItemCount)
|
|
|
|
} else {
|
|
|
|
bullet += "*"
|
|
|
|
}
|
|
|
|
out.WriteString(indent + bullet + " ")
|
|
|
|
r.fw(out, text)
|
|
|
|
out.WriteString(linebreak)
|
|
|
|
}
|
|
|
|
|
|
|
|
// Paragraph renders the start and end of a paragraph.
|
|
|
|
func (r *ASCIIRenderer) Paragraph(out *bytes.Buffer, text func() bool) {
|
|
|
|
out.WriteString(linebreak)
|
|
|
|
text()
|
|
|
|
out.WriteString(linebreak)
|
|
|
|
}
|
|
|
|
|
|
|
|
// BlockCode renders a chunk of text that represents source code.
|
|
|
|
func (r *ASCIIRenderer) BlockCode(out *bytes.Buffer, text []byte, lang string) {
|
|
|
|
out.WriteString(linebreak)
|
|
|
|
lines := []string{}
|
|
|
|
for _, line := range strings.Split(string(text), linebreak) {
|
|
|
|
indented := r.Indentation + line
|
|
|
|
lines = append(lines, indented)
|
|
|
|
}
|
|
|
|
out.WriteString(strings.Join(lines, linebreak))
|
|
|
|
}
|
|
|
|
|
|
|
|
func (r *ASCIIRenderer) GetFlags() int { return 0 }
|
|
|
|
func (r *ASCIIRenderer) HRule(out *bytes.Buffer) {
|
|
|
|
out.WriteString(linebreak + "----------" + linebreak)
|
|
|
|
}
|
|
|
|
func (r *ASCIIRenderer) LineBreak(out *bytes.Buffer) { out.WriteString(linebreak) }
|
|
|
|
func (r *ASCIIRenderer) TitleBlock(out *bytes.Buffer, text []byte) { r.fw(out, text) }
|
|
|
|
func (r *ASCIIRenderer) Header(out *bytes.Buffer, text func() bool, level int, id string) { text() }
|
|
|
|
func (r *ASCIIRenderer) BlockHtml(out *bytes.Buffer, text []byte) { r.fw(out, text) }
|
|
|
|
func (r *ASCIIRenderer) BlockQuote(out *bytes.Buffer, text []byte) { r.fw(out, text) }
|
|
|
|
func (r *ASCIIRenderer) TableRow(out *bytes.Buffer, text []byte) { r.fw(out, text) }
|
|
|
|
func (r *ASCIIRenderer) TableHeaderCell(out *bytes.Buffer, text []byte, align int) { r.fw(out, text) }
|
|
|
|
func (r *ASCIIRenderer) TableCell(out *bytes.Buffer, text []byte, align int) { r.fw(out, text) }
|
|
|
|
func (r *ASCIIRenderer) Footnotes(out *bytes.Buffer, text func() bool) { text() }
|
2020-08-10 17:43:49 +00:00
|
|
|
func (r *ASCIIRenderer) FootnoteItem(out *bytes.Buffer, name, text []byte, flags int) {
|
|
|
|
r.fw(out, text)
|
|
|
|
}
|
|
|
|
func (r *ASCIIRenderer) AutoLink(out *bytes.Buffer, link []byte, kind int) { r.fw(out, link) }
|
|
|
|
func (r *ASCIIRenderer) CodeSpan(out *bytes.Buffer, text []byte) { r.fw(out, text) }
|
|
|
|
func (r *ASCIIRenderer) DoubleEmphasis(out *bytes.Buffer, text []byte) { r.fw(out, text) }
|
|
|
|
func (r *ASCIIRenderer) Emphasis(out *bytes.Buffer, text []byte) { r.fw(out, text) }
|
|
|
|
func (r *ASCIIRenderer) RawHtmlTag(out *bytes.Buffer, text []byte) { r.fw(out, text) }
|
|
|
|
func (r *ASCIIRenderer) TripleEmphasis(out *bytes.Buffer, text []byte) { r.fw(out, text) }
|
|
|
|
func (r *ASCIIRenderer) StrikeThrough(out *bytes.Buffer, text []byte) { r.fw(out, text) }
|
|
|
|
func (r *ASCIIRenderer) FootnoteRef(out *bytes.Buffer, ref []byte, id int) { r.fw(out, ref) }
|
|
|
|
func (r *ASCIIRenderer) Entity(out *bytes.Buffer, entity []byte) { r.fw(out, entity) }
|
|
|
|
func (r *ASCIIRenderer) Smartypants(out *bytes.Buffer, text []byte) { r.fw(out, text) }
|
|
|
|
func (r *ASCIIRenderer) DocumentHeader(out *bytes.Buffer) {}
|
|
|
|
func (r *ASCIIRenderer) DocumentFooter(out *bytes.Buffer) {}
|
|
|
|
func (r *ASCIIRenderer) TocHeaderWithAnchor(text []byte, level int, anchor string) {}
|
|
|
|
func (r *ASCIIRenderer) TocHeader(text []byte, level int) {}
|
|
|
|
func (r *ASCIIRenderer) TocFinalize() {}
|
2019-01-12 04:58:27 +00:00
|
|
|
|
|
|
|
func (r *ASCIIRenderer) Table(out *bytes.Buffer, header []byte, body []byte, columnData []int) {
|
|
|
|
r.fw(out, header, body)
|
|
|
|
}
|
|
|
|
|
|
|
|
func (r *ASCIIRenderer) Link(out *bytes.Buffer, link []byte, title []byte, content []byte) {
|
2020-08-10 17:43:49 +00:00
|
|
|
out.WriteString(" ")
|
2019-01-12 04:58:27 +00:00
|
|
|
r.fw(out, link)
|
|
|
|
}
|
|
|
|
|
|
|
|
func (r *ASCIIRenderer) Image(out *bytes.Buffer, link []byte, title []byte, alt []byte) {
|
|
|
|
r.fw(out, link)
|
|
|
|
}
|
|
|
|
|
|
|
|
func (r *ASCIIRenderer) fw(out *bytes.Buffer, text ...[]byte) {
|
|
|
|
for _, t := range text {
|
|
|
|
out.Write(t)
|
|
|
|
}
|
|
|
|
}
|