module Jekyll module Tags class HighlightBlock < Liquid::Block include Liquid::StandardFilters # The regular expression syntax checker. Start with the language specifier. # Follow that by zero or more space separated options that take one of three # forms: name, name=value, or name="" # # is a space-separated list of numbers SYNTAX = /^([a-zA-Z0-9.+#-]+)((\s+\w+(=(\w+|"([0-9]+\s)*[0-9]+"))?)*)$/ def initialize(tag_name, markup, tokens) super if markup.strip =~ SYNTAX @lang = $1.downcase @options = {} if defined?($2) && $2 != '' # Split along 3 possible forms -- key="", key=value, or key $2.scan(/(?:\w="[^"]*"|\w=\w|\w)+/) do |opt| key, value = opt.split('=') # If a quoted list, convert to array if value && value.include?("\"") value.gsub!(/"/, "") value = value.split end @options[key.to_sym] = value || true end end @options[:linenos] = "inline" if @options.key?(:linenos) and @options[:linenos] == true else raise SyntaxError.new <<-eos Syntax Error in tag 'highlight' while parsing the following markup: #{markup} Valid syntax: highlight [linenos] eos end end def render(context) prefix = context["highlighter_prefix"] || "" suffix = context["highlighter_suffix"] || "" code = super.to_s.strip is_safe = !!context.registers[:site].safe output = case context.registers[:site].highlighter when 'pygments' render_pygments(code, is_safe) when 'rouge' render_rouge(code) else render_codehighlighter(code) end rendered_output = add_code_tag(output) prefix + rendered_output + suffix end def sanitized_opts(opts, is_safe) if is_safe Hash[[ [:startinline, opts.fetch(:startinline, nil)], [:hl_linenos, opts.fetch(:hl_linenos, nil)], [:linenos, opts.fetch(:linenos, nil)], [:encoding, opts.fetch(:encoding, 'utf-8')], [:cssclass, opts.fetch(:cssclass, nil)] ].reject {|f| f.last.nil? }] else opts end end def render_pygments(code, is_safe) require 'pygments' @options[:encoding] = 'utf-8' highlighted_code = Pygments.highlight( code, :lexer => @lang, :options => sanitized_opts(@options, is_safe) ) if highlighted_code.nil? Jekyll.logger.error "There was an error highlighting your code:" puts Jekyll.logger.error code puts Jekyll.logger.error "While attempting to convert the above code, Pygments.rb" + " returned an unacceptable value." Jekyll.logger.error "This is usually a timeout problem solved by running `jekyll build` again." raise ArgumentError.new("Pygments.rb returned an unacceptable value when attempting to highlight some code.") end highlighted_code end def render_rouge(code) require 'rouge' formatter = Rouge::Formatters::HTML.new(line_numbers: @options[:linenos], wrap: false) lexer = Rouge::Lexer.find_fancy(@lang, code) || Rouge::Lexers::PlainText code = formatter.format(lexer.lex(code)) "
#{code}
" end def render_codehighlighter(code) "
#{h(code).strip}
" end def add_code_tag(code) # Add nested tags to code blocks code = code.sub(/
\n*/,'
')
        code = code.sub(/\n*<\/pre>/,"
") code.strip end end end end Liquid::Template.register_tag('highlight', Jekyll::Tags::HighlightBlock)