<${head_tag}>${sym_name}${hash_link}')
} else {
dnw.write_string('${tabs(3)}
<${head_tag}>${dn.kind} ${sym_name}${hash_link}')
}
if link != '' {
dnw.write_string('
${link_svg}')
}
dnw.write_string('
\n')
}
if deprecated_tags.len > 0 {
attributes :=
deprecated_tags.map('
${it.replace_each(quote_escape_seq)}
\n').join('')
dnw.writeln('
${attributes}
\n')
}
if tags.len > 0 {
attributes := tags.map('
${it}
').join('')
dnw.writeln('
${attributes}
')
}
if !head && dn.content.len > 0 {
dnw.writeln('
\n${highlighted_code}
')
}
// do not mess with md_content further, its formatting is important, just output it 1:1 !
dnw.writeln('${md_content}\n')
// Write examples if any found
examples := dn.examples()
if include_examples && examples.len > 0 {
example_title := if examples.len > 1 { 'Examples' } else { 'Example' }
dnw.writeln('
${example_title}
')
for example in examples {
hl_example := html_highlight(example, tb)
dnw.writeln('\n${hl_example}
')
}
dnw.writeln('')
}
dnw.writeln('')
dnw_str := dnw.str()
return dnw_str
}
fn prepare_markdown_for_html(text string) string {
if !text.contains('\n') {
return text
}
lines := text.split_into_lines()
mut prepared := []string{cap: lines.len}
mut is_codeblock := false
mut prev_line := ''
for i, line in lines {
trimmed := line.trim_space()
if trimmed.starts_with('```') {
prepared << line
is_codeblock = !is_codeblock
prev_line = line
continue
}
if is_codeblock {
prepared << line
prev_line = line
continue
}
if line_continues_previous_block(prev_line, line) && prepared.len > 0 {
prepared[prepared.len - 1] += ' ' + trimmed
prev_line = line
continue
}
next_line := if i + 1 < lines.len { lines[i + 1] } else { '' }
if blockquote_line_needs_hard_break(line, next_line) {
prepared << line + ' '
} else {
prepared << line
}
prev_line = line
}
return prepared.join('\n')
}
fn line_continues_previous_block(prev_line string, line string) bool {
prev_trimmed := prev_line.trim_space()
trimmed := line.trim_space()
if prev_trimmed == '' || trimmed == '' {
return false
}
if prev_trimmed.starts_with('>') || trimmed.starts_with('>') {
return false
}
if prev_trimmed.starts_with('```') || trimmed.starts_with('```') {
return false
}
if markdown_line_starts_new_block(line) {
return false
}
if prev_trimmed.starts_with('#') || prev_trimmed.starts_with('|')
|| markdown_line_is_horizontal_rule(prev_trimmed) {
return false
}
return true
}
fn markdown_line_starts_new_block(line string) bool {
trimmed := line.trim_space()
if trimmed == '' {
return false
}
if trimmed.starts_with('#') || trimmed.starts_with('>') || trimmed.starts_with('|')
|| trimmed.starts_with('```') || markdown_line_is_horizontal_rule(trimmed) {
return true
}
if markdown_indent_width(line) >= 4 {
return true
}
return markdown_line_is_list_item(trimmed)
}
fn markdown_line_is_list_item(line string) bool {
if line.len > 1 && line[1] == ` ` && line[0] in [`-`, `*`, `+`] {
return true
}
return line.len > 2 && line[2] == ` ` && line[1] == `.` && line[0].is_digit()
}
fn markdown_line_is_horizontal_rule(line string) bool {
line_no_spaces := line.replace(' ', '')
if line_no_spaces.len < 3 {
return false
}
for ch in ['-', '=', '*', '_', '~'] {
if line_no_spaces.starts_with(ch.repeat(3))
&& line_no_spaces.count(ch) == line_no_spaces.len {
return true
}
}
return false
}
fn markdown_indent_width(line string) int {
mut width := 0
for ch in line {
if ch == ` ` {
width++
continue
}
if ch == `\t` {
width += 4
continue
}
break
}
return width
}
fn blockquote_line_needs_hard_break(line string, next_line string) bool {
if line.ends_with(' ') {
return false
}
payload := blockquote_payload(line) or { return false }
if payload == '' {
return false
}
next_payload := blockquote_payload(next_line) or { return false }
if next_payload == '' {
return false
}
return !blockquote_payload_starts_new_block(next_payload)
}
fn blockquote_payload(line string) ?string {
trimmed := line.trim_space()
if !trimmed.starts_with('>') {
return none
}
return trimmed[1..].trim_space()
}
fn blockquote_payload_starts_new_block(payload string) bool {
if payload == '' || payload.starts_with('```') || payload.starts_with('>')
|| payload.starts_with('|') {
return true
}
if payload.len > 1 && payload[1] == ` ` && payload[0] in [`-`, `*`, `+`] {
return true
}
if payload.len > 2 && payload[2] == ` ` && payload[1] == `.` && payload[0].is_digit() {
return true
}
if !payload.starts_with('#') {
return false
}
line_before_spaces := payload.before(' ')
return line_before_spaces.count('#') == line_before_spaces.len
}
fn write_toc(dn doc.DocNode, mut toc strings.Builder) {
mut toc_slug := if dn.name == '' || dn.content.len == 0 { '' } else { slug(dn.name) }
if toc_slug == '' && dn.children.len > 0 {
if dn.children[0].name == '' {
toc_slug = slug(dn.name)
} else {
toc_slug = slug(dn.name + '.' + dn.children[0].name)
}
}
if is_module_readme(dn) {
if dn.comments.len == 0 || (dn.comments.len > 0 && dn.comments[0].text.len == 0) {
return
}
toc.write_string('
README')
} else if dn.name != 'Constants' {
toc.write_string('${dn.kind} ${dn.name}')
toc.writeln(' ')
} else {
toc.write_string('${dn.name}')
}
toc.writeln('')
}
struct MdHtmlCodeHighlighter {
mut:
language string
table &ast.Table
relative_link_base string
}
fn (f &MdHtmlCodeHighlighter) transform_attribute(p markdown.ParentType, name string, value string) string {
mut transformed := value
if p is markdown.MD_SPANTYPE && p in [.md_span_a, .md_span_img] && name in ['href', 'src'] {
transformed = resolve_relative_markdown_link(f.relative_link_base, value)
}
return markdown.default_html_transformer.transform_attribute(p, name, transformed)
}
fn (f &MdHtmlCodeHighlighter) transform_content(parent markdown.ParentType, text string) string {
if parent is markdown.MD_BLOCKTYPE && parent == .md_block_code {
if f.language == '' {
return html.escape(text)
}
output := html_highlight(text, f.table)
// Reset the language, so that it will not persist between blocks,
// and will not be accidentally re-used for the next block, that may be lacking ```language :
unsafe {
f.language = ''
}
return output
}
return text
}
fn (mut f MdHtmlCodeHighlighter) config_set(key string, val string) {
if key == 'code_language' {
f.language = val
}
}