Class: HTML::Pipeline::SyntaxHighlightFilter

Inherits:
Filter
  • Object
show all
Defined in:
lib/html/pipeline/syntax_highlight_filter.rb

Overview

HTML Filter that syntax highlights code blocks wrapped in <pre lang=“…”>.

Instance Attribute Summary

Attributes inherited from Filter

#context, #result

Instance Method Summary collapse

Methods inherited from Filter

#base_url, call, #current_user, #doc, #has_ancestor?, #html, #needs, #parse_html, #repository, to_document, to_html, #validate

Constructor Details

#initialize(*args) ⇒ SyntaxHighlightFilter

Returns a new instance of SyntaxHighlightFilter.



8
9
10
11
 
# File 'lib/html/pipeline/syntax_highlight_filter.rb', line 8

def initialize(*args)
  super(*args)
  @formatter = Rouge::Formatters::HTML.new
end

Instance Method Details

#call ⇒ Object 



13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
 
# File 'lib/html/pipeline/syntax_highlight_filter.rb', line 13

def call
  doc.search('pre').each do |node|
    default = context[:highlight] && context[:highlight].to_s
    next unless lang = node['lang'] || default
    next unless lexer = lexer_for(lang)
    text = node.inner_text

    html = highlight_with_timeout_handling(text, lang)
    next if html.nil?

    node.inner_html = html
    klass = node['class']
    scope = context[:scope] || "highlight-#{lang}"
    klass = [klass, scope].compact.join ' '

    node['class'] = klass
  end
  doc
end

#highlight_with_timeout_handling(text, lang) ⇒ Object 



33
34
35
36
37
 
# File 'lib/html/pipeline/syntax_highlight_filter.rb', line 33

def highlight_with_timeout_handling(text, lang)
  Rouge.highlight(text, lang, @formatter)
rescue Timeout::Error => _
  nil
end

#lexer_for(lang) ⇒ Object 



39
40
41
 
# File 'lib/html/pipeline/syntax_highlight_filter.rb', line 39

def lexer_for(lang)
  Rouge::Lexer.find(lang)
end