class Jekyll::Converters::Markdown::KramdownParser

Constants

CODERAY_DEFAULTS

Public Class Methods

new(config) click to toggle source
# File lib/jekyll/converters/markdown/kramdown_parser.rb, line 16
def initialize(config)
  @main_fallback_highlighter = config["highlighter"] || "rouge"
  @config = config["kramdown"] || {}
  @highlighter = nil
  setup
end

Public Instance Methods

convert(content) click to toggle source
# File lib/jekyll/converters/markdown/kramdown_parser.rb, line 38
def convert(content)
  document = Kramdown::Document.new(content, @config)
  html_output = document.to_html
  if @config["show_warnings"]
    document.warnings.each do |warning|
      Jekyll.logger.warn "Kramdown warning:", warning
    end
  end
  html_output
end
setup() click to toggle source

Setup and normalize the configuration:

* Create Kramdown if it doesn't exist.
* Set syntax_highlighter, detecting enable_coderay and merging
    highlighter if none.
* Merge kramdown[coderay] into syntax_highlighter_opts stripping coderay_.
* Make sure `syntax_highlighter_opts` exists.
# File lib/jekyll/converters/markdown/kramdown_parser.rb, line 30
def setup
  @config["syntax_highlighter"] ||= highlighter
  @config["syntax_highlighter_opts"] ||= {}
  @config["coderay"] ||= {} # XXX: Legacy.
  modernize_coderay_config
  make_accessible
end

Private Instance Methods

highlighter() click to toggle source

config[syntax_higlighter] >

config[kramdown][enable_coderay] >
config[highlighter]

Where `enable_coderay` is now deprecated because Kramdown supports Rouge now too.

# File lib/jekyll/converters/markdown/kramdown_parser.rb, line 64
def highlighter
  return @highlighter if @highlighter

  if @config["syntax_highlighter"]
    return @highlighter = @config[
      "syntax_highlighter"
    ]
  end

  @highlighter = begin
    if @config.key?("enable_coderay") && @config["enable_coderay"]
      Jekyll::Deprecator.deprecation_message(
        "You are using 'enable_coderay', " \
        "use syntax_highlighter: coderay in your configuration file."
      )

      "coderay"
    else
      @main_fallback_highlighter
    end
  end
end
make_accessible(hash = @config) click to toggle source
# File lib/jekyll/converters/markdown/kramdown_parser.rb, line 50
def make_accessible(hash = @config)
  hash.keys.each do |key|
    hash[key.to_sym] = hash[key]
    make_accessible(hash[key]) if hash[key].is_a?(Hash)
  end
end
modernize_coderay_config() click to toggle source

If our highlighter is CodeRay we go in to merge the CodeRay defaults with your “coderay” key if it's there, deprecating it in the process of you using it.

# File lib/jekyll/converters/markdown/kramdown_parser.rb, line 107
def modernize_coderay_config
  unless @config["coderay"].empty?
    Jekyll::Deprecator.deprecation_message(
      "You are using 'kramdown.coderay' in your configuration, " \
      "please use 'syntax_highlighter_opts' instead."
    )

    @config["syntax_highlighter_opts"] = begin
      strip_coderay_prefix(
        @config["syntax_highlighter_opts"] \
          .merge(CODERAY_DEFAULTS) \
          .merge(@config["coderay"])
      )
    end
  end
end
strip_coderay_prefix(hash) click to toggle source
# File lib/jekyll/converters/markdown/kramdown_parser.rb, line 88
def strip_coderay_prefix(hash)
  hash.each_with_object({}) do |(key, val), hsh|
    cleaned_key = key.to_s.gsub(%r!\Acoderay_!, "")

    if key != cleaned_key
      Jekyll::Deprecator.deprecation_message(
        "You are using '#{key}'. Normalizing to #{cleaned_key}."
      )
    end

    hsh[cleaned_key] = val
  end
end