Class: Utopia::Project::Renderer

Inherits:
Markly::Renderer::HTML
  • Object
show all
Defined in:
lib/utopia/project/renderer.rb

Overview

Renders project Markdown with support for Mermaid code blocks.

Instance Method Summary collapse

Constructor Details

#initialize(inline_code_resolver: nil, **options) ⇒ Renderer

Initialize the project renderer.



15
16
17
18
19
 
# File 'lib/utopia/project/renderer.rb', line 15

def initialize(inline_code_resolver: nil, **options)
  @inline_code_resolver = inline_code_resolver
  
  super(**options)
end

Instance Method Details

#code(node) ⇒ Object

Render inline code, resolving language-prefixed references when possible.



59
60
61
62
63
64
65
 
# File 'lib/utopia/project/renderer.rb', line 59

def code(node)
  if @inline_code_resolver && (language = node.code_language)
    out(@inline_code_resolver.call(node.string_content, language: language))
  else
    super
  end
end

#code_block(node) ⇒ Object

Render a fenced code block, including Mermaid diagrams.



41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
 
# File 'lib/utopia/project/renderer.rb', line 41

def code_block(node)
  language, _ = node.fence_info.split(/\s+/, 2)
  
  if language == "mermaid"
    block do
      out(
        "<div#{source_position(node)} class=\"mermaid\">",
        escape_html(node.string_content),
        "</div>"
      )
    end
  else
    super
  end
end

#header(node) ⇒ Object

Render a heading and expose its title to Pagefind for sub-results.



23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
 
# File 'lib/utopia/project/renderer.rb', line 23

def header(node)
  block do
    if @headings
      out("</section>") if @section
      @section = true
      out(
        "<section#{id_for(node)} data-pagefind-title=\"",
        escape_html(node.to_plaintext.chomp),
        "\">"
      )
    end
    
    out("<h", node.header_level, "#{source_position(node)}>", :children, "</h", node.header_level, ">")
  end
end