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 84 def initialize(config) @main_fallback_highlighter = config["highlighter"] || "rouge" @config = config["kramdown"] || {} @highlighter = nil setup load_dependencies end
Public Instance Methods
convert(content)
click to toggle source
# File lib/jekyll/converters/markdown/kramdown_parser.rb, line 108 def convert(content) document = Kramdown::JekyllDocument.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 99 def setup @config["syntax_highlighter"] ||= highlighter @config["syntax_highlighter_opts"] ||= {} @config["syntax_highlighter_opts"]["default_lang"] ||= "plaintext" @config["syntax_highlighter_opts"]["guess_lang"] = @config["guess_lang"] @config["coderay"] ||= {} # XXX: Legacy. modernize_coderay_config end
Private Instance Methods
highlighter()
click to toggle source
config[syntax_highlighter] >
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 140 def highlighter return @highlighter if @highlighter if @config["syntax_highlighter"] return @highlighter = @config[ "syntax_highlighter" ] end @highlighter = 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
load_dependencies()
click to toggle source
# File lib/jekyll/converters/markdown/kramdown_parser.rb, line 121 def load_dependencies require "kramdown-parser-gfm" if @config["input"] == "GFM" if highlighter == "coderay" Jekyll::External.require_with_graceful_fail("kramdown-syntax-coderay") end # `mathjax` engine is bundled within kramdown-2.x and will be handled by # kramdown itself. if (math_engine = @config["math_engine"]) && math_engine != "mathjax" Jekyll::External.require_with_graceful_fail("kramdown-math-#{math_engine}") 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 178 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 161 def strip_coderay_prefix(hash) hash.each_with_object({}) do |(key, val), hsh| cleaned_key = key.to_s.delete_prefix("coderay_") if key != cleaned_key Jekyll::Deprecator.deprecation_message( "You are using '#{key}'. Normalizing to #{cleaned_key}." ) end hsh[cleaned_key] = val end end