asciidoctor 1.5.8 → 2.0.17

data/lib/asciidoctor/syntax_highlighter/coderay.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+module Asciidoctor
+class SyntaxHighlighter::CodeRayAdapter < SyntaxHighlighter::Base
+  register_for 'coderay'
+
+  def initialize *args
+    super
+    @pre_class = 'CodeRay'
+    @requires_stylesheet = nil
+  end
+
+  def highlight?
+    library_available?
+  end
+
+  def highlight node, source, lang, opts
+    @requires_stylesheet = true if (css_mode = opts[:css_mode]) == :class
+    lang = lang ? (::CodeRay::Scanners[lang = lang.to_sym] && lang rescue :text) : :text
+    highlighted = ::CodeRay::Duo[lang, :html,
+      css: css_mode,
+      line_numbers: (line_numbers = opts[:number_lines]),
+      line_number_start: opts[:start_line_number],
+      line_number_anchors: false,
+      highlight_lines: opts[:highlight_lines],
+      bold_every: false,
+    ].highlight source
+    if line_numbers == :table && opts[:callouts]
+      [highlighted, (idx = highlighted.index CodeCellStartTagCs) ? idx + CodeCellStartTagCs.length : nil]
+    else
+      highlighted
+    end
+  end
+
+  def docinfo? location
+    @requires_stylesheet && location == :head
+  end
+
+  def docinfo location, doc, opts
+    if opts[:linkcss]
+      %(<link rel="stylesheet" href="#{doc.normalize_web_path stylesheet_basename, (doc.attr 'stylesdir', ''), false}"#{opts[:self_closing_tag_slash]}>)
+    else
+      %(<style>
+#{read_stylesheet}
+</style>)
+    end
+  end
+
+  def write_stylesheet? doc
+    @requires_stylesheet
+  end
+
+  def write_stylesheet doc, to_dir
+    ::File.write (::File.join to_dir, stylesheet_basename), read_stylesheet, mode: FILE_WRITE_MODE
+  end
+
+  module Loader
+    private
+
+    def library_available?
+      (@@library_status ||= load_library) == :loaded ? true : nil
+    end
+
+    def load_library
+      (defined? ::CodeRay::Duo) ? :loaded : (Helpers.require_library 'coderay', true, :warn).nil? ? :unavailable : :loaded
+    end
+  end
+
+  module Styles
+    include Loader
+
+    def read_stylesheet
+      @@stylesheet_cache ||= (::File.read (::File.join Stylesheets::STYLESHEETS_DIR, stylesheet_basename), mode: FILE_READ_MODE).rstrip
+    end
+
+    def stylesheet_basename
+      'coderay-asciidoctor.css'
+    end
+  end
+
+  extend Styles # exports static methods
+  include Styles # adds methods to instance
+  include Loader # adds methods to instance
+
+  CodeCellStartTagCs = '<td class="code"><pre>'
+
+  private_constant :CodeCellStartTagCs
+end
+end

data/lib/asciidoctor/syntax_highlighter/highlightjs.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+module Asciidoctor
+class SyntaxHighlighter::HighlightJsAdapter < SyntaxHighlighter::Base
+  register_for 'highlightjs', 'highlight.js'
+
+  def initialize *args
+    super
+    @name = @pre_class = 'highlightjs'
+  end
+
+  def format node, lang, opts
+    super node, lang, (opts.merge transform: proc {|_, code| code['class'] = %(language-#{lang || 'none'} hljs) })
+  end
+
+  def docinfo? location
+    true
+  end
+
+  def docinfo location, doc, opts
+    base_url = doc.attr 'highlightjsdir', %(#{opts[:cdn_base_url]}/highlight.js/#{HIGHLIGHT_JS_VERSION})
+    if location == :head
+      %(<link rel="stylesheet" href="#{base_url}/styles/#{doc.attr 'highlightjs-theme', 'github'}.min.css"#{opts[:self_closing_tag_slash]}>)
+    else # :footer
+      %(<script src="#{base_url}/highlight.min.js"></script>
+#{(doc.attr? 'highlightjs-languages') ? ((doc.attr 'highlightjs-languages').split ',').map {|lang| %[<script src="#{base_url}/languages/#{lang.lstrip}.min.js"></script>\n] }.join : ''}<script>
+if (!hljs.initHighlighting.called) {
+  hljs.initHighlighting.called = true
+  ;[].slice.call(document.querySelectorAll('pre.highlight > code')).forEach(function (el) { hljs.highlightBlock(el) })
+}
+</script>)
+    end
+  end
+end
+end

data/lib/asciidoctor/syntax_highlighter/html_pipeline.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+module Asciidoctor
+class SyntaxHighlighter::HtmlPipelineAdapter < SyntaxHighlighter::Base
+  register_for 'html-pipeline'
+
+  def format node, lang, opts
+    %(<pre#{lang ? %[ lang="#{lang}"] : ''}><code>#{node.content}</code></pre>)
+  end
+end
+end

data/lib/asciidoctor/syntax_highlighter/prettify.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+module Asciidoctor
+class SyntaxHighlighter::PrettifyAdapter < SyntaxHighlighter::Base
+  register_for 'prettify'
+
+  def initialize *args
+    super
+    @pre_class = 'prettyprint'
+  end
+
+  def format node, lang, opts
+    opts[:transform] = proc {|pre| pre['class'] += %( #{(start = node.attr 'start') ? %[linenums:#{start}] : 'linenums'}) } if node.attr? 'linenums'
+    super
+  end
+
+  def docinfo? location
+    true
+  end
+
+  def docinfo location, doc, opts
+    base_url = doc.attr 'prettifydir', %(#{opts[:cdn_base_url]}/prettify/r298)
+    if location == :head
+      prettify_theme_url = ((prettify_theme = doc.attr 'prettify-theme', 'prettify').start_with? 'http://', 'https://') ? prettify_theme : %(#{base_url}/#{prettify_theme}.min.css)
+      %(<link rel="stylesheet" href="#{prettify_theme_url}"#{opts[:self_closing_tag_slash]}>)
+    else # :footer
+      %(<script src="#{base_url}/run_prettify.min.js"></script>)
+    end
+  end
+end
+end

data/lib/asciidoctor/syntax_highlighter/pygments.rb

@@ -0,0 +1,157 @@
+# frozen_string_literal: true
+module Asciidoctor
+class SyntaxHighlighter::PygmentsAdapter < SyntaxHighlighter::Base
+  register_for 'pygments'
+
+  def initialize *args
+    super
+    @requires_stylesheet = @style = nil
+  end
+
+  def highlight?
+    library_available?
+  end
+
+  def highlight node, source, lang, opts
+    lexer = (::Pygments::Lexer.find_by_alias lang) || (::Pygments::Lexer.find_by_mimetype 'text/plain')
+    @requires_stylesheet = true unless (noclasses = opts[:css_mode] != :class)
+    highlight_opts = {
+      classprefix: TOKEN_CLASS_PREFIX,
+      cssclass: WRAPPER_CLASS,
+      nobackground: true,
+      noclasses: noclasses,
+      startinline: lexer.name == 'PHP' && !(node.option? 'mixed'),
+      stripnl: false,
+      style: (@style ||= (style = opts[:style]) && (style_available? style) || DEFAULT_STYLE),
+    }
+    if (highlight_lines = opts[:highlight_lines])
+      highlight_opts[:hl_lines] = highlight_lines.join ' '
+    end
+    if (linenos = opts[:number_lines]) && (highlight_opts[:linenostart] = opts[:start_line_number]) && (highlight_opts[:linenos] = linenos) == :table
+      if (highlighted = lexer.highlight source, options: highlight_opts)
+        highlighted = highlighted.sub StyledLinenoColumnStartTagsRx, LinenoColumnStartTagsCs if noclasses
+        highlighted = highlighted.sub WrapperTagRx, PreTagCs
+        opts[:callouts] ? [highlighted, (idx = highlighted.index CodeCellStartTagCs) ? idx + CodeCellStartTagCs.length : nil] : highlighted
+      else
+        node.sub_source source, false # handles nil response from ::Pygments::Lexer#highlight
+      end
+    elsif (highlighted = lexer.highlight source, options: highlight_opts)
+      if linenos
+        if noclasses
+          highlighted = highlighted.gsub StyledLinenoSpanTagRx, LinenoSpanTagCs
+        elsif highlighted.include? LegacyLinenoSpanStartTagCs
+          highlighted = highlighted.gsub LegacyLinenoSpanTagRx, LinenoSpanTagCs
+        end
+      end
+      highlighted.sub WrapperTagRx, '\1'
+    else
+      node.sub_source source, false # handles nil response from ::Pygments::Lexer#highlight
+    end
+  end
+
+  def format node, lang, opts
+    if opts[:css_mode] != :class && (@style = (style = opts[:style]) && (style_available? style) || DEFAULT_STYLE) &&
+        (pre_style_attr_val = base_style @style)
+      opts[:transform] = proc {|pre| pre['style'] = pre_style_attr_val }
+    end
+    super
+  end
+
+  def docinfo? location
+    @requires_stylesheet && location == :head
+  end
+
+  def docinfo location, doc, opts
+    if opts[:linkcss]
+      %(<link rel="stylesheet" href="#{doc.normalize_web_path (stylesheet_basename @style), (doc.attr 'stylesdir', ''), false}"#{opts[:self_closing_tag_slash]}>)
+    else
+      %(<style>
+#{read_stylesheet @style}
+</style>)
+    end
+  end
+
+  def write_stylesheet? doc
+    @requires_stylesheet
+  end
+
+  def write_stylesheet doc, to_dir
+    ::File.write (::File.join to_dir, (stylesheet_basename @style)), (read_stylesheet @style), mode: FILE_WRITE_MODE
+  end
+
+  module Loader
+    private
+
+    def library_available?
+      (@@library_status ||= load_library) == :loaded ? true : nil
+    end
+
+    def load_library
+      (defined? ::Pygments::Lexer) ? :loaded : (Helpers.require_library 'pygments', 'pygments.rb', :warn).nil? ? :unavailable : :loaded
+    end
+  end
+
+  module Styles
+    include Loader
+
+    def read_stylesheet style
+      library_available? ? @@stylesheet_cache[style || DEFAULT_STYLE] || '/* Failed to load Pygments CSS. */' : '/* Pygments CSS disabled because Pygments is not available. */'
+    end
+
+    def stylesheet_basename style
+      %(pygments-#{style || DEFAULT_STYLE}.css)
+    end
+
+    private
+
+    def base_style style
+      library_available? ? @@base_style_cache[style || DEFAULT_STYLE] : nil
+    end
+
+    def style_available? style
+      (((@@available_styles ||= ::Pygments.styles.to_set).include? style) rescue nil) && style
+    end
+
+    @@base_style_cache = ::Hash.new do |cache, key|
+      if BaseStyleRx =~ @@stylesheet_cache[key]
+        @@base_style_cache = cache.merge key => (style = $1.strip)
+        style
+      end
+    end
+    @@stylesheet_cache = ::Hash.new do |cache, key|
+      if (stylesheet = ::Pygments.css BASE_SELECTOR, classprefix: TOKEN_CLASS_PREFIX, style: key)
+        stylesheet = stylesheet.slice (stylesheet.index BASE_SELECTOR), stylesheet.length unless stylesheet.start_with? BASE_SELECTOR
+        @@stylesheet_cache = cache.merge key => stylesheet
+        stylesheet
+      end
+    end
+
+    DEFAULT_STYLE = 'default'
+    BASE_SELECTOR = 'pre.pygments'
+    TOKEN_CLASS_PREFIX = 'tok-'
+    BaseStyleRx = /^#{BASE_SELECTOR.gsub '.', '\\.'} +\{([^}]+?)\}/
+
+    private_constant :BASE_SELECTOR, :TOKEN_CLASS_PREFIX, :BaseStyleRx
+  end
+
+  extend Styles # exports static methods
+  include Styles # adds methods to instance
+  include Loader # adds methods to instance
+
+  CodeCellStartTagCs = '<td class="code">'
+  LegacyLinenoSpanStartTagCs = '<span class="lineno">'
+  LegacyLinenoSpanTagRx = %r(#{LegacyLinenoSpanStartTagCs}( *\d+) ?</span>)
+  LinenoColumnStartTagsCs = '<td class="linenos"><div class="linenodiv"><pre>'
+  LinenoSpanTagCs = '<span class="linenos">\1</span>'
+  PreTagCs = '<pre>\1</pre>'
+  StyledLinenoColumnStartTagsRx = /<td><div class="linenodiv" style="[^"]+?"><pre style="[^"]+?">/
+  StyledLinenoSpanTagRx = %r((?<=^|<span></span>)<span style="[^"]+">( *\d+) ?</span>)
+  WRAPPER_CLASS = 'lineno' # doesn't appear in output; Pygments appends "table" to this value to make nested table class
+  # NOTE <pre> has style attribute when pygments-css=style
+  # NOTE <div> has trailing newline when pygments-linenums-mode=table
+  # NOTE initial <span></span> preserves leading blank lines
+  WrapperTagRx = %r(<div class="#{WRAPPER_CLASS}"><pre\b[^>]*?>(.*)</pre></div>\n*)m
+
+  private_constant :CodeCellStartTagCs, :LegacyLinenoSpanStartTagCs, :LegacyLinenoSpanTagRx, :LinenoColumnStartTagsCs, :LinenoSpanTagCs, :PreTagCs, :StyledLinenoColumnStartTagsRx, :StyledLinenoSpanTagRx, :WrapperTagRx, :WRAPPER_CLASS
+end
+end

data/lib/asciidoctor/syntax_highlighter/rouge.rb

@@ -0,0 +1,143 @@
+# frozen_string_literal: true
+module Asciidoctor
+class SyntaxHighlighter::RougeAdapter < SyntaxHighlighter::Base
+  register_for 'rouge'
+
+  def initialize *args
+    super
+    @requires_stylesheet = @style = nil
+  end
+
+  def highlight?
+    library_available?
+  end
+
+  def highlight node, source, lang, opts
+    @style ||= (style = opts[:style]) && (style_available? style) || DEFAULT_STYLE
+    @requires_stylesheet = true if opts[:css_mode] == :class
+    lexer = create_lexer node, source, lang, opts
+    formatter = create_formatter node, source, lang, opts
+    highlighted = formatter.format lexer.lex source
+    if opts[:number_lines] && opts[:callouts]
+      [highlighted, (idx = highlighted.index CodeCellStartTagCs) ? idx + CodeCellStartTagCs.length : nil]
+    else
+      highlighted
+    end
+  end
+
+  def format node, lang, opts
+    if (query_idx = lang && (lang.index '?'))
+      lang = lang.slice 0, query_idx
+    end
+    if opts[:css_mode] != :class && (@style = (style = opts[:style]) && (style_available? style) || DEFAULT_STYLE) && (pre_style_attr_val = base_style @style)
+      opts[:transform] = proc {|pre| pre['style'] = pre_style_attr_val }
+    end
+    super
+  end
+
+  def docinfo? location
+    @requires_stylesheet && location == :head
+  end
+
+  def docinfo location, doc, opts
+    if opts[:linkcss]
+      %(<link rel="stylesheet" href="#{doc.normalize_web_path (stylesheet_basename @style), (doc.attr 'stylesdir', ''), false}"#{opts[:self_closing_tag_slash]}>)
+    else
+      %(<style>
+#{read_stylesheet @style}
+</style>)
+    end
+  end
+
+  def write_stylesheet? doc
+    @requires_stylesheet
+  end
+
+  def write_stylesheet doc, to_dir
+    ::File.write (::File.join to_dir, (stylesheet_basename @style)), (read_stylesheet @style), mode: FILE_WRITE_MODE
+  end
+
+  def create_lexer node, source, lang, opts
+    if lang.include? '?'
+      # NOTE cgi-style options only properly supported in Rouge >= 2.1
+      if (lexer = ::Rouge::Lexer.find_fancy lang)
+        unless lexer.tag != 'php' || (node.option? 'mixed') || ((lexer_opts = lexer.options).key? 'start_inline')
+          lexer = lexer.class.new lexer_opts.merge 'start_inline' => true
+        end
+      end
+    elsif (lexer = ::Rouge::Lexer.find lang)
+      lexer = lexer.tag == 'php' && !(node.option? 'mixed') ? (lexer.new start_inline: true) : lexer.new
+    end if lang
+    lexer || ::Rouge::Lexers::PlainText.new
+  end
+
+  def create_formatter node, source, lang, opts
+    formatter = opts[:css_mode] == :class ?
+      (::Rouge::Formatters::HTML.new inline_theme: @style) :
+      (::Rouge::Formatters::HTMLInline.new (::Rouge::Theme.find @style).new)
+    if (highlight_lines = opts[:highlight_lines])
+      formatter = RougeExt::Formatters::HTMLLineHighlighter.new formatter, lines: highlight_lines
+    end
+    opts[:number_lines] ? (RougeExt::Formatters::HTMLTable.new formatter, start_line: opts[:start_line_number]) : formatter
+  end
+
+  module Loader
+    private
+
+    def library_available?
+      (@@library_status ||= load_library) == :loaded ? true : nil
+    end
+
+    def load_library
+      (defined? RougeExt) ? :loaded : (Helpers.require_library %(#{::File.dirname __dir__}/rouge_ext), 'rouge', :warn).nil? ? :unavailable : :loaded
+    end
+  end
+
+  module Styles
+    include Loader
+
+    def read_stylesheet style
+      library_available? ? @@stylesheet_cache[style || DEFAULT_STYLE] : '/* Rouge CSS disabled because Rouge is not available. */'
+    end
+
+    def stylesheet_basename style
+      %(rouge-#{style || DEFAULT_STYLE}.css)
+    end
+
+    private
+
+    def base_style style
+      library_available? ? @@base_style_cache[style || DEFAULT_STYLE] : nil
+    end
+
+    def style_available? style
+      (::Rouge::Theme.find style) && style
+    end
+
+    @@base_style_cache = ::Hash.new do |cache, key|
+      base_style = (theme = ::Rouge::Theme.find key).base_style
+      (val = base_style[:fg]) && ((style ||= []) << %(color: #{theme.palette val}))
+      (val = base_style[:bg]) && ((style ||= []) << %(background-color: #{theme.palette val}))
+      @@base_style_cache = cache.merge key => (resolved_base_style = style && (style.join ';'))
+      resolved_base_style
+    end
+    @@stylesheet_cache = ::Hash.new do |cache, key|
+      @@stylesheet_cache = cache.merge key => (stylesheet = ((::Rouge::Theme.find key).render scope: BASE_SELECTOR))
+      stylesheet
+    end
+
+    DEFAULT_STYLE = 'github'
+    BASE_SELECTOR = 'pre.rouge'
+
+    private_constant :BASE_SELECTOR
+  end
+
+  extend Styles # exports static methods
+  include Styles # adds methods to instance
+  include Loader # adds methods to instance
+
+  CodeCellStartTagCs = '<td class="code">'
+
+  private_constant :CodeCellStartTagCs
+end
+end